vmware_cfg_backup — Резервное копирование/восстановление/сброс конфигурации хоста ESXi
Новая в версии 2.5.
Описание
- Этот модуль может использоваться для выполнения различных операций, связанных с резервным копированием, восстановлением и сбросом конфигурации хоста ESXi.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- Установлен PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| dest | Место назначения, куда будет сохранена конфигурационная сборка ESXi. dest может быть папкой или файлом.
Если dest — это папка, файл резервной копии будет сохранён в папке с именем по умолчанию, сгенерированным из сервера ESXi.
Если dest — это файл, файл резервной копии будет сохранён с указанным именем. Расширение файла всегда будет .tgz. |
|
| esxi_hostname | Имя сервера ESXi. Требуется только при аутентификации через vCenter. |
|
| 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. |
| src | Файл, содержащий конфигурацию ESXi, которая будет восстановлена. |
|
| state |
|
Если
saved, пакет резервной копии .tgz будет сохранён в dest.Если
absent, конфигурация хоста будет сброшена до значений по умолчанию.Если loaded, файл резервной копии в src будет загружен на хост ESXi, перезаписывая настройки хоста. |
| username
str |
Имя пользователя сервера vCenter или ESXi.
Если значение не указано в задаче, будет использовано значение переменной окружения
VMWARE_USER. Поддержка переменных окружения добавлена в версии 2.6.
Псевдонимы: admin, user |
|
| validate_certs
bool |
|
Разрешает подключение, когда сертификаты SSL недействительны. Установите в
false при недоверенных сертификатах.Если значение не указано в задаче, будет использовано значение переменной окружения
VMWARE_VALIDATE_CERTS. Поддержка переменных окружения добавлена в версии 2.6.
Если установлено в yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Тестировалось на ESXi 6.0
- Работает только для хостов ESXi
- Для сохранения или сброса конфигурации хост автоматически переключится в режим технического обслуживания.
Примеры
# save the ESXi configuration locally by authenticating directly against the ESXi host
- name: ESXI backup test
local_action:
module: vmware_cfg_backup
hostname: esxi_hostname
username: user
password: pass
state: saved
dest: /tmp/
# save the ESXi configuration locally by authenticating against the vCenter and selecting the ESXi host
- name: ESXI backup test
local_action:
module: vmware_cfg_backup
hostname: vCenter
esxi_hostname: esxi_hostname
username: user
password: pass
state: saved
dest: /tmp/
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| dest_file
строка |
изменено | Полный путь к файлу, в котором хранятся конфигурации ESXi
Пример:
/tmp/configBundle-esxi.host.domain.tgz |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Поддержка и техническое обслуживание модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Andreas Nafpliotis (@nafpliot-ibm)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете изменить этот документ, чтобы улучшить его.
© 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_cfg_backup_module.html
