theforeman.foreman.host – Manage Hosts

Note

This plugin is part of the theforeman.foreman collection.

To install it use: ansible-galaxy collection install theforeman.foreman.

To use it in a playbook, specify: theforeman.foreman.host.

New in version 1.0.0: of theforeman.foreman

Synopsis

• Create, update, and delete Hosts

Requirements

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

• requests

Parameters

Parameter		Choices/Defaults	Comments
architecture string			Architecture name
build boolean		Choices: no yes	Whether or not to setup build context for the host
comment string			Comment about the host.
compute_attributes dictionary			Additional compute resource specific attributes. When this parameter is set, the module will not be idempotent.
compute_profile string			Compute profile name
compute_resource string			Compute resource name
config_groups list / elements=string			Config groups list
content_source string			Content source. Only available for Katello installations.
content_view string			Content view. Only available for Katello installations.
domain string			Domain name
enabled boolean		Choices: no yes	Include this host within reporting
environment string			Puppet environment name
hostgroup string			Name of related hostgroup.
image string			The image to use when provision_method=image. The compute_resource parameter is required to find the correct image.
ip string			IP address of the primary interface of the host.
kickstart_repository string			Kickstart repository name. You need to provide this to use the "Synced Content" feature. Mutually exclusive with medium. Only available for Katello installations.
lifecycle_environment string			Lifecycle environment. Only available for Katello installations.
location string			Name of related location
mac string			MAC address of the primary interface of the host. Please include leading zeros and separate nibbles by colons, otherwise the execution will not be idempotent. Example EE:BB:01:02:03:04
managed boolean		Choices: no yes	Whether a host is managed or unmanaged. Forced to true when build=true
medium string			Medium name Mutually exclusive with kickstart_repository. aliases: media
name string / required			Fully Qualified Domain Name of host
openscap_proxy string			OpenSCAP proxy name. Only available when the OpenSCAP plugin is installed.
operatingsystem string			Operating systems are looked up by their title which is composed as "<name> <major>.<minor>". You can omit the version part as long as you only have one operating system by that name.
organization string			Name of related organization
owner string			Owner (user) of the host. Mutually exclusive with owner_group.
owner_group string			Owner (user group) of the host. Mutually excluside with owner.
parameters list / elements=dictionary			Entity domain specific host parameters
	name string / required		Name of the parameter
	parameter_type string	Choices: string ← boolean integer real array hash yaml json	Type of the parameter
	value raw / required		Value of the parameter
password string / required			Password of the user accessing the Foreman server. If the value is not specified in the task, the value of environment variable FOREMAN_PASSWORD will be used instead.
provision_method string		Choices: build image bootdisk	The method used to provision the host. provision_method=bootdisk is only available if the bootdisk plugin is installed.
ptable string			Partition table name
puppet_ca_proxy string			Puppet CA proxy name
puppet_proxy string			Puppet server proxy name
puppetclasses list / elements=string			List of puppet classes to include in this host group. Must exist for hostgroup's puppet environment.
pxe_loader string		Choices: PXELinux BIOS PXELinux UEFI Grub UEFI Grub2 BIOS Grub2 ELF Grub2 UEFI Grub2 UEFI SecureBoot Grub2 UEFI HTTP Grub2 UEFI HTTPS Grub2 UEFI HTTPS SecureBoot iPXE Embedded iPXE UEFI HTTP iPXE Chain BIOS iPXE Chain UEFI None	PXE Bootloader
realm string			Realm name
root_pass string			Root password. Will result in the entity always being updated, as the current password cannot be retrieved.
server_url string / required			URL of the Foreman server. If the value is not specified in the task, the value of environment variable FOREMAN_SERVER_URL will be used instead.
state string		Choices: present ← absent	State of the entity
subnet string			IPv4 Subnet name
subnet6 string			IPv6 Subnet name
username string / required			Username accessing the Foreman server. If the value is not specified in the task, the value of environment variable FOREMAN_USERNAME will be used instead.
validate_certs boolean		Choices: no yes ←	Whether or not to verify the TLS certificates of the Foreman server. If the value is not specified in the task, the value of environment variable FOREMAN_VALIDATE_CERTS will be used instead.

Examples

- name: "Create a host"
  theforeman.foreman.host:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "new_host"
    hostgroup: my_hostgroup
    state: present

- name: "Create a host with build context"
  theforeman.foreman.host:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "new_host"
    hostgroup: my_hostgroup
    build: true
    state: present

- name: "Create an unmanaged host"
  theforeman.foreman.host:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "new_host"
    managed: false
    state: present

- name: "Create a VM with 2 CPUs and 4GB RAM"
  theforeman.foreman.host:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "new_host"
    compute_attributes:
      cpus: 2
      memory_mb: 4096
    state: present

- name: "Create a VM and start it after creation"
  theforeman.foreman.host:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "new_host"
    compute_attributes:
      start: "1"
    state: present

- name: "Delete a host"
  theforeman.foreman.host:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "new_host"
    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.
	hosts list / elements=dictionary	success	List of hosts.

Authors

• Bernhard Hopfenmueller (@Fobhep) ATIX AG