velos_tenant – Manage VELOS tenants

New in version 1.1.0.

Synopsis

  • Manage VELOS tenants.

Parameters

Parameter Choices/Defaults Configuration Comments
cpu_cores
integer
    Choices:
  • 1
  • 2
  • 4
  • 6
  • 8
  • 10
  • 12
  • 14
  • 16
  • 18
  • 20
  • 22
  • 24
  • 26
  • 28
How many CPUs should be added to VM.
Required for create operations.
cryptos
string
    Choices:
  • enabled
  • disabled
Should Crypto be enabled for the tenant.
image_name
string
Name of the image to be used as present on controller.
Required for create operations.
memory
integer
How much memory should be provided to the VM, in KB.
Required for create operations.
mgmt_gateway
string
Tenant management gateway.
mgmt_ip
string
IP address which will be used to connect to the deployed tenant.
Required for create operations.
mgmt_prefix
integer
Tenant management CIDR prefix.
name
string / required
Name of the tenant
nodes
list / elements=integer
List of integers, specify which blades the VM may be on.
Required for create operations.
running_state
string
    Choices:
  • configured
  • provisioned
  • deployed
Desired running_state of the tenant.
state
string
    Choices:
  • present ←
  • absent
The tenant state. If absent, delete the tenant if it exists.
If present the tenant is created and enabled.
vlans
list / elements=integer
The existing VLAN IDs in the partition that should be added to the VM.
The order of these VLANs is ignored. This module orders the VLANs automatically. Therefore, if you deliberately re-order them in subsequent tasks, this module will not register a change.
Required for create operations.

Notes

Note

  • The module will create configurations of the tenants, it does not assume actual state of the running tenant.
  • As deployment of tenants is a lengthy process, the module velos_tenant_wait should be used in concert with this module to achieve desired results.

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 tenant 'foo'
      velos_tenant:
        name: foo
        image_name: BIGIP-bigip14.1.x-miro-14.1.2.3-0.0.182.ALL-VELOS.qcow2.zip
        nodes:
          - 1
        mgmt_ip: 10.144.3.17
        mgmt_prefix: 19
        mgmt_gateway: 10.146.127.254
        vlans: [245]
        cpu_cores: 2
        memory: 4096
        cryptos: disabled
        running_state: configured

    - name: Deploy tenant 'foo'
      velos_tenant:
        name: foo
        running_state: deployed

    - name: Delete tenant 'foo'
      velos_tenant:
        name: foo
        state: absent

Return Values

The following are the fields unique to this module:

Key Returned Description
cpu_cores
integer
changed
The number of CPUs added to VM.

Sample:
4
cryptos
string
changed
Specify if crypto is enabled for the tenant.

Sample:
enabled
image_name
string
changed
Name of the tenant image.

Sample:
BIGIP-bigip.TMOS-VEL.qcow2.zip
memory
integer
changed
The amount of memory in KB provided to the VM.

Sample:
4096
mgmt_gateway
string
changed
Tenant management gateway.

Sample:
192.168.1.254
mgmt_ip
string
changed
IP address used to connect to the deployed tenant.

Sample:
192.168.1.1
mgmt_prefix
integer
changed
Tenant management CIDR prefix.

Sample:
24
nodes
list
changed
Specify on which blades the VM is configured.

Sample:
[1]
running_state
string
changed
The running_state of tenant.

Sample:
provisioned
vlans
list
changed
Existing VLAN IDs in the partition to be added to the VM.

Sample:
[444, 333]


Status

Authors

  • Wojciech Wypior (@wojtek0806)