community.general.cobbler_system – Manage system objects in Cobbler
community.general.cobbler_system – Manage system objects in Cobbler
Note
This plugin is part of the community.general collection (version 2.0.1).
To install it use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.cobbler_system
.
Synopsis
- Add, modify or remove systems in Cobbler
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
host string |
Default: "127.0.0.1" |
The name or IP address of the Cobbler system. |
interfaces dictionary |
A list of dictionaries containing interface options. | |
name string |
The system name to manage. | |
password string |
The password to log in to Cobbler. | |
port integer |
Port number to be used for REST connection. The default value depends on parameter | |
properties dictionary |
A dictionary with system properties. | |
state string |
|
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 string |
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
community.general.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
community.general.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
community.general.cobbler_system:
host: cobbler01
username: cobbler
password: MySuperSecureP4sswOrd
state: query
register: cobbler_systems
delegate_to: localhost
- name: Query a specific system in Cobbler
community.general.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
community.general.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 / elements=string |
state=query and name is not provided
|
List of systems
|
Authors
- Dag Wieers (@dagwieers)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/cobbler_system_module.html