New in version 2.7.
Parameter | Choices/Defaults | Comments |
---|---|---|
host |
Default: 127.0.0.1
|
The name or IP address of the Cobbler system.
|
interfaces |
A list of dictionaries containing interface options.
|
|
name |
The system name to manage.
|
|
password
required |
The password to log in to Cobbler.
|
|
port |
Port number to be used for REST connection.
The default value depends on parameter
use_ssl . |
|
properties |
A dictionary with system properties.
|
|
state |
|
Whether the system should be present, absent or a query is made.
|
sync
bool |
|
Sync on changes.
Concurrently syncing Cobbler is bound to fail.
|
use_ssl
bool |
|
If
no , an HTTP connection will be used instead of the default HTTPS connection. |
username |
Default: cobbler
|
The username to log in to Cobbler.
|
validate_certs
bool |
|
If
no , SSL certificates will not be validated.This should only set to
no when used on personally controlled sites using self-signed certificates. |
Note
- name: Ensure the system exists in Cobbler
cobbler_system:
host: cobbler01
username: cobbler
password: MySuperSecureP4sswOrd
name: myhost
properties:
profile: CentOS6-x86_64
name_servers: [ 2.3.4.5, 3.4.5.6 ]
name_servers_search: foo.com, bar.com
interfaces:
eth0:
macaddress: 00:01:02:03:04:05
ipaddress: 1.2.3.4
delegate_to: localhost
- name: Enable network boot in Cobbler
cobbler_system:
host: bdsol-aci-cobbler-01
username: cobbler
password: ins3965!
name: bdsol-aci51-apic1.cisco.com
properties:
netboot_enabled: yes
state: present
delegate_to: localhost
- name: Query all systems in Cobbler
cobbler_system:
host: cobbler01
username: cobbler
password: MySuperSecureP4sswOrd
register: cobbler_systems
delegate_to: localhost
- name: Query a specific system in Cobbler
cobbler_system:
host: cobbler01
username: cobbler
password: MySuperSecureP4sswOrd
name: '{{ inventory_hostname }}'
register: cobbler_properties
delegate_to: localhost
- name: Ensure the system does not exist in Cobbler
cobbler_system:
host: cobbler01
username: cobbler
password: MySuperSecureP4sswOrd
name: myhost
delegate_to: localhost
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
system
dict
|
when name is provided |
(Resulting) information about the system we are working with
|
systems
list
|
state=query and name is not provided |
List of systems
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.