This repo contains OpenStack Heat templates that can be used to deploy and/or configure F5® BIG-IP® in an OpenStack cloud.
Supported and Unsupported Templates
The two top-level directories in this repo which contain Heat templates are
f5_supported directory contains templates that are officially supported by F5 Networks® for customers with a support contract. Users who require support should contact F5® Support via their usual means.
unsupported directory contains templates that are experimental and should be used AT YOUR OWN RISK. These templates may have been contributed by other users or are under development by F5®. Regardless of a customer's status of a valid support contract, F5® will not support templates that are in this directory.
Documentation for this project is on Read The Docs.
Releases and Versions
This branch supports the OpenStack Kilo release.
For more information regarding releases and versioning, please see the Release, Versioning, and Support Matrix.
Installation & Configuration
Any of the templates in this repo can be downloaded, copied, and/or modified as needed to deploy resources in OpenStack. Please see the documentation for installation, configuration, and usage instructions.
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.
For more information see the Issues section of Contributing.
To run the functional tests here, please follow the guidelines below. pytest <http://pytest.org> is used for all functional testing in this repo.
Each Heat template makes different assumptions about what is available in the Openstack environment and what the template itself needs to create/manage. We have erred on the side of flexibility and customization because we realize your stack may be unique to you. The functionally tested templates may draw upon resources that already exist in Openstack and may manage its own resources when it makes sense. To understand what is needed to test a certain template, one has to merely look at the 'paramaters' input. This gives a clean indication of what is assumed to exist before launching the stack.
Install the required functional testing packages.
$ pip install -r requirements.func.test.txt
The pytest config options give below may not all be needed for a specific test. For example, if the test is not booting an F5® BIG-IP® via Heat then the '--license' option may not be required.
$ py.test <test_suite_file> --auth-netloc=<ip_address_of_keystone_host> --os-username=<openstack_username> \ --os-password=<openstack_password> --os-tenant-id=<id_of_tenant> --os-tenant-name=<openstack_tenant_name> \ --bigip-root-password=<password_for_root_username> --bigip-admin-password=<password_for_admin_username> \ --license=<license_key_for_ve_image>
Copyright 2013-2017 F5 Networks Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Contributor License Agreement
Individuals or business entities who contribute to this project must have completed and submitted the F5® Contributor License Agreement to Openstack_CLA@f5.com prior to their code submission being included in this project.