cobbler_system – Manage system objects in Cobbler

From Get docs
Ansible/docs/2.8/modules/cobbler system module


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

-

  • absent
  • present

  • query

Whether the system should be present, absent or a query is made.

sync

boolean

  • no

  • yes

Sync on changes.

Concurrently syncing Cobbler is bound to fail.

use_ssl

boolean

  • 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

  • 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
  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

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