cobbler_system – Manage system objects in Cobbler
cobbler_system – Manage system objects in Cobbler
New in version 2.7.
Synopsis
- Add, modify or remove systems in Cobbler
Parameters
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 | |
properties - |
A dictionary with system properties. | |
state - |
|
Whether the system should be present, absent or a query is made. |
sync boolean |
|
Sync on changes. Concurrently syncing Cobbler is bound to fail. |
use_ssl boolean |
|
If |
username - |
Default: "cobbler" |
The username to log in to Cobbler. |
validate_certs boolean |
|
If This should only set to |
Notes
Note
- Concurrently syncing Cobbler is bound to fail with weird errors.
- On python 2.7.8 and older (i.e. on RHEL7) you may need to tweak the python behaviour to disable certificate validation. More information at Certificate verification in Python standard library HTTP clients.
Examples
- 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
state: query
register: cobbler_systems
delegate_to: localhost
- name: Query a specific system in Cobbler
cobbler_system:
host: cobbler01
username: cobbler
password: MySuperSecureP4sswOrd
name: '{{ inventory_hostname }}'
state: query
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
state: absent
delegate_to: localhost
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
system dictionary |
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
|
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Dag Wieers (@dagwieers)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/cobbler_system_module.html