vmware_host_service_manager – Управление службами на заданном узле ESXi

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

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

Обзор

Этот модуль может использоваться для управления (запуск, остановка, перезапуск) служб на заданном узле ESXi.
Если задано cluster_name, указанная служба будет управляться на всех узлах ESXi, принадлежащих этому кластеру.
Если задано конкретное значение esxi_hostname, указанная служба будет управляться только на данном узле ESXi.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster_name -		Имя кластера. Настройки службы применяются к каждому узлу ESXi в указанном кластере. Если `esxi_hostname` не задано, этот параметр обязателен.
esxi_hostname -		Имя хоста ESXi. Настройки службы применяются к этому узлу ESXi. Если `cluster_name` не задано, этот параметр обязателен.
hostname строка		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в версии 2.6.
password строка		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: pass, pwd
port целое число добавлен в 2.5	По умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в версии 2.6.
service_name - / обязательно		Имя управляемой службы. Это краткое идентификатор службы, например, ntpd, vxsyslogd и т.д. Это значение должно быть допустимым именем службы ESXi.
service_policy -	Варианты: automatic off on	Множество допустимых строк политики службы. Если установлено `on`, служба должна запускаться при запуске хоста. Если установлено `automatic`, служба должна запускаться только в том случае, если у нее открыты порты брандмауэра. Если установлено `off`, служба не должна запускаться при запуске хоста.
state -	Варианты: absent present restart start ← stop	Желаемое состояние службы. Состояния 'start' и 'present' имеют одинаковый эффект. Состояния 'stop' и 'absent' имеют одинаковый эффект.
username строка		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: admin, user
validate_certs boolean	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в `false` при недоверии сертификатов. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в версии 2.6. Если установлено в `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

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

Примеры

- name: Start ntpd service setting for all ESXi Host in given Cluster
  vmware_host_service_manager:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
    service_name: ntpd
    state: present
  delegate_to: localhost

- name: Start ntpd setting for an ESXi Host
  vmware_host_service_manager:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    service_name: ntpd
    state: present
  delegate_to: localhost

- name: Start ntpd setting for an ESXi Host with Service policy
  vmware_host_service_manager:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    service_name: ntpd
    service_policy: on
    state: present
  delegate_to: localhost

- name: Stop ntpd setting for an ESXi Host
  vmware_host_service_manager:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    service_name: ntpd
    state: absent
  delegate_to: localhost

Статус

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

Авторы

Abhijeet Kasurde (@Akasurde)

Подсказка

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

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