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 use_ssl . | |
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 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 boolean |
| If no , SSL certificates will not be validated.This should only set to no when used on personally controlled sites using self-signed certificates. |
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 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
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)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/cobbler_system_module.html