Unlike the citrix.adc
collection, the new netscaler.adc
collection does not require the NITRO Python SDK to be installed on the Ansible control node.
The netscaler.adc
collection supports 4 modes of operation.
Mode (state option) |
Description |
---|---|
present |
This is the default state. Resource will be added/updated and configured according to the module's parameters |
absent |
Resource will be deleted from the target NetScaler ADC nodes |
enabled |
Resource will be enalbed on the NetScaler ADC nodes. Not all resources have enable operation |
disabled |
Resource will be disabled on the NetScaler ADC nodes. Not all resources have disable operation |
unset |
Resource will be unset on the NetScaler ADC node. |
created |
Some of the NITRO resources support create operation. This state will "create" those resources on the NetScaler. Eg: create sslcert , create dnskey etc |
imported |
Resource will be imported on the NetScaler ADC nodes |
flushed |
Resources will be flushed on the NetScaler ADC nodes. Eg., flush dns proxyrecords |
switched |
Switch partition |
NOTE: The
enabled
,disabled
,created
,imported
,switched
modes are supported only for the modules that haveenable
,disable
,create
,import
,switch
operations in the NetScaler ADC NITRO API.
--diff
mode is not supported forenabled
anddisabled
states.
--check
mode is support for all the modules.
The netscaler.adc
collection provides in-built bindings support for all the modules.
In the below example (screenshot), the desired state is to create a lbvserver
with three bindings
- 2
service
bindings and - 1
servicegroup
binding
Every binding is defined as a separate module option. The available bindings are documented in the module documentation.
TIP: Usually the name of the built-in bindings ends with
_binding
suffix. Eg:lbvserver_service_binding
,lbvserver_servicegroup_binding
, etc.
Apart from the in-built bindings, the netscaler.adc
collection also supports explicit bindings.
This support will be helpful if the parent resources are already present in the target Netscaler ADC. And the user wants to create a binding between these resources.