modules: fix examples to use FQCN (#644)

* modules: fix examples to use FQCN

* fix

* fix

* fix
This commit is contained in:
Andrew Klychkov 2020-07-13 22:50:31 +03:00 committed by GitHub
commit 41cfdda6a3
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
533 changed files with 2130 additions and 2130 deletions

View file

@ -152,7 +152,7 @@ options:
EXAMPLES = r'''
- name: Create a test.example.net A record to point to 127.0.0.1
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.net
record: test
type: A
@ -162,7 +162,7 @@ EXAMPLES = r'''
register: record
- name: Create a record using api token
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.net
record: test
type: A
@ -170,7 +170,7 @@ EXAMPLES = r'''
api_token: dummyapitoken
- name: Create a example.net CNAME record to example.com
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.net
type: CNAME
value: example.com
@ -179,7 +179,7 @@ EXAMPLES = r'''
state: present
- name: Change its TTL
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.net
type: CNAME
value: example.com
@ -189,7 +189,7 @@ EXAMPLES = r'''
state: present
- name: Delete the record
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.net
type: CNAME
value: example.com
@ -198,7 +198,7 @@ EXAMPLES = r'''
state: absent
- name: Create a example.net CNAME record to example.com and proxy through Cloudflare's network
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.net
type: CNAME
value: example.com
@ -209,7 +209,7 @@ EXAMPLES = r'''
# This deletes all other TXT records named "test.example.net"
- name: Create TXT record "test.example.net" with value "unique value"
cloudflare_dns:
community.general.cloudflare_dns:
domain: example.net
record: test
type: TXT
@ -220,7 +220,7 @@ EXAMPLES = r'''
state: present
- name: Create an SRV record _foo._tcp.example.net
cloudflare_dns:
community.general.cloudflare_dns:
domain: example.net
service: foo
proto: tcp
@ -231,7 +231,7 @@ EXAMPLES = r'''
value: fooserver.example.net
- name: Create a SSHFP record login.example.com
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.com
record: login
type: SSHFP
@ -240,7 +240,7 @@ EXAMPLES = r'''
value: 9dc1d6742696d2f51ca1f1a78b3d16a840f7d111eb9454239e70db31363f33e1
- name: Create a TLSA record _25._tcp.mail.example.com
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.com
record: mail
port: 25
@ -252,7 +252,7 @@ EXAMPLES = r'''
value: 6b76d034492b493e15a7376fccd08e63befdad0edab8e442562f532338364bf3
- name: Create a DS record for subdomain.example.com
cloudflare_dns:
community.general.cloudflare_dns:
zone: example.com
record: subdomain
type: DS

View file

@ -78,26 +78,26 @@ author: "Alex Coomans (@drcapulet)"
EXAMPLES = '''
- name: Authenticate using email and API token and fetch all domains
dnsimple:
community.general.dnsimple:
account_email: test@example.com
account_api_token: dummyapitoken
delegate_to: localhost
- name: Fetch my.com domain records
dnsimple:
community.general.dnsimple:
domain: my.com
state: present
delegate_to: localhost
register: records
- name: Delete a domain
dnsimple:
community.general.dnsimple:
domain: my.com
state: absent
delegate_to: localhost
- name: Create a test.my.com A record to point to 127.0.0.1
dnsimple:
community.general.dnsimple:
domain: my.com
record: test
type: A
@ -106,14 +106,14 @@ EXAMPLES = '''
register: record
- name: Delete record using record_ids
dnsimple:
community.general.dnsimple:
domain: my.com
record_ids: '{{ record["id"] }}'
state: absent
delegate_to: localhost
- name: Create a my.com CNAME record to example.com
dnsimple:
community.general.dnsimple:
domain: my.com
record: ''
type: CNAME
@ -122,7 +122,7 @@ EXAMPLES = '''
delegate_to: localhost
- name: Change TTL value for a record
dnsimple:
community.general.dnsimple:
domain: my.com
record: ''
type: CNAME
@ -132,7 +132,7 @@ EXAMPLES = '''
delegate_to: localhost
- name: Delete the record
dnsimple:
community.general.dnsimple:
domain: my.com
record: ''
type: CNAME

View file

@ -184,7 +184,7 @@ author: "Brice Burgess (@briceburg)"
EXAMPLES = '''
- name: Fetch my.com domain records
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -192,7 +192,7 @@ EXAMPLES = '''
register: response
- name: Create a record
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -202,7 +202,7 @@ EXAMPLES = '''
record_value: 127.0.0.1
- name: Update the previously created record
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -211,7 +211,7 @@ EXAMPLES = '''
record_value: 192.0.2.23
- name: Fetch a specific record
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -220,7 +220,7 @@ EXAMPLES = '''
register: response
- name: Delete a record
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -229,7 +229,7 @@ EXAMPLES = '''
record_name: test
- name: Add a failover
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -242,7 +242,7 @@ EXAMPLES = '''
ip2: 127.0.0.3
- name: Add a failover
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -258,7 +258,7 @@ EXAMPLES = '''
ip5: 127.0.0.6
- name: Add a monitor
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -275,7 +275,7 @@ EXAMPLES = '''
contactList: my contact list
- name: Add a monitor with http options
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -295,7 +295,7 @@ EXAMPLES = '''
httpQueryString: some string
- name: Add a monitor and a failover
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -314,7 +314,7 @@ EXAMPLES = '''
contactList: emergencycontacts
- name: Remove a failover
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
@ -325,7 +325,7 @@ EXAMPLES = '''
failover: no
- name: Remove a monitor
dnsmadeeasy:
community.general.dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com

View file

@ -95,25 +95,25 @@ options:
EXAMPLES = r'''
- name: Disable server in 'www' backend pool
haproxy:
community.general.haproxy:
state: disabled
host: '{{ inventory_hostname }}'
backend: www
- name: Disable server without backend pool name (apply to all available backend pool)
haproxy:
community.general.haproxy:
state: disabled
host: '{{ inventory_hostname }}'
- name: Disable server, provide socket file
haproxy:
community.general.haproxy:
state: disabled
host: '{{ inventory_hostname }}'
socket: /var/run/haproxy.sock
backend: www
- name: Disable server, provide socket file, wait until status reports in maintenance
haproxy:
community.general.haproxy:
state: disabled
host: '{{ inventory_hostname }}'
socket: /var/run/haproxy.sock
@ -123,7 +123,7 @@ EXAMPLES = r'''
# Place server in drain mode, providing a socket file. Then check the server's
# status every minute to see if it changes to maintenance mode, continuing if it
# does in an hour and failing otherwise.
- haproxy:
- community.general.haproxy:
state: disabled
host: '{{ inventory_hostname }}'
socket: /var/run/haproxy.sock
@ -134,7 +134,7 @@ EXAMPLES = r'''
wait_retries: 60
- name: Disable backend server in 'www' backend pool and drop open sessions to it
haproxy:
community.general.haproxy:
state: disabled
host: '{{ inventory_hostname }}'
backend: www
@ -142,26 +142,26 @@ EXAMPLES = r'''
shutdown_sessions: yes
- name: Disable server without backend pool name (apply to all available backend pool) but fail when the backend host is not found
haproxy:
community.general.haproxy:
state: disabled
host: '{{ inventory_hostname }}'
fail_on_not_found: yes
- name: Enable server in 'www' backend pool
haproxy:
community.general.haproxy:
state: enabled
host: '{{ inventory_hostname }}'
backend: www
- name: Enable server in 'www' backend pool wait until healthy
haproxy:
community.general.haproxy:
state: enabled
host: '{{ inventory_hostname }}'
backend: www
wait: yes
- name: Enable server in 'www' backend pool wait until healthy. Retry 10 times with intervals of 5 seconds to retrieve the health
haproxy:
community.general.haproxy:
state: enabled
host: '{{ inventory_hostname }}'
backend: www
@ -170,7 +170,7 @@ EXAMPLES = r'''
wait_interval: 5
- name: Enable server in 'www' backend pool with change server(s) weight
haproxy:
community.general.haproxy:
state: enabled
host: '{{ inventory_hostname }}'
socket: /var/run/haproxy.sock
@ -178,7 +178,7 @@ EXAMPLES = r'''
backend: www
- name: Set the server in 'www' backend pool to drain mode
haproxy:
community.general.haproxy:
state: drain
host: '{{ inventory_hostname }}'
socket: /var/run/haproxy.sock

View file

@ -56,14 +56,14 @@ options:
EXAMPLES = r'''
- name: Set value of failover IP 1.2.3.4 to 5.6.7.8
hetzner_failover_ip:
community.general.hetzner_failover_ip:
hetzner_user: foo
hetzner_password: bar
failover_ip: 1.2.3.4
value: 5.6.7.8
- name: Set value of failover IP 1.2.3.4 to unrouted
hetzner_failover_ip:
community.general.hetzner_failover_ip:
hetzner_user: foo
hetzner_password: bar
failover_ip: 1.2.3.4

View file

@ -34,7 +34,7 @@ options:
EXAMPLES = r'''
- name: Get value of failover IP 1.2.3.4
hetzner_failover_ip_info:
community.general.hetzner_failover_ip_info:
hetzner_user: foo
hetzner_password: bar
failover_ip: 1.2.3.4

View file

@ -142,7 +142,7 @@ options:
EXAMPLES = r'''
- name: Configure firewall for server with main IP 1.2.3.4
hetzner_firewall:
community.general.hetzner_firewall:
hetzner_user: foo
hetzner_password: bar
server_ip: 1.2.3.4

View file

@ -58,7 +58,7 @@ options:
EXAMPLES = r'''
- name: Get firewall configuration for server with main IP 1.2.3.4
hetzner_firewall_info:
community.general.hetzner_firewall_info:
hetzner_user: foo
hetzner_password: bar
server_ip: 1.2.3.4

View file

@ -88,7 +88,7 @@ EXAMPLES = r'''
strategy: debug
tasks:
- name: Reserve network into Infinity IPAM
infinity:
community.general.infinity:
server_ip: 80.75.107.12
username: username
password: password

View file

@ -41,12 +41,12 @@ options:
EXAMPLES = '''
- name: Create a namespace named mario
ip_netns:
community.general.ip_netns:
name: mario
state: present
- name: Delete a namespace named luigi
ip_netns:
community.general.ip_netns:
name: luigi
state: absent
'''

View file

@ -40,11 +40,11 @@ notes:
EXAMPLES = r'''
# Gather IP facts from ipify.org
- name: Get my public IP
ipify_facts:
community.general.ipify_facts:
# Gather IP facts from your own ipify service endpoint with a custom timeout
- name: Get my public IP
ipify_facts:
community.general.ipify_facts:
api_url: http://api.example.com/ipify
timeout: 20
'''

View file

@ -33,7 +33,7 @@ notes:
EXAMPLES = '''
# Retrieve geolocation data of a host's IP address
- name: Get IP geolocation data
ipinfoio_facts:
community.general.ipinfoio_facts:
'''
RETURN = '''

View file

@ -119,14 +119,14 @@ author:
EXAMPLES = '''
- name: Create A record
ipwcli_dns:
community.general.ipwcli_dns:
dnsname: example.com
type: A
container: ZoneOne
address: 127.0.0.1
- name: Remove SRV record if exists
ipwcli_dns:
community.general.ipwcli_dns:
dnsname: _sip._tcp.test.example.com
type: SRV
container: ZoneOne
@ -136,7 +136,7 @@ EXAMPLES = '''
port: 5060
- name: Create NAPTR record
ipwcli_dns:
community.general.ipwcli_dns:
dnsname: test.example.com
type: NAPTR
preference: 10

View file

@ -70,7 +70,7 @@ extends_documentation_fragment:
EXAMPLES = r'''
- name: Configure directory number 1 for example.com
ldap_attr:
community.general.ldap_attr:
dn: olcDatabase={1}hdb,cn=config
name: olcSuffix
values: dc=example,dc=com
@ -78,7 +78,7 @@ EXAMPLES = r'''
# The complex argument format is required here to pass a list of ACL strings.
- name: Set up the ACL
ldap_attr:
community.general.ldap_attr:
dn: olcDatabase={1}hdb,cn=config
name: olcAccess
values:
@ -95,7 +95,7 @@ EXAMPLES = r'''
state: exact
- name: Declare some indexes
ldap_attr:
community.general.ldap_attr:
dn: olcDatabase={1}hdb,cn=config
name: olcDbIndex
values: "{{ item }}"
@ -104,7 +104,7 @@ EXAMPLES = r'''
- uid eq
- name: Set up a root user, which we can use later to bootstrap the directory
ldap_attr:
community.general.ldap_attr:
dn: olcDatabase={1}hdb,cn=config
name: "{{ item.key }}"
values: "{{ item.value }}"
@ -114,7 +114,7 @@ EXAMPLES = r'''
olcRootPW: "{SSHA}tabyipcHzhwESzRaGA7oQ/SDoBZQOGND"
- name: Get rid of an unneeded attribute
ldap_attr:
community.general.ldap_attr:
dn: uid=jdoe,ou=people,dc=example,dc=com
name: shadowExpire
values: []
@ -134,7 +134,7 @@ EXAMPLES = r'''
#
# In the example below, 'args' is a task keyword, passed at the same level as the module
- name: Get rid of an unneeded attribute
ldap_attr:
community.general.ldap_attr:
dn: uid=jdoe,ou=people,dc=example,dc=com
name: shadowExpire
values: []

View file

@ -74,7 +74,7 @@ extends_documentation_fragment:
EXAMPLES = r'''
- name: Configure directory number 1 for example.com
ldap_attrs:
community.general.ldap_attrs:
dn: olcDatabase={1}hdb,cn=config
attributes:
olcSuffix: dc=example,dc=com
@ -82,7 +82,7 @@ EXAMPLES = r'''
# The complex argument format is required here to pass a list of ACL strings.
- name: Set up the ACL
ldap_attrs:
community.general.ldap_attrs:
dn: olcDatabase={1}hdb,cn=config
attributes:
olcAccess:
@ -100,7 +100,7 @@ EXAMPLES = r'''
# An alternative approach with automatic X-ORDERED numbering
- name: Set up the ACL
ldap_attrs:
community.general.ldap_attrs:
dn: olcDatabase={1}hdb,cn=config
attributes:
olcAccess:
@ -118,7 +118,7 @@ EXAMPLES = r'''
state: exact
- name: Declare some indexes
ldap_attrs:
community.general.ldap_attrs:
dn: olcDatabase={1}hdb,cn=config
attributes:
olcDbIndex:
@ -126,7 +126,7 @@ EXAMPLES = r'''
- uid eq
- name: Set up a root user, which we can use later to bootstrap the directory
ldap_attrs:
community.general.ldap_attrs:
dn: olcDatabase={1}hdb,cn=config
attributes:
olcRootDN: cn=root,dc=example,dc=com
@ -134,7 +134,7 @@ EXAMPLES = r'''
state: exact
- name: Remove an attribute with a specific value
ldap_attrs:
community.general.ldap_attrs:
dn: uid=jdoe,ou=people,dc=example,dc=com
attributes:
description: "An example user account"
@ -144,7 +144,7 @@ EXAMPLES = r'''
bind_pw: password
- name: Remove specified attribute(s) from an entry
ldap_attrs:
community.general.ldap_attrs:
dn: uid=jdoe,ou=people,dc=example,dc=com
attributes:
description: []

View file

@ -56,12 +56,12 @@ extends_documentation_fragment:
EXAMPLES = """
- name: Make sure we have a parent entry for users
ldap_entry:
community.general.ldap_entry:
dn: ou=users,dc=example,dc=com
objectClass: organizationalUnit
- name: Make sure we have an admin user
ldap_entry:
community.general.ldap_entry:
dn: cn=admin,dc=example,dc=com
objectClass:
- simpleSecurityObject
@ -71,7 +71,7 @@ EXAMPLES = """
userPassword: "{SSHA}tabyipcHzhwESzRaGA7oQ/SDoBZQOGND"
- name: Get rid of an old entry
ldap_entry:
community.general.ldap_entry:
dn: ou=stuff,dc=example,dc=com
state: absent
server_uri: ldap://localhost/
@ -89,7 +89,7 @@ EXAMPLES = """
#
# In the example below, 'args' is a task keyword, passed at the same level as the module
- name: Get rid of an old entry
ldap_entry:
community.general.ldap_entry:
dn: ou=stuff,dc=example,dc=com
state: absent
args: "{{ ldap_auth }}"

View file

@ -39,12 +39,12 @@ extends_documentation_fragment:
EXAMPLES = """
- name: Set a password for the admin user
ldap_passwd:
community.general.ldap_passwd:
dn: cn=admin,dc=example,dc=com
passwd: "{{ vault_secret }}"
- name: Setting passwords in bulk
ldap_passwd:
community.general.ldap_passwd:
dn: "{{ item.key }}"
passwd: "{{ item.value }}"
with_dict:

View file

@ -23,7 +23,7 @@ notes:
EXAMPLES = '''
# Retrieve switch/port information
- name: Gather information from lldp
lldp:
community.general.lldp:
- name: Print each switch/port
debug:

View file

@ -70,7 +70,7 @@ author: "Nicolai Buchwitz (@nbuchwitz)"
EXAMPLES = '''
- name: Create a record of type A
netcup_dns:
community.general.netcup_dns:
api_key: "..."
api_password: "..."
customer_id: "..."
@ -80,7 +80,7 @@ EXAMPLES = '''
value: "127.0.0.1"
- name: Delete that record
netcup_dns:
community.general.netcup_dns:
api_key: "..."
api_password: "..."
customer_id: "..."
@ -91,7 +91,7 @@ EXAMPLES = '''
state: absent
- name: Create a wildcard record
netcup_dns:
community.general.netcup_dns:
api_key: "..."
api_password: "..."
customer_id: "..."
@ -101,7 +101,7 @@ EXAMPLES = '''
value: "127.0.1.1"
- name: Set the MX record for example.com
netcup_dns:
community.general.netcup_dns:
api_key: "..."
api_password: "..."
customer_id: "..."
@ -110,7 +110,7 @@ EXAMPLES = '''
value: "mail.example.com"
- name: Set a record and ensure that this is the only one
netcup_dns:
community.general.netcup_dns:
api_key: "..."
api_password: "..."
customer_id: "..."

View file

@ -68,7 +68,7 @@ options:
EXAMPLES = '''
- name: Configure an A record
nios_a_record:
community.general.nios_a_record:
name: a.ansible.com
ipv4: 192.168.10.1
state: present
@ -79,7 +79,7 @@ EXAMPLES = '''
connection: local
- name: Add a comment to an existing A record
nios_a_record:
community.general.nios_a_record:
name: a.ansible.com
ipv4: 192.168.10.1
comment: this is a test comment
@ -91,7 +91,7 @@ EXAMPLES = '''
connection: local
- name: Remove an A record from the system
nios_a_record:
community.general.nios_a_record:
name: a.ansible.com
ipv4: 192.168.10.1
state: absent
@ -102,7 +102,7 @@ EXAMPLES = '''
connection: local
- name: Update an A record name
nios_a_record:
community.general.nios_a_record:
name: {new_name: a_new.ansible.com, old_name: a.ansible.com}
ipv4: 192.168.10.1
state: present
@ -113,7 +113,7 @@ EXAMPLES = '''
connection: local
- name: Dynamically add a record to next available ip
nios_a_record:
community.general.nios_a_record:
name: a.ansible.com
ipv4: {nios_next_ip: 192.168.10.0/24}
state: present

View file

@ -66,7 +66,7 @@ options:
EXAMPLES = '''
- name: Configure an AAAA record
nios_aaaa_record:
community.general.nios_aaaa_record:
name: aaaa.ansible.com
ipv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
state: present
@ -77,7 +77,7 @@ EXAMPLES = '''
connection: local
- name: Add a comment to an existing AAAA record
nios_aaaa_record:
community.general.nios_aaaa_record:
name: aaaa.ansible.com
ipv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
comment: this is a test comment
@ -89,7 +89,7 @@ EXAMPLES = '''
connection: local
- name: Remove an AAAA record from the system
nios_aaaa_record:
community.general.nios_aaaa_record:
name: aaaa.ansible.com
ipv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
state: absent
@ -100,7 +100,7 @@ EXAMPLES = '''
connection: local
- name: Update an AAAA record name
nios_aaaa_record:
community.general.nios_aaaa_record:
name: {new_name: aaaa_new.ansible.com, old_name: aaaa.ansible.com}
ipv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
state: present

View file

@ -66,7 +66,7 @@ options:
EXAMPLES = '''
- name: Configure a CNAME record
nios_cname_record:
community.general.nios_cname_record:
name: cname.ansible.com
canonical: realhost.ansible.com
state: present
@ -77,7 +77,7 @@ EXAMPLES = '''
connection: local
- name: Add a comment to an existing CNAME record
nios_cname_record:
community.general.nios_cname_record:
name: cname.ansible.com
canonical: realhost.ansible.com
comment: this is a test comment
@ -89,7 +89,7 @@ EXAMPLES = '''
connection: local
- name: Remove a CNAME record from the system
nios_cname_record:
community.general.nios_cname_record:
name: cname.ansible.com
canonical: realhost.ansible.com
state: absent

View file

@ -63,7 +63,7 @@ options:
EXAMPLES = '''
- name: Configure a new dns view instance
nios_dns_view:
community.general.nios_dns_view:
name: ansible-dns
state: present
provider:
@ -72,7 +72,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Update the comment for dns view
nios_dns_view:
community.general.nios_dns_view:
name: ansible-dns
comment: this is an example comment
state: present
@ -82,7 +82,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove the dns view instance
nios_dns_view:
community.general.nios_dns_view:
name: ansible-dns
state: absent
provider:
@ -91,7 +91,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Update the dns view instance
nios_dns_view:
community.general.nios_dns_view:
name: {new_name: ansible-dns-new, old_name: ansible-dns}
state: present
provider:

View file

@ -95,7 +95,7 @@ options:
EXAMPLES = '''
- name: Configure ipv4 dhcp fixed address
nios_fixed_address:
community.general.nios_fixed_address:
name: ipv4_fixed
ipaddr: 192.168.10.1
mac: 08:6d:41:e8:fd:e8
@ -109,7 +109,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Configure a ipv6 dhcp fixed address
nios_fixed_address:
community.general.nios_fixed_address:
name: ipv6_fixed
ipaddr: fe80::1/10
mac: 08:6d:41:e8:fd:e8
@ -123,7 +123,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Set dhcp options for a ipv4 fixed address
nios_fixed_address:
community.general.nios_fixed_address:
name: ipv4_fixed
ipaddr: 192.168.10.1
mac: 08:6d:41:e8:fd:e8
@ -140,7 +140,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove a ipv4 dhcp fixed address
nios_fixed_address:
community.general.nios_fixed_address:
name: ipv4_fixed
ipaddr: 192.168.10.1
mac: 08:6d:41:e8:fd:e8

View file

@ -147,7 +147,7 @@ options:
EXAMPLES = '''
- name: Configure an ipv4 host record
nios_host_record:
community.general.nios_host_record:
name: host.ansible.com
ipv4:
- address: 192.168.10.1
@ -160,7 +160,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Add a comment to an existing host record
nios_host_record:
community.general.nios_host_record:
name: host.ansible.com
ipv4:
- address: 192.168.10.1
@ -172,7 +172,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove a host record from the system
nios_host_record:
community.general.nios_host_record:
name: host.ansible.com
state: absent
provider:
@ -181,7 +181,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Update an ipv4 host record
nios_host_record:
community.general.nios_host_record:
name: {new_name: host-new.ansible.com, old_name: host.ansible.com}
ipv4:
- address: 192.168.10.1
@ -192,7 +192,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Create an ipv4 host record bypassing DNS
nios_host_record:
community.general.nios_host_record:
name: new_host
ipv4:
- address: 192.168.10.1
@ -204,7 +204,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Create an ipv4 host record over DHCP
nios_host_record:
community.general.nios_host_record:
name: host.ansible.com
ipv4:
- address: 192.168.10.1
@ -217,7 +217,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Dynamically add host record to next available ip
nios_host_record:
community.general.nios_host_record:
name: host.ansible.com
ipv4:
- address: {nios_next_ip: 192.168.10.0/24}
@ -229,7 +229,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Add ip to host record
nios_host_record:
community.general.nios_host_record:
name: host.ansible.com
ipv4:
- address: 192.168.10.2
@ -241,7 +241,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove ip to host record
nios_host_record:
community.general.nios_host_record:
name: host.ansible.com
ipv4:
- address: 192.168.10.1

View file

@ -299,7 +299,7 @@ options:
EXAMPLES = '''
- name: Add a member to the grid with IPv4 address
nios_member:
community.general.nios_member:
host_name: member01.localdomain
vip_setting:
- address: 192.168.1.100
@ -315,7 +315,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Add a HA member to the grid
nios_member:
community.general.nios_member:
host_name: memberha.localdomain
vip_setting:
- address: 192.168.1.100
@ -340,7 +340,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Update the member with pre-provisioning details specified
nios_member:
community.general.nios_member:
name: member01.localdomain
pre_provisioning:
- hardware_info:
@ -359,7 +359,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove the member
nios_member:
community.general.nios_member:
name: member01.localdomain
state: absent
provider:

View file

@ -70,7 +70,7 @@ options:
EXAMPLES = '''
- name: Configure an MX record
nios_mx_record:
community.general.nios_mx_record:
name: ansible.com
mx: mailhost.ansible.com
preference: 0
@ -82,7 +82,7 @@ EXAMPLES = '''
connection: local
- name: Add a comment to an existing MX record
nios_mx_record:
community.general.nios_mx_record:
name: ansible.com
mx: mailhost.ansible.com
preference: 0
@ -95,7 +95,7 @@ EXAMPLES = '''
connection: local
- name: Remove an MX record from the system
nios_mx_record:
community.general.nios_mx_record:
name: ansible.com
mx: mailhost.ansible.com
preference: 0

View file

@ -98,7 +98,7 @@ options:
EXAMPLES = '''
- name: Configure a NAPTR record
nios_naptr_record:
community.general.nios_naptr_record:
name: '*.subscriber-100.ansiblezone.com'
order: 1000
preference: 10
@ -111,7 +111,7 @@ EXAMPLES = '''
connection: local
- name: Add a comment to an existing NAPTR record
nios_naptr_record:
community.general.nios_naptr_record:
name: '*.subscriber-100.ansiblezone.com'
order: 1000
preference: 10
@ -125,7 +125,7 @@ EXAMPLES = '''
connection: local
- name: Remove a NAPTR record from the system
nios_naptr_record:
community.general.nios_naptr_record:
name: '*.subscriber-100.ansiblezone.com'
order: 1000
preference: 10

View file

@ -93,7 +93,7 @@ options:
EXAMPLES = '''
- name: Configure a network ipv4
nios_network:
community.general.nios_network:
network: 192.168.10.0/24
comment: this is a test comment
state: present
@ -103,7 +103,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Configure a network ipv6
nios_network:
community.general.nios_network:
network: fe80::/64
comment: this is a test comment
state: present
@ -113,7 +113,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Set dhcp options for a network ipv4
nios_network:
community.general.nios_network:
network: 192.168.10.0/24
comment: this is a test comment
options:
@ -126,7 +126,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove a network ipv4
nios_network:
community.general.nios_network:
network: 192.168.10.0/24
state: absent
provider:
@ -135,7 +135,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Configure a ipv4 network container
nios_network:
community.general.nios_network:
network: 192.168.10.0/24
container: true
comment: test network container
@ -146,7 +146,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Configure a ipv6 network container
nios_network:
community.general.nios_network:
network: fe80::/64
container: true
comment: test network container
@ -157,7 +157,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove a ipv4 network container
nios_network:
community.general.nios_network:
networkr: 192.168.10.0/24
container: true
comment: test network container

View file

@ -53,7 +53,7 @@ options:
EXAMPLES = '''
- name: Configure a new network view
nios_network_view:
community.general.nios_network_view:
name: ansible
state: present
provider:
@ -62,7 +62,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Update the comment for network view
nios_network_view:
community.general.nios_network_view:
name: ansible
comment: this is an example comment
state: present
@ -72,7 +72,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove the network view
nios_network_view:
community.general.nios_network_view:
name: ansible
state: absent
provider:
@ -81,7 +81,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Update a existing network view
nios_network_view:
community.general.nios_network_view:
name: {new_name: ansible-new, old_name: ansible}
state: present
provider:

View file

@ -183,7 +183,7 @@ options:
EXAMPLES = '''
- name: Create simple infoblox nameserver group
nios_nsgroup:
community.general.nios_nsgroup:
name: my-simple-group
comment: "this is a simple nameserver group"
grid_primary:
@ -196,7 +196,7 @@ EXAMPLES = '''
connection: local
- name: Create infoblox nameserver group with external primaries
nios_nsgroup:
community.general.nios_nsgroup:
name: my-example-group
use_external_primary: true
comment: "this is my example nameserver group"
@ -213,7 +213,7 @@ EXAMPLES = '''
connection: local
- name: Delete infoblox nameserver group
nios_nsgroup:
community.general.nios_nsgroup:
name: my-simple-group
comment: "this is a simple nameserver group"
grid_primary:

View file

@ -79,7 +79,7 @@ options:
EXAMPLES = '''
- name: Create a PTR Record
nios_ptr_record:
community.general.nios_ptr_record:
ipv4: 192.168.10.1
ptrdname: host.ansible.com
state: present
@ -90,7 +90,7 @@ EXAMPLES = '''
connection: local
- name: Delete a PTR Record
nios_ptr_record:
community.general.nios_ptr_record:
ipv4: 192.168.10.1
ptrdname: host.ansible.com
state: absent

View file

@ -76,7 +76,7 @@ options:
EXAMPLES = '''
- name: Configure an SRV record
nios_srv_record:
community.general.nios_srv_record:
name: _sip._tcp.service.ansible.com
port: 5080
priority: 10
@ -90,7 +90,7 @@ EXAMPLES = '''
connection: local
- name: Add a comment to an existing SRV record
nios_srv_record:
community.general.nios_srv_record:
name: _sip._tcp.service.ansible.com
port: 5080
priority: 10
@ -105,7 +105,7 @@ EXAMPLES = '''
connection: local
- name: Remove an SRV record from the system
nios_srv_record:
community.general.nios_srv_record:
name: _sip._tcp.service.ansible.com
port: 5080
priority: 10

View file

@ -67,7 +67,7 @@ options:
EXAMPLES = '''
- name: Ensure a text Record Exists
nios_txt_record:
community.general.nios_txt_record:
name: fqdn.txt.record.com
text: mytext
state: present
@ -78,7 +78,7 @@ EXAMPLES = '''
password: admin
- name: Ensure a text Record does not exist
nios_txt_record:
community.general.nios_txt_record:
name: fqdn.txt.record.com
text: mytext
state: absent

View file

@ -90,7 +90,7 @@ options:
EXAMPLES = '''
- name: Configure a zone on the system using grid primary and secondaries
nios_zone:
community.general.nios_zone:
name: ansible.com
grid_primary:
- name: gridprimary.grid.com
@ -105,7 +105,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Configure a zone on the system using a name server group
nios_zone:
community.general.nios_zone:
name: ansible.com
ns_group: examplensg
restart_if_needed: true
@ -116,7 +116,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Configure a reverse mapping zone on the system using IPV4 zone format
nios_zone:
community.general.nios_zone:
name: 10.10.10.0/24
zone_format: IPV4
state: present
@ -126,7 +126,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Configure a reverse mapping zone on the system using IPV6 zone format
nios_zone:
community.general.nios_zone:
name: 100::1/128
zone_format: IPV6
state: present
@ -136,7 +136,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Update the comment and ext attributes for an existing zone
nios_zone:
community.general.nios_zone:
name: ansible.com
comment: this is an example comment
extattrs:
@ -148,7 +148,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove the dns zone
nios_zone:
community.general.nios_zone:
name: ansible.com
state: absent
provider:
@ -157,7 +157,7 @@ EXAMPLES = '''
password: admin
connection: local
- name: Remove the reverse mapping dns zone from the system with IPV4 zone format
nios_zone:
community.general.nios_zone:
name: 10.10.10.0/24
zone_format: IPV4
state: absent

View file

@ -365,7 +365,7 @@ EXAMPLES = r'''
##### Working with all cloud nodes - Teaming
- name: Try nmcli add team - conn_name only & ip4 gw4
nmcli:
community.general.nmcli:
type: team
conn_name: '{{ item.conn_name }}'
ip4: '{{ item.ip4 }}'
@ -375,7 +375,7 @@ EXAMPLES = r'''
- '{{ nmcli_team }}'
- name: Try nmcli add teams-slave
nmcli:
community.general.nmcli:
type: team-slave
conn_name: '{{ item.conn_name }}'
ifname: '{{ item.ifname }}'
@ -386,7 +386,7 @@ EXAMPLES = r'''
###### Working with all cloud nodes - Bonding
- name: Try nmcli add bond - conn_name only & ip4 gw4 mode
nmcli:
community.general.nmcli:
type: bond
conn_name: '{{ item.conn_name }}'
ip4: '{{ item.ip4 }}'
@ -397,7 +397,7 @@ EXAMPLES = r'''
- '{{ nmcli_bond }}'
- name: Try nmcli add bond-slave
nmcli:
community.general.nmcli:
type: bond-slave
conn_name: '{{ item.conn_name }}'
ifname: '{{ item.ifname }}'
@ -408,7 +408,7 @@ EXAMPLES = r'''
##### Working with all cloud nodes - Ethernet
- name: Try nmcli add Ethernet - conn_name only & ip4 gw4
nmcli:
community.general.nmcli:
type: ethernet
conn_name: '{{ item.conn_name }}'
ip4: '{{ item.ip4 }}'
@ -423,7 +423,7 @@ EXAMPLES = r'''
tasks:
- name: Try nmcli del team - multiple
nmcli:
community.general.nmcli:
conn_name: '{{ item.conn_name }}'
state: absent
with_items:
@ -444,7 +444,7 @@ EXAMPLES = r'''
- conn_name: team-p2p2
- name: Add an Ethernet connection with static IP configuration
nmcli:
community.general.nmcli:
conn_name: my-eth1
ifname: eth1
type: ethernet
@ -453,7 +453,7 @@ EXAMPLES = r'''
state: present
- name: Add an Team connection with static IP configuration
nmcli:
community.general.nmcli:
conn_name: my-team1
ifname: my-team1
type: team
@ -463,7 +463,7 @@ EXAMPLES = r'''
autoconnect: yes
- name: Optionally, at the same time specify IPv6 addresses for the device
nmcli:
community.general.nmcli:
conn_name: my-eth1
ifname: eth1
type: ethernet
@ -474,7 +474,7 @@ EXAMPLES = r'''
state: present
- name: Add two IPv4 DNS server addresses
nmcli:
community.general.nmcli:
conn_name: my-eth1
type: ethernet
dns4:
@ -483,21 +483,21 @@ EXAMPLES = r'''
state: present
- name: Make a profile usable for all compatible Ethernet interfaces
nmcli:
community.general.nmcli:
ctype: ethernet
name: my-eth1
ifname: '*'
state: present
- name: Change the property of a setting e.g. MTU
nmcli:
community.general.nmcli:
conn_name: my-eth1
mtu: 9000
type: ethernet
state: present
- name: Add VxLan
nmcli:
community.general.nmcli:
type: vxlan
conn_name: vxlan_test1
vxlan_id: 16
@ -505,7 +505,7 @@ EXAMPLES = r'''
vxlan_remote: 192.168.1.5
- name: Add ipip
nmcli:
community.general.nmcli:
type: ipip
conn_name: ipip_test1
ip_tunnel_dev: eth0
@ -513,7 +513,7 @@ EXAMPLES = r'''
ip_tunnel_remote: 192.168.1.5
- name: Add sit
nmcli:
community.general.nmcli:
type: sit
conn_name: sit_test1
ip_tunnel_dev: eth0
@ -969,7 +969,7 @@ class Nmcli(object):
def create_connection_ethernet(self, conn_type='ethernet'):
# format for creating ethernet interface
# To add an Ethernet connection with static IP configuration, issue a command as follows
# - nmcli: name=add conn_name=my-eth1 ifname=eth1 type=ethernet ip4=192.0.2.100/24 gw4=192.0.2.1 state=present
# - community.general.nmcli: name=add conn_name=my-eth1 ifname=eth1 type=ethernet ip4=192.0.2.100/24 gw4=192.0.2.1 state=present
# nmcli con add con-name my-eth1 ifname eth1 type ethernet ip4 192.0.2.100/24 gw4 192.0.2.1
cmd = [self.nmcli_bin, 'con', 'add', 'type']
if conn_type == 'ethernet':
@ -1008,7 +1008,7 @@ class Nmcli(object):
cmd = [self.nmcli_bin, 'con', 'mod', self.conn_name]
# format for modifying ethernet interface
# To modify an Ethernet connection with static IP configuration, issue a command as follows
# - nmcli: conn_name=my-eth1 ifname=eth1 type=ethernet ip4=192.0.2.100/24 gw4=192.0.2.1 state=present
# - community.general.nmcli: conn_name=my-eth1 ifname=eth1 type=ethernet ip4=192.0.2.100/24 gw4=192.0.2.1 state=present
# nmcli con mod con-name my-eth1 ifname eth1 type ethernet ipv4.address 192.0.2.100/24 ipv4.gateway 192.0.2.1
options = {
'ipv4.method': self.ipv4_method,
@ -1037,7 +1037,7 @@ class Nmcli(object):
def create_connection_bridge(self):
# format for creating bridge interface
# To add an Bridge connection with static IP configuration, issue a command as follows
# - nmcli: name=add conn_name=my-eth1 ifname=eth1 type=bridge ip4=192.0.2.100/24 gw4=192.0.2.1 state=present
# - community.general.nmcli: name=add conn_name=my-eth1 ifname=eth1 type=bridge ip4=192.0.2.100/24 gw4=192.0.2.1 state=present
# nmcli con add con-name my-eth1 ifname eth1 type bridge ip4 192.0.2.100/24 gw4 192.0.2.1
cmd = [self.nmcli_bin, 'con', 'add', 'type', 'bridge', 'con-name']
if self.conn_name is not None:
@ -1074,7 +1074,7 @@ class Nmcli(object):
def modify_connection_bridge(self):
# format for modifying bridge interface
# To add an Bridge connection with static IP configuration, issue a command as follows
# - nmcli: name=mod conn_name=my-eth1 ifname=eth1 type=bridge ip4=192.0.2.100/24 gw4=192.0.2.1 state=present
# - community.general.nmcli: name=mod conn_name=my-eth1 ifname=eth1 type=bridge ip4=192.0.2.100/24 gw4=192.0.2.1 state=present
# nmcli con mod my-eth1 ifname eth1 type bridge ip4 192.0.2.100/24 gw4 192.0.2.1
cmd = [self.nmcli_bin, 'con', 'mod', self.conn_name]

View file

@ -77,7 +77,7 @@ options:
EXAMPLES = '''
- name: Add or modify ansible.example.org A to 192.168.1.1"
nsupdate:
community.general.nsupdate:
key_name: "nsupdate"
key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
server: "10.1.1.1"
@ -86,7 +86,7 @@ EXAMPLES = '''
value: "192.168.1.1"
- name: Add or modify ansible.example.org A to 192.168.1.1, 192.168.1.2 and 192.168.1.3"
nsupdate:
community.general.nsupdate:
key_name: "nsupdate"
key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
server: "10.1.1.1"
@ -95,7 +95,7 @@ EXAMPLES = '''
value: ["192.168.1.1", "192.168.1.2", "192.168.1.3"]
- name: Remove puppet.example.org CNAME
nsupdate:
community.general.nsupdate:
key_name: "nsupdate"
key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
server: "10.1.1.1"
@ -105,7 +105,7 @@ EXAMPLES = '''
state: absent
- name: Add 1.1.168.192.in-addr.arpa. PTR for ansible.example.org
nsupdate:
community.general.nsupdate:
key_name: "nsupdate"
key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
server: "10.1.1.1"
@ -115,7 +115,7 @@ EXAMPLES = '''
state: present
- name: Remove 1.1.168.192.in-addr.arpa. PTR
nsupdate:
community.general.nsupdate:
key_name: "nsupdate"
key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
server: "10.1.1.1"

View file

@ -73,7 +73,7 @@ options:
'''
EXAMPLES = r'''
- name: Add a host using OMAPI
omapi_host:
community.general.omapi_host:
key_name: defomapi
key: +bFQtBCta6j2vWkjPkNFtgA==
host: 10.98.4.55
@ -87,7 +87,7 @@ EXAMPLES = r'''
state: present
- name: Remove a host using OMAPI
omapi_host:
community.general.omapi_host:
key_name: defomapi
key: +bFQtBCta6j2vWkjPkNFtgA==
host: 10.1.1.1

View file

@ -71,14 +71,14 @@ options:
EXAMPLES = r'''
- name: Gather facts with SNMP version 2
snmp_facts:
community.general.snmp_facts:
host: '{{ inventory_hostname }}'
version: v2c
community: public
delegate_to: local
- name: Gather facts using SNMP version 3
snmp_facts:
community.general.snmp_facts:
host: '{{ inventory_hostname }}'
version: v3
level: authPriv