ipa_host - Управление хостом FreeIPA

Новая версия 2.3.

Описание
Параметры
Примеры
Возвращаемые значения
Состояние
- Автор

Описание

Добавление, изменение и удаление хоста IPA с помощью API IPA

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
description		Описание этого хоста.
force		Принудительное использование имени хоста, даже если он отсутствует в DNS.
fqdn обязательно		Полное доменное имя. Не может быть изменено, так как это уникальный идентификатор. алиасы: имя
ip_address		Добавить хост в DNS с этим IP-адресом.
ipa_host	По умолчанию: ipa.example.com	IP-адрес или имя хоста сервера IPA. Если значение не указано в задании, используется значение переменной окружения `IPA_HOST`. Если ни переменная окружения `IPA_HOST`, ни значение не указаны в задании, используется значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в версии 2.5.
ipa_pass обязательно		Пароль административного пользователя. Если значение не указано в задании, используется значение переменной окружения `IPA_PASS`. Если ни переменная окружения `IPA_PASS`, ни значение не указаны в задании, используется значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в версии 2.5.
ipa_port	По умолчанию: 443	Порт сервера FreeIPA / IPA. Если значение не указано в задании, используется значение переменной окружения `IPA_PORT`. Если ни переменная окружения `IPA_PORT`, ни значение не указаны в задании, используется значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в версии 2.5.
ipa_prot	Варианты: http https ←	Протокол, используемый сервером IPA. Если значение не указано в задании, используется значение переменной окружения `IPA_PROT`. Если ни переменная окружения `IPA_PROT`, ни значение не указаны в задании, используется значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в версии 2.5.
ipa_user	По умолчанию: admin	Используемая административная учетная запись на сервере IPA. Если значение не указано в задании, используется значение переменной окружения `IPA_USER`. Если ни переменная окружения `IPA_USER`, ни значение не указаны в задании, используется значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в версии 2.5.
mac_address		Список аппаратных адресов MAC этого хоста. Если параметр опущен, адреса MAC не будут проверяться или изменяться. Если передан пустой список, все назначенные адреса MAC будут удалены. Адреса MAC, которые уже назначены, но не переданы, будут удалены. алиасы: macaddress
ns_hardware_platform		Аппаратная платформа хоста (например, "Lenovo T61") алиасы: nshardwareplatform
ns_host_location		Расположение хоста (например, "Лаборатория 2") алиасы: nshostlocation
ns_os_version		Операционная система и версия хоста (например, "Fedora 9") алиасы: nsosversion
random_password (добавлено в 2.5)	Варианты: нет ← да	Генерировать случайный пароль для использования в массовой регистрации
state	Варианты: present ← absent disabled	Требуемое состояние
update_dns (добавлено в 2.5)	По умолчанию: нет	Если установлено `"True"`, а состояние — `"absent"`, удаляет записи DNS хоста, управляемого FreeIPA DNS. Этот параметр не имеет эффекта для состояний, отличных от "absent".
user_certificate		Список серверных сертификатов в кодировке Base-64. Если параметр опущен, сертификаты не будут проверяться или изменяться. Если передан пустой список, все назначенные сертификаты будут удалены. Сертификаты, которые уже назначены, но не переданы, будут удалены. алиасы: usercertificate
validate_certs	По умолчанию: да	Это применимо только если `ipa_prot` равно https. Если установлено `no`, сертификаты SSL не будут проверяться. Это должно быть установлено только в `no` используется на сайтах, контролируемых лично, используя самозаверенные сертификаты.

Примеры

# Ensure host is present
- ipa_host:
    name: host01.example.com
    description: Example host
    ip_address: 192.168.0.123
    ns_host_location: Lab
    ns_os_version: CentOS 7
    ns_hardware_platform: Lenovo T61
    mac_address:
    - "08:00:27:E3:B1:2D"
    - "52:54:00:BD:97:1E"
    state: present
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

# Generate a random password for bulk enrolment
- ipa_host:
    name: host01.example.com
    description: Example host
    ip_address: 192.168.0.123
    state: present
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret
    validate_certs: False
    random_password: True

# Ensure host is disabled
- ipa_host:
    name: host01.example.com
    state: disabled
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

# Ensure that all user certificates are removed
- ipa_host:
    name: host01.example.com
    user_certificate: []
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

# Ensure host is absent
- ipa_host:
    name: host01.example.com
    state: absent
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

# Ensure host and its DNS record is absent
- ipa_host:
    name: host01.example.com
    state: absent
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret
    update_dns: True

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
host словарь	всегда	Хост, возвращаемый API IPA.
host_diff список	если режим проверки и обнаружена разница	Список параметров, которые отличаются и будут изменены

Состояние

Этот модуль помечен как предварительный просмотр, что означает, что его интерфейс не гарантируется обратно совместимым.

Автор

Thomas Krahn (@Nosmoht)

Подсказка

Если вы заметили какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/ipa_host_module.html