foreman_installation_medium – Manage Foreman Installation Medium using Foreman API

Synopsis

  • Create and Delete Foreman Installation Medium using Foreman API

Requirements

The below requirements are needed on the host that executes this module.

  • apypie

Parameters

Parameter Choices/Defaults Comments
locations
list
List of locations the entity should be assigned to
name
string / required
The full installation medium name. The special name "*" (only possible as parameter) is used to perform bulk actions (modify, delete) on all existing partition tables.
operatingsystems
list
List of operating systems the installation medium should be assigned to
organizations
list
List of organizations the entity should be assigned to
os_family
string
    Choices:
  • AIX
  • Altlinux
  • Archlinux
  • Coreos
  • Debian
  • Freebsd
  • Gentoo
  • Junos
  • NXOS
  • Rancheros
  • Redhat
  • Solaris
  • Suse
  • Windows
  • Xenserver
The OS family the template shall be assigned with.
If no os_family is set but a operatingsystem, the value will be derived from it.
password
string / required
Password of the user accessing the Foreman server
path
string
Path to the installation medium
server_url
string / required
URL of the Foreman server
state
string
    Choices:
  • present ←
  • present_with_defaults
  • absent
State of the entity in Foreman
present_with_defaults will ensure the entity exists, but won't update existing ones
updated_name
string
New full installation medium name. When this parameter is set, the module will not be idempotent.
username
string / required
Username accessing the Foreman server
validate_certs
boolean
    Choices:
  • no
  • yes ←
Whether or not to verify the TLS certificates of the Foreman server

aliases: verify_ssl

Examples

- name: create new debian medium
  foreman_installation_medium:
    name: "wheezy"
    locations:
      - "Munich"
    organizations:
      - "ATIX"
    operatingsystems:
      - "Debian"
    path: "http://debian.org/mirror/"
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "secret"
    state: present

Status

Authors

  • Manuel Bonk(@manuelbonk) ATIX AG

Hint

If you notice any issues in this documentation, you can edit this document to improve it.