theforeman.foreman.operatingsystem – Manage Operating Systems¶
Note
This plugin is part of the theforeman.foreman collection (version 1.5.1).
To install it use: ansible-galaxy collection install theforeman.foreman
.
To use it in a playbook, specify: theforeman.foreman.operatingsystem
.
New in version 1.0.0: of theforeman.foreman
Parameters¶
Examples¶
- name: "Create an Operating System"
theforeman.foreman.operatingsystem:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: Debian
release_name: stretch
family: Debian
major: 9
parameters:
- name: additional-packages
value: python vim
state: present
- name: "Ensure existence of an Operating System (provide default values)"
theforeman.foreman.operatingsystem:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: Centos
family: Redhat
major: 7
password_hash: SHA256
state: present_with_defaults
- name: "Delete an Operating System"
theforeman.foreman.operatingsystem:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: Debian
family: Debian
major: 9
state: absent
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description | |
---|---|---|---|
entity
dictionary
|
success |
Final state of the affected entities grouped by their type.
|
|
operatinsystems
list
/ elements=dictionary
|
success |
List of operatinsystems.
|
Authors¶
Matthias M Dellweg (@mdellweg) ATIX AG
Bernhard Hopfenmüller (@Fobhep) ATIX AG