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 str		Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в версии 2.6.
password str		Пароль сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: pass, pwd
port int (добавлен в 2.5)	По умолчанию: 443	Номер порта сервера 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 str		Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: admin, user
validate_certs bool	Варианты: 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

- 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

- 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

- 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

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Более подробную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом 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.6/modules/vmware_host_service_manager_module.html