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-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
password строка		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число добавлен в 2.5	По умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 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 строка		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs булево	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение `false` когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 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.8/modules/vmware_host_service_manager_module.html