f5-openstack-heat-plugins 1.0.1a1

Introduction

This repository houses all of F5’s OpenStack Heat resource plugins. F5’s Heat plugins can be used to orchestrate BIG-IP services in your OpenStack environment.

Releases and Versions

This branch supports the OpenStack Kilo release.

For more information about F5 Networks’s OpenStack versioning and a support matrix please see F5 Networks OpenStack Releases and Support Matrix

Installation

The heat plugins must be installed on the machine that the Heat engine is running on in order to use templates that refer the the F5 plugins. After installing the plugins the Heat engine must be restarted for them to take effect.

Note: If you are installing a pre-release version of the package with pip you will need to use the –pre option.

$ pip install f5-openstack-heat-plugins
$ service heat-engine restart

$ pip install f5-openstack-heat-plugins
$ systemctl restart openstack-heat-engine.service

Usage

Once the plugins are installed the F5 objects can be used when creating Heat templates. An example use of one of the objects is below.

resources:
  # The first two resources defined here are requirements for deploying
  # any object on the BigIP VE. The F5::BigIP::Device allows access and
  # authentication to the BigIP on which an object will be configured.
  # The F5::Sys::Partition resource places a particular object in the
  # partition given. These two requirements will be linked with the obects
  # we intend to configure (iAppTemplate, iAppService) by calling the
  # 'get_resource' intrinsic function.
  bigip:
    type: F5::BigIP::Device
    properties:
      ip: 10.0.0.1 # All properties can be passed in as parameters
      username: admin
      password: admin # The password can be passed in as a hidden field
  partition:
    type: F5::Sys::Partition
    properties:
      name: Common # Put these objects in the existing Common partition
      bigip_server: { get_resource: bigip } # Create dependency on bigip
  iapp_template:
    type: F5::Sys::iAppTemplate
    properties:
      name: test_template
      bigip_server: { get_resource: bigip } # Depends on bigip resource
      partition: { get_resource: partition} # Depends on partition as well
      full_template:
        get_file: iapps/full_template.tmpl
  iapp_service:
    type: F5::Sys::iAppService
    properties:
      name: test_service
      bigip_server: { get_resource: bigip }
      partition: { get_resource: partition }
      template_name: test_template # Matches name in template resource

Documentation

Project documentation can be found on Read The Docs.

Filing Issues

If you find an issue we would love to hear about it. Please let us know by filing an issue in this repository and tell us as much as you can about what you found and how you found it.

Contributing

See Contributing

Build

To make a PyPI package…

python setup.py sdist

Test

Before you open a pull request, your code must have passing pytest unit tests. In addition, you should include a set of functional tests written to use a real BIG-IP device for testing. Information on how to run our set of tests is included below.

flake8 ./

Contact

f5_openstack_heat@f5.com

Copyright

Copyright 2015-2016 F5 Networks Inc.

Support

See Support

License