community.vmware.vmware_host_service_manager — Управление службами на указанном хосте ESXi

Примечание

Этот плагин входит в коллекцию community.vmware (версия 1.7.0).

Для его установки используйте: ansible-galaxy collection install community.vmware

Чтобы использовать его в книге задач, укажите: community.vmware.vmware_host_service_manager

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

Обзор

Этот модуль можно использовать для управления (запуска, остановки, перезапуска) служб на заданном хосте ESXi.
Если указано имя кластера, указанная служба будет управляться на всех хостах 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 целое число	По умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT` Поддержка переменных окружения добавлена в Ansible 2.6.
proxy_host строка		Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PROXY_HOST` Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12
proxy_port целое число		Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PROXY_PORT`
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. Если установлено в `true`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

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

Примеры

- name: Start ntpd service setting for all ESXi Host in given Cluster
  community.vmware.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
  community.vmware.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
  community.vmware.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
  community.vmware.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

Авторы

Abhijeet Kasurde (@Akasurde)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_host_service_manager_module.html