Working with Command Output in Network Modules¶
Conditionals in Networking Modules¶
Ansible allows you to use conditionals to control the flow of your playbooks. Ansible networking command modules use the following unique conditional statements.
neq- Not equal
gt- Greater than
ge- Greater than or equal
lt- Less than
le- Less than or equal
contains- Object contains specified item
Conditional statements evaluate the results from the commands that are
executed remotely on the device. Once the task executes the command
wait_for argument can be used to evaluate the results before
returning control to the Ansible playbook.
--- - name: wait for interface to be admin enabled eos_command: commands: - show interface Ethernet4 | json wait_for: - "result.interfaces.Ethernet4.interfaceStatus eq connected"
In the above example task, the command
show interface Ethernet4 | json
is executed on the remote device and the results are evaluated. If
(result.interfaces.Ethernet4.interfaceStatus) is not equal to
“connected”, then the command is retried. This process continues
until either the condition is satisfied or the number of retries has
expired (by default, this is 10 retries at 1 second intervals).
The commands module can also evaluate more than one set of command results in an interface. For instance:
--- - name: wait for interfaces to be admin enabled eos_command: commands: - show interface Ethernet4 | json - show interface Ethernet5 | json wait_for: - "result.interfaces.Ethernet4.interfaceStatus eq connected" - "result.interfaces.Ethernet4.interfaceStatus eq connected"
In the above example, two commands are executed on the remote device, and the results are evaluated. By specifying the result index value (0 or 1), the correct result output is checked against the conditional.
wait_for argument must always start with result and then the
command index in
0 is the first command in the commands list,
1 is the second command,
2 is the third and so on.