f5devcentral.f5ansible

Using this role, you can access the latest version and specific versions of F5 Networks Ansible Modules.

With the official release of collections in Ansible 2.9, this role will be deprecated and will not receive further updates. The last released version of the role will be v2019.9.27.

Requirements

• Python version 2.7 or higher

Due to the removal of some outdated parameters, the Ansible requirement has been updated to version 2.9 or higher starting from versions later than v2019.8.2. You can find the requirements listed in the metadata file.

Installation

This role is available in two versions:

• Daily
• Bi-weekly

Choose the version based on how much you can handle unstable code. F5 does not guarantee that the bi-weekly version is more stable; it just fits some users' preference for updates.

For example, daily updates might be too much for people managing the playbooks and could cause issues when it's inconvenient. In such cases, bi-weekly updates are more sensible.

On the other hand, some users like to be up-to-date with technology and find daily builds acceptable.

To install the bi-weekly version of the F5 Networks Ansible Role, run the following command on the machine where you will use Ansible:

ansible-galaxy install -f f5devcentral.f5ansible

To install the daily version of the F5 Networks Ansible Role, run this command instead:

ansible-galaxy install -f f5devcentral.f5ansible,master

For further details, please visit Ansible Galaxy Documentation.

Role Variables

Below are the available variables with their default values (see defaults/main.yml):

f5ansible_debug: no

This enables debugging functionality, helpful when working with F5 Networks Ansible developers to resolve issues.

Example Playbooks

Here’s a generic example that applies to any module.

---

- hosts: localhost
  connection: local

  roles:
    - role: f5devcentral.f5ansible

  tasks:
    - name: Some task
      bigip_<module_name>:
        provider:
          server: 1.1.1.1
          user: admin
          password: secret
      ......

This example shows how to use the bigip_virtual_server module included in this role.

---

- hosts: localhost
  connection: local

  roles:
    - role: f5devcentral.f5ansible

  tasks:
    - name: Create virtual server
      bigip_virtual_server:
        name: virt1
        destination: 2.1.3.4
        port: 9000
        description: My description
        snat: Automap
        pool: pool1
        provider:
          user: admin
          server: 1.1.1.1
          password: secret
          validate_certs: no
  register: result

You can find more examples in the EXAMPLES section within each module.

License

Apache 2.0

Releases

This role is updated in Ansible Galaxy every two weeks. To install a temporary version of this role, use the command:

ansible-galaxy install f5devcentral.f5ansible,master

Make sure to include the "comma" and "master" at the end of the command.

Author Information

F5 Networks
F5 Networks