Last updated on: 2024-01-16 03:25:50.

f5os_tenant_wait – Wait for a F5OS tenant condition before continuing

New in version 1.0.0.

Synopsis

  • Wait for a F5OS tenant to be configured, provisioned, or deployed.

Parameters

Parameter Choices/Defaults Configuration Comments
delay
integer
Default:
0
Number of seconds to wait before starting to poll.
msg
string
This overrides the normal error message from a failure to meet the required conditions.
name
string / required
Name of the tenant.
sleep
integer
Default:
1
Number of seconds to sleep between checks.
state
string
    Choices:
  • configured ←
  • provisioned
  • deployed
  • ssh-ready
The condition for which the system is waiting.
Defaults to configured, which verifies the specified tenant has been created on the partition and is in the configured run-state.
provisioned waits for the tenant running-state and status "provisioned".
deployed waits for the tenant running-state "deployed", status "running", and phase "running".
ssh-ready waits for a deployed tenant to be reachable via SSH.
timeout
integer
Default:
600
Maximum number of seconds to wait for the desired state.

Examples

- name: Wait for the specified tenant to be in the configured state.
  f5os_tenant_wait:
    name: bigip_tenant1

- name: Wait a maximum of 300 seconds specified tenant to be in the provisioned state.
  f5os_tenant_wait:
    name: bigip_tenant1
    state: provisioned
    timeout: 300

- name: Wait 30 seconds before verifying the specified tenant to be in the deployed state.
  f5os_tenant_wait:
    name: bigip_tenant1
    state: deployed
    delay: 30

Return Values

The following are the fields unique to this module:

Key Returned Description
elapsed
integer
always
Seconds spent waiting for the requested state.

tenant_state
complex
always
State data for the specified tenant.

  blades
integer
always
Blades allocated to tenant.

  cpu-cores
string
always
CPU Cores allocated to the tenant.

  cryptos
string
always
Tenant crypto state. Enabled or Disabled.

  instances
dictionary
always
Tenant instance details.

  mac-data
dictionary
always
Tenant MAC pool details.

  memory
string
always
Memory allocated to the tenant.

  name
string
always
Name of the tenant.

  running-state
string
always
Tenant running state.

  status
string
always
Tenant Running state.

  type
string
always
Tenant type.



Status

Authors

  • Wojciech Wypior (@wojtek0806)