W3cubDocs

/Ansible 2.9

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
-
    Choices:
  • absent
  • present
  • query
Whether the system should be present, absent or a query is made.
sync
boolean
    Choices:
  • no
  • yes
Sync on changes.
Concurrently syncing Cobbler is bound to fail.
use_ssl
boolean
    Choices:
  • no
  • yes
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
    Choices:
  • no
  • yes
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

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

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.9/modules/cobbler_system_module.html