ec2_win_password - получает значение по умолчанию для пароля администратора EC2 виртуальных машин с Windows
Новая версия с 2.0.
Описание
- Получает значение по умолчанию для пароля администратора на любой виртуальной машине EC2 с Windows. Виртуальная машина задается по её идентификатору (например, i-XXXXXXX). Этот модуль зависит от библиотеки python-boto.
Требования (для хоста, на котором выполняется модуль)
- boto
- cryptography
- python >= 2.6
Параметры
| параметр | обязательно | значение по умолчанию | возможные значения | примечания |
|---|---|---|---|---|
| aws_access_key | нет | Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. псевдонимы: ec2_access_key, access_key | ||
| aws_secret_key | нет | Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. псевдонимы: ec2_secret_key, secret_key | ||
| ec2_url | нет | URL для подключения к EC2 или облаку Eucalyptus (по умолчанию используется конечная точка EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если она задана. | ||
| instance_id | да | Идентификатор виртуальной машины для получения данных о пароле. | ||
| key_file | да | Путь к файлу, содержащему пару ключей, используемую на виртуальной машине. | ||
| key_passphrase (добавлен в 2.0)
| нет | Пароль к паре ключей виртуальной машины. Ключ должен использовать шифрование DES или 3DES для расшифровки этим модулем. Вы можете использовать openssl для преобразования защищенных паролем ключей, если они не используют DES или 3DES. Пример: openssl rsa -in current_key -out new_key -des3. | ||
| profile (добавлен в 1.6)
| нет | Использует профиль boto. Работает только с boto >= 2.24.0. | ||
| region | нет | Регион AWS для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если оно задано. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
псевдонимы: aws_region, ec2_region | ||
| security_token (добавлен в 1.6)
| нет | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token | ||
| validate_certs (добавлен в 1.5)
| нет | да |
| Если установлено «нет», сертификаты SSL не будут проверяться для версий boto >= 2.6.0. |
| wait (добавлен в 2.0)
| нет | нет |
| Ожидать доступности пароля перед возвратом. |
| wait_timeout (добавлен в 2.0)
| нет | 120 | Количество секунд ожидания перед отказом. |
Примеры
# Example of getting a password
tasks:
- name: get the Administrator password
ec2_win_password:
profile: my-boto-profile
instance_id: i-XXXXXX
region: us-east-1
key_file: "~/aws-creds/my_test_key.pem"
# Example of getting a password with a password protected key
tasks:
- name: get the Administrator password
ec2_win_password:
profile: my-boto-profile
instance_id: i-XXXXXX
region: us-east-1
key_file: "~/aws-creds/my_protected_test_key.pem"
key_passphrase: "secret"
# Example of waiting for a password
tasks:
- name: get the Administrator password
ec2_win_password:
profile: my-boto-profile
instance_id: i-XXXXXX
region: us-east-1
key_file: "~/aws-creds/my_test_key.pem"
wait: yes
wait_timeout: 45
Примечания
Примечание
- Начиная с Ansible 2.4, этот модуль требует модуль python cryptography, а не устаревший pycrypto.
- Если параметры не установлены в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета
AWS_URLилиEC2_URL,AWS_ACCESS_KEY_IDилиAWS_ACCESS_KEYилиEC2_ACCESS_KEY,AWS_SECRET_ACCESS_KEYилиAWS_SECRET_KEYилиEC2_SECRET_KEY,AWS_SECURITY_TOKENилиEC2_SECURITY_TOKEN,AWS_REGIONилиEC2_REGION - Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
-
AWS_REGIONилиEC2_REGIONобычно используется для указания региона AWS, когда это необходимо, но это также можно настроить в файле конфигурации boto
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратной совместимости интерфейса.
Для получения помощи в разработке модулей обратитесь к документации Информация о сообществе и внесение изменений, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ec2_win_password_module.html