vmware_maintenancemode – Размещение хоста в режим технического обслуживания
Новое в версии 2.1.
Обзор
- Этот модуль может использоваться для помещения хоста ESXi в режим технического обслуживания.
- Поддержка режима технического обслуживания, совместимого с VSAN, при выборе.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
|
esxi_hostname
- / обязательно
|
Имя хоста, как определено в vCenter.
|
|
|
evacuate
boolean
|
|
Если установлено в
True, эвакуировать все выключенные виртуальные машины. |
|
hostname
строка
|
Имя хоста или IP-адрес сервера vCenter или ESXi.
Если значение не указано в задаче, вместо него будет использовано значение переменной среды
VMWARE_HOST. Поддержка переменных среды добавлена в Ansible 2.6.
|
|
|
password
строка
|
Пароль сервера vCenter или ESXi.
Если значение не указано в задаче, вместо него будет использовано значение переменной среды
VMWARE_PASSWORD. Поддержка переменных среды добавлена в Ansible 2.6.
псевдонимы: pass, pwd |
|
|
port
целое число
добавлено в 2.5
|
Значение по умолчанию: 443
|
Номер порта сервера vCenter или ESXi.
Если значение не указано в задаче, вместо него будет использовано значение переменной среды
VMWARE_PORT. Поддержка переменных среды добавлена в Ansible 2.6.
|
|
state
-
|
|
Ввод или выход из режима технического обслуживания.
|
|
timeout
-
|
Значение по умолчанию: 0
|
Укажите тайм-аут для операции.
|
|
username
строка
|
Имя пользователя сервера vCenter или ESXi.
Если значение не указано в задаче, вместо него будет использовано значение переменной среды
VMWARE_USER. Поддержка переменных среды добавлена в Ansible 2.6.
псевдонимы: admin, user |
|
|
validate_certs
boolean
|
|
Позволяет подключиться, когда сертификаты SSL недействительны. Установите в
false, когда сертификаты не доверяются.Если значение не указано в задаче, вместо него будет использовано значение переменной среды
VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в Ansible 2.6.
Если установлено в
yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
|
vsan
-
|
|
Укажите, какой режим VSAN, совместимый с VSAN, необходимо выбрать.
псевдонимы: vsan_mode |
Примечания
Примечание
- Проверено на vSphere 5.5, 6.0 и 6.5
Примеры
- name: Enter VSAN-Compliant Maintenance Mode
vmware_maintenancemode:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
esxi_hostname: "{{ esxi_hostname }}"
vsan: ensureObjectAccessibility
evacuate: yes
timeout: 3600
state: present
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
|
hostname
строка
|
всегда |
Имя хоста в vCenter
Пример:
esxi.local.domain
|
|
hostsystem
строка
|
всегда |
Имя vim ссылки
Пример:
'vim.HostSystem:host-236'
|
|
status
строка
|
всегда |
Выполненное действие
Пример:
ВВОД
|
Статус
- Гарантия обратной совместимости интерфейса этого модуля не предоставляется. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Jay Jahns (@jjahns) <jjahns@vmware.com>
- 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_maintenancemode_module.html
