bigip_fast_application – Manages FAST application declarations sent to BIG-IP

New in version 1.0.0.

Synopsis

  • Manages FAST application declarations sent to the BIG-IP.

Parameters

Parameter Choices/Defaults Configuration Comments
application
string
A FAST application name you want to update or remove.
This parameter is required when tenant is specified.
content
raw
Declaration to be configured on the system.
This parameter is most often used along with the file or template lookup plugins. Refer to the examples section for correct usage.
For anything advanced or with formatting, consider using the template lookup.
Additionally, this can be used for specifying application service configurations directly in YAML, however that is not an encouraged practice and, if used at all, should only be used for the absolute smallest of configurations to prevent your Playbooks from becoming too large.
If your content includes encrypted values (such as ciphertexts, passphrases, etc), the returned changed value is always true.
If you are using the to_nice_json filter, it causes this module to fail because the purpose of that filter is to format the JSON to be human-readable and this process includes inserting extra characters that break JSON validators.
This parameter is required when state is create or present.
state
string
    Choices:
  • create ←
  • present
  • absent
  • purge
When state is create, the declaration is used to create a new FAST application.
When state is present, the existing FAST application is updated.
When state is absent, ensures the existing FAST application is removed.
When state is purge, ensures all FAST applications are removed from device.
template
string
Name of installed FAST template used to create the FAST application.
This parameter is only used when creating a new application, when state is create.
tenant
string
A FAST tenant name on which you want to manage the application.
This parameter is required when state is present or absent.
timeout
integer
Default:
300
The amount of time to wait for the FAST async interface to complete its task, in seconds.
The accepted value range is between 10 and 1800 seconds.

Examples

- hosts: all
  collections:
    - f5networks.f5_bigip
  connection: httpapi

  vars:
    ansible_host: "lb.mydomain.com"
    ansible_user: "admin"
    ansible_httpapi_password: "secret"
    ansible_network_os: f5networks.f5_bigip.bigip
    ansible_httpapi_use_ssl: yes

  tasks:
    - name: Create FAST application
      bigip_fast_application:
        template: "examples/simple_http"
        content: "{{ lookup('file', 'simple_http.json') }}"
        state: "create"

    - name: Update existing FAST application
      bigip_fast_application:
        tenant: "sample_tenant"
        application: "sample_app"
        content: "{{ lookup('file', 'simple_http_update.json') }}"
        state: "present"

    - name: Remove existing FAST application
      bigip_fast_application:
        tenant: "sample_tenant"
        application: "sample_app"
        state: "absent"

    - name: Remove all existing FAST applications on device
      bigip_fast_application:
        state: "purge"

Return Values

The following are the fields unique to this module:

Key Returned Description
application
string
changed
A FAST application name you want to update or remove.

Sample:
simple_http
content
dictionary
changed
The declaration sent to the system.

Sample:
hash/dictionary of values
template
string
changed
Name of the installed FAST template used to create the FAST application.

Sample:
examples/simple_http
tenant
string
changed
A FAST tenant name on which you want to manage application.

Sample:
example_tenant


Status

Authors

  • Wojciech Wypior (@wojtek0806)