vmware_host_ntp – Управление конфигурацией NTP-сервера на хосте ESXi

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

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

Этот модуль можно использовать для настройки, добавления или удаления NTP-серверов из хоста ESXi.
Если state не указано, NTP-серверы будут настраиваться в точном порядке.
Пользователь может указать имя хоста ESXi или имя кластера. В случае имени кластера все хосты ESXi обновляются.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster_name строка		Имя кластера, все хосты которого будут использоваться. Этот параметр требуется, если `esxi_hostname` не указан.
esxi_hostname строка		Имя хоста, с которым нужно работать. Этот параметр требуется, если `cluster_name` не указан.
hostname строка		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
ntp_servers список / обязательно		IP-адрес или FQDN NTP-сервера(ов). Принимает список NTP-серверов. Для нескольких серверов см. примеры.
password строка		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число добавлено в 2.5	По умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host строка добавлено в 2.9		Адрес прокси, который будет получать все запросы HTTPS и перенаправлять их. Формат - имя хоста или IP. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12
proxy_port целое число добавлено в 2.9		Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_PROXY_PORT`.
state строка	Варианты: present absent	present: Добавить NTP-сервер(ы), если указанный сервер(ы) отсутствует, иначе ничего не делать. absent: Удалить NTP-сервер(ы), если указанный сервер(ы) присутствует, иначе ничего не делать. Указанный NTP-сервер(ы) будет настроен, если `state` не указан.
username строка		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs булево	Варианты: no да ←	Разрешает подключение, когда SSL-сертификаты недействительны. Установите значение `false` когда сертификаты не доверяются. Если значение не указано в задаче, вместо него используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено значение `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
verbose булево добавлено в 2.8	Варианты: нет ← да	Подробный вывод о изменении конфигурации. Объясняет, был ли добавлен, удалён NTP-сервер, или был изменён порядок NTP-серверов.

Примечания

Примечание

Тестировалось на vSphere 6.5

Примеры

- name: Configure NTP servers for an ESXi Host
  vmware_host_ntp:
    hostname: vcenter01.example.local
    username: administrator@vsphere.local
    password: SuperSecretPassword
    esxi_hostname: esx01.example.local
    ntp_servers:
        - 0.pool.ntp.org
        - 1.pool.ntp.org
  delegate_to: localhost

- name: Set NTP servers for all ESXi Host in given Cluster
  vmware_host_ntp:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
    state: present
    ntp_servers:
        - 0.pool.ntp.org
        - 1.pool.ntp.org
  delegate_to: localhost

- name: Set NTP servers for an ESXi Host
  vmware_host_ntp:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    state: present
    ntp_servers:
        - 0.pool.ntp.org
        - 1.pool.ntp.org
  delegate_to: localhost

- name: Remove NTP servers for an ESXi Host
  vmware_host_ntp:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    state: absent
    ntp_servers:
        - bad.server.ntp.org
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
results словарь	всегда	метаданные о конфигурации NTP хоста Пример: {'esx01.example.local': {'ntp_servers_changed': ['time1.example.local', 'time2.example.local', 'time3.example.local', 'time4.example.local'], 'ntp_servers': ['time3.example.local', 'time4.example.local'], 'ntp_servers_previous': ['time1.example.local', 'time2.example.local']}, 'esx02.example.local': {'ntp_servers_changed': ['time3.example.local'], 'ntp_servers_current': ['time1.example.local', 'time2.example.local', 'time3.example.local'], 'state': 'present', 'ntp_servers_previous': ['time1.example.local', 'time2.example.local']}}

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Abhijeet Kasurde (@Akasurde)
Christian Kotte (@ckotte)

Подсказка

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

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