ec2_lc — Создание или удаление конфигураций запуска AWS Autoscaling
Новая в версии 1.6.
Описание
- Может создавать или удалять конфигурации запуска AWS Autoscaling
- Работает с модулем ec2_asg для управления группами Autoscaling
Требования (к хосту, на котором выполняется модуль)
- boto
- boto3 >= 1.4.4
- python >= 2.6
Параметры
| параметр | обязательно | значение по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| assign_public_ip (добавлено в 1.8)
| нет | Используется для групп Auto Scaling, которые запускают экземпляры в Amazon Virtual Private Cloud. Указывает, нужно ли назначать публичный IP-адрес каждому экземпляру, запущенному в Amazon VPC. | ||
| 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 | ||
| classic_link_vpc_id (добавлено в 2.0)
| нет | Идентификатор ClassicLink VPC | ||
| classic_link_vpc_security_groups (добавлено в 2.0)
| нет | Список идентификаторов групп безопасности, которые нужно ассоциировать с экземплярами ClassicLink VPC. | ||
| ebs_optimized (добавлено в 1.8)
| нет | Указывает, оптимизирован ли экземпляр для ввода/вывода EBS (true) или нет (false). | ||
| ec2_url | нет | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не указан, используется значение переменной окружения EC2_URL, если она есть. | ||
| image_id | нет | Уникальный идентификатор AMI, который будет использоваться для группы | ||
| instance_id (добавлено в 2.4)
| нет | Идентификатор запущенного экземпляра, который используется в качестве основы для конфигурации запуска. Может использоваться вместо image_id и instance_type. | ||
| instance_monitoring | нет | Указывает, запускаются ли экземпляры с подробным мониторингом. | ||
| instance_profile_name (добавлено в 1.8)
| нет | Имя или Amazon Resource Name (ARN) профиля экземпляра, связанного с ролью IAM для экземпляров. | ||
| instance_type | да | Тип экземпляра, который нужно использовать для экземпляра | ||
| kernel_id | нет | Идентификатор ядра для экземпляра EC2 | ||
| key_name | нет | Имя SSH-ключа, которое будет использоваться для доступа к управляемым экземплярам | ||
| name | да | Уникальное имя для конфигурации | ||
| placement_tenancy (добавлено в 2.4)
| нет | default | Определяет, запускается ли экземпляр на оборудовании с одиночным арендатором или нет. | |
| profile (добавлено в 1.6)
| нет | Использует профиль boto. Работает только с boto >= 2.24.0. | ||
| ramdisk_id (добавлено в 1.8)
| нет | Идентификатор RAM-диска для экземпляров. | ||
| region | нет | AWS регион для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если она есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
алиасы: aws_region, ec2_region | ||
| security_groups | нет | Список групп безопасности для применения к экземплярам. С версии 2.4 можно указывать имена или идентификаторы групп безопасности, или их смесь. До версии 2.4 для экземпляров VPC указывайте идентификаторы групп безопасности, а для экземпляров EC2-Classic - имена или идентификаторы групп безопасности. | ||
| security_token (добавлено в 1.6)
| нет | AWS STS security token. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. алиасы: access_token | ||
| spot_price | нет | Цена, которую вы предлагаете. Применимо только для группы Auto Scaling с экземплярами spot. | ||
| state | да |
| Регистрация или дерегистрация экземпляра | |
| user_data | нет | Необработанные данные, которые предоставляются экземпляру ec2. Взаимоисключительно с user_data_path. | ||
| user_data_path (добавлено в 2.3)
| нет | Путь к файлу, содержащему данные пользователя для экземпляров ec2. Взаимоисключительно с user_data. | ||
| validate_certs (добавлено в 1.5)
| нет | да |
| При установке в значение "нет" сертификаты SSL не будут проверены для версий boto >= 2.6.0. |
| volumes | нет | Список словарей томов, каждый из которых содержит имя устройства и необязательно ephemeral id или snapshot id. Размер и тип (и количество операций ввода/вывода для типа устройства io) должны быть указаны для нового тома или системного тома, и могут быть переданы для тома снимка. Для любого тома размер тома меньше 1 будет интерпретироваться как запрос на то, чтобы том не создавать. | ||
| vpc_id (добавлено в 2.4)
| нет | Идентификатор VPC, используется при преобразовании имен групп безопасности в идентификаторы. |
Примеры
# create a launch configuration using an AMI image and instance type as a basis
- name: note that encrypted volumes are only supported in >= Ansible 2.4
ec2_lc:
name: special
image_id: ami-XXX
key_name: default
security_groups: ['group', 'group2' ]
instance_type: t1.micro
volumes:
- device_name: /dev/sda1
volume_size: 100
device_type: io1
iops: 3000
delete_on_termination: true
encrypted: true
- device_name: /dev/sdb
ephemeral: ephemeral0
# create a launch configuration using a running instance id as a basis
- ec2_lc:
name: special
instance_id: i-00a48b207ec59e948
key_name: default
security_groups: ['launch-wizard-2' ]
volumes:
- device_name: /dev/sda1
volume_size: 120
device_type: io1
iops: 3000
delete_on_termination: true
Примечания
Примечание
- Конфигурации запуска Amazon ASG Autoscaling неизменяемы после создания, поэтому изменение конфигурации после ее изменения не изменит конфигурацию запуска в AWS. Вы должны создать новую конфигурацию и назначить ее ASG вместо этого.
- Тома с шифрованием поддерживаются в версиях >= 2.4
- Если параметры не заданы в модуле, следующие переменные среды могут использоваться в порядке убывания приоритета
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
Статус
Этот модуль помечен как stableinterface, что означает, что авторы этого модуля гарантируют, что не будут внесены несовместимые с обратной совместимостью изменения интерфейса.
Для получения помощи в разработке модулей, если вы так склонны, пожалуйста, прочтите Информацию о сообществе и вклад, Тестирование 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_lc_module.html
