cs_instance_password_reset – Позволяет сбросить пароли по умолчанию для ВМ в облаках на основе Apache CloudStack
Новое в версии 2.8.
Обзор
- Сбрасывает пароль учетной записи пользователя по умолчанию на виртуальной машине.
- Требуется установка cloud-init в виртуальной машине.
- Флаг passwordenabled должен быть установлен в шаблоне, связанном с ВМ.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.6.10
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account строка | Учетная запись, к которой принадлежит виртуальная машина. | |
| api_http_method строка |
| HTTP-метод, используемый для запроса к точке входа API. Если не задано, используется переменная среды CLOUDSTACK_METHOD. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания. Значение по умолчанию get, если не указано. |
| api_key строка | Ключ API CloudStack API. Если не задано, используется переменная среды CLOUDSTACK_KEY. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания. | |
| api_region строка | По умолчанию: "cloudstack" | Имя раздела ini в файле cloustack.ini. Если не задано, используется переменная среды CLOUDSTACK_REGION. |
| api_secret строка | Секретный ключ CloudStack API. Если не задано, используется переменная среды CLOUDSTACK_SECRET. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания. | |
| api_timeout целое число | Таймаут HTTP в секундах. Если не задано, используется переменная среды CLOUDSTACK_TIMEOUT. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания. Значение по умолчанию 10 секунд, если не указано. | |
| api_url строка | URL CloudStack API, например https://cloud.example.com/client/api. Если не задано, используется переменная среды CLOUDSTACK_ENDPOINT. В качестве последнего варианта значение берется из конфигурационного файла ini, см. также примечания. | |
| domain строка | Имя домена, к которому принадлежит виртуальная машина. | |
| poll_async логическое значение |
| Опрос асинхронных задач до завершения работы. |
| project строка | Название проекта, к которому принадлежит виртуальная машина. | |
| vm строка / обязательно | Имя виртуальной машины, для которой необходимо сбросить пароль. | |
| zone строка | Имя зоны, в которой развернута виртуальная машина. Если не задано, используется зона по умолчанию. |
Примечания
Примечание
- Ansible использует метод конфигурации библиотеки
cs, если учетные данные не предоставлены в аргументахapi_url,api_key,api_secret. Конфигурация считывается из нескольких мест в указанном порядке.CLOUDSTACK_ENDPOINT,CLOUDSTACK_KEY,CLOUDSTACK_SECRETиCLOUDSTACK_METHOD. Переменные средыCLOUDSTACK_TIMEOUT. Переменная средыCLOUDSTACK_CONFIG, указывающая на файл.ini. Файлcloudstack.iniв текущей рабочей директории. Файл.cloudstack.iniв домашней директории пользователя. Допускается указание нескольких учетных данных и точек входа с помощью разделов ini в файлеcloudstack.ini. Используйте аргументapi_regionдля выбора имени раздела, раздел по умолчаниюcloudstack. Более подробную информацию см. на https://github.com/exoscale/cs. - Подробное руководство по модулям cloudstack можно найти в Руководстве по облакам CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: stop the virtual machine before resetting the password
cs_instance:
name: myvirtualmachine
state: stopped
delegate_to: localhost
- name: reset and get new default password
cs_instance_password_reset:
vm: myvirtualmachine
register: root
delegate_to: localhost
- debug:
msg: "new default password is {{ root.password }}"
- name: boot the virtual machine to activate the new password
cs_instance:
name: myvirtualmachine
state: started
delegate_to: localhost
when: root is changed
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| id строка | успех | ID виртуальной машины. Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f |
| password строка | успех | Новый пароль по умолчанию. Пример: ahQu5nuNge3keesh |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [бета]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Gregor Riepl (@onitake)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/cs_instance_password_reset_module.html