Модуль community.aws.autoscaling_launch_config — создание или удаление конфигураций запуска AWS Auto Scaling

Примечание

Этот модуль входит в коллекцию community.aws (версия 10.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.aws. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: community.aws.autoscaling_launch_config.

Добавлено в community.aws 1.0.0

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Может создавать и удалять конфигурации AWS Auto Scaling.
Работает с модулем community.aws.autoscaling_group для управления группами Auto Scaling.
До выпуска версии 5.0.0 этот модуль назывался community.aws.ec2_lc. Использование не изменилось.

Псевдонимы: ec2_lc

Требования

Следующие требования должны быть выполнены на хосте, где выполняется этот модуль.

python >= 3.6
boto3 >= 1.34.0
botocore >= 1.34.0

Параметры

Параметр	Комментарии
access_key псевдонимы: aws_access_key_id, aws_access_key строка	Идентификатор ключа доступа AWS. Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys. Также можно использовать переменные среды `AWS_ACCESS_KEY_ID` или `AWS_ACCESS_KEY` в порядке убывания приоритета. Параметры aws_access_key и profile взаимоисключающие. Псевдоним aws_access_key_id добавлен в выпуске 5.1.0 для согласованности с AWS SDK botocore.
assign_public_ip логическое значение	Используется для групп Auto Scaling, запускающих экземпляры в Amazon Virtual Private Cloud. Указывает, следует ли назначать общедоступный IP-адрес каждому экземпляру, запущенному в Amazon VPC. Варианты: `false` `true`
aws_ca_bundle путь	Путь к пакету центров сертификации, используемому при проверке SSL-сертификатов. Также можно использовать переменную среды `AWS_CA_BUNDLE`.
aws_config словарь	Словарь для изменения конфигурации botocore. Параметры перечислены в документации AWS: https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config.
classic_link_vpc_id строка	Идентификатор VPC с включенным ClassicLink
classic_link_vpc_security_groups список / элементы=строка	Список идентификаторов групп безопасности, связываемых с экземплярами ClassicLink VPC.
debug_botocore_endpoint_logs логическое значение	Использует регистратор `botocore.endpoint` для анализа уникальных (а не общего числа) вызовов API `"resource:action"`, выполняемых во время задачи, и выводит этот набор в ключ resource_actions результатов задачи. Используйте обратный вызов `aws_resource_action`, чтобы вывести общий список вызовов, выполненных в плейбуке. Также можно использовать переменную среды `ANSIBLE_DEBUG_BOTOCORE_LOGS`. Варианты: `false` ← (по умолчанию) `true`
ebs_optimized логическое значение	Указывает, оптимизирован ли экземпляр для операций ввода-вывода EBS (true) или нет (false). Варианты: `false` ← (по умолчанию) `true`
endpoint_url псевдонимы: aws_endpoint_url строка	URL для подключения вместо конечных точек AWS по умолчанию. Хотя этот параметр можно использовать для подключения к другим совместимым с AWS сервисам, коллекции amazon.aws и community.aws тестируются только с AWS. Также можно использовать переменную среды `AWS_URL`.
image_id строка	Уникальный идентификатор AMI для группы.
instance_id строка	Идентификатор работающего экземпляра, используемого в качестве основы конфигурации запуска. Может использоваться вместо image_id и instance_type.
instance_monitoring логическое значение	Указывает, запускаются ли экземпляры с подробным мониторингом. Варианты: `false` ← (по умолчанию) `true`
instance_profile_name строка	Имя или имя ресурса Amazon (ARN) профиля экземпляра, связанного с ролью IAM для экземпляров.
instance_type строка	Тип экземпляра, используемый для экземпляра. Обязателен при создании новой конфигурации запуска.
kernel_id строка	Идентификатор ядра для экземпляра EC2.
key_name строка	Имя ключа SSH для доступа к управляемым экземплярам.
name строка / обязательный	Уникальное имя конфигурации.
placement_tenancy строка	Определяет, будет ли экземпляр работать на оборудовании с выделенным доступом. Если параметр не задан, AWS использует значение по умолчанию `default`. Варианты: `"default"` `"dedicated"`
profile псевдонимы: aws_profile строка	Именованный профиль AWS для аутентификации. Дополнительные сведения об именованных профилях см. в документации AWS: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html. Также можно использовать переменную среды `AWS_PROFILE`. Параметр profile взаимоисключающий с параметрами aws_access_key, aws_secret_key и session_token.
ramdisk_id строка	Идентификатор RAM-диска для экземпляров.
region псевдонимы: aws_region строка	Регион AWS, который следует использовать. Для глобальных сервисов, таких как IAM, Route53 и CloudFront, параметр region игнорируется. Также можно использовать переменную среды `AWS_REGION`. Дополнительные сведения см. в документации Amazon AWS: http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region.
secret_key псевдонимы: aws_secret_access_key, aws_secret_key строка	Секретный ключ доступа AWS. Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys. Также можно использовать переменные среды `AWS_SECRET_ACCESS_KEY` или `AWS_SECRET_KEY` в порядке убывания приоритета. Параметры secret_key и profile взаимоисключающие. Псевдоним aws_secret_access_key добавлен в выпуске 5.1.0 для согласованности с AWS SDK botocore.
security_groups список / элементы=строка	Список групп безопасности, применяемых к экземплярам. Можно указать имена групп безопасности, их идентификаторы или и то и другое. По умолчанию: `[]`
session_token псевдонимы: aws_session_token строка	Токен сеанса AWS STS для использования с временными учетными данными. Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys. Также можно использовать переменную среды `AWS_SESSION_TOKEN`. Параметры session_token и profile взаимоисключающие.
spot_price число с плавающей точкой	Предлагаемая вами цена Spot. Применяется только к группе Auto Scaling с экземплярами Spot.
state строка	Зарегистрировать или отменить регистрацию экземпляра. Варианты: `"present"` ← (по умолчанию) `"absent"`
user_data строка	Непрозрачный блок данных, доступный экземпляру EC2. Взаимоисключающий с user_data_path.
user_data_path путь	Путь к файлу с пользовательскими данными для экземпляров EC2. Взаимоисключающий с user_data.
validate_certs логическое значение	Если задано значение `false`, SSL-сертификаты при взаимодействии с API AWS проверяться не будут. Настоятельно не рекомендуется устанавливать validate_certs=false; вместо этого рассмотрите возможность задать aws_ca_bundle. Варианты: `false` `true` ← (по умолчанию)
volumes список / элементы=словарь	Список словарей с описанием создаваемых томов. Для любого тома размер меньше `1` будет интерпретироваться как запрос на создание тома.
delete_on_termination логическое значение	Следует ли автоматически удалять том при завершении работы экземпляра. Варианты: `false` ← (по умолчанию) `true`
device_name строка / обязательный	Имя тома (например, `/dev/sda`).
encrypted логическое значение	Следует ли шифровать том с помощью ключа KMS CMK ‘aws/ebs’. Варианты: `false` ← (по умолчанию) `true`
ephemeral строка	Должен ли том быть временным. Данные на временных томах теряются при остановке экземпляра. Взаимоисключающий с параметром snapshot.
iops целое число	Количество операций ввода-вывода в секунду, выделяемых для тома. Обязателен, если volume_type=io1.
no_device логическое значение	Если no_device=true, устройство создано не будет. Варианты: `false` `true`
snapshot строка	Идентификатор снимка EBS, копируемого при создании тома. Взаимоисключающий с параметром ephemeral.
throughput целое число добавлено в community.aws 3.1.0	Пропускная способность, выделяемая для тома gp3. Допустимый диапазон: от 125 до 1000.
volume_size целое число	Размер тома (в ГиБ). Обязателен, если не задан один из параметров ephemeral, snapshot или no_device.
volume_type строка	Тип создаваемого тома. Дополнительные сведения о доступных типах томов см. на странице https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html.
vpc_id строка	Идентификатор VPC, используемый при сопоставлении имен групп безопасности с их идентификаторами.

Примечания

Примечание

Конфигурации запуска Amazon ASG Auto Scaling неизменяемы после создания. Поэтому изменение конфигурации не изменит конфигурацию запуска в AWS. Вместо этого необходимо создать новую конфигурацию и назначить ее группе ASG.
Предупреждение: Для модулей переменные среды и файлы конфигурации считываются из контекста «хоста» Ansible, а не из контекста «контроллера». Поэтому файлы может потребоваться явно скопировать на «хост». Для плагинов поиска и подключения переменные среды и файлы конфигурации считываются из контекста «контроллера» Ansible, а не из контекста «хоста».
Используемый Ansible SDK AWS (boto3) также может считывать значения учетных данных и других параметров, например региона, по умолчанию из файлов конфигурации в контексте «хоста» Ansible (обычно ~/.aws/credentials). Дополнительные сведения см. на странице https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html.

Примеры

- name: create a launch configuration with an encrypted volume
  community.aws.autoscaling_launch_config:
    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
        volume_type: io1
        iops: 3000
        delete_on_termination: true
        encrypted: true
      - device_name: /dev/sdb
        ephemeral: ephemeral0

- name: create a launch configuration using a running instance id as a basis
  community.aws.autoscaling_launch_config:
    name: special
    instance_id: i-00a48b207ec59e948
    key_name: default
    security_groups:
      - 'launch-wizard-2'
    volumes:
      - device_name: /dev/sda1
        volume_size: 120
        volume_type: io1
        iops: 3000
        delete_on_termination: true

- name: create a launch configuration to omit the /dev/sdf EBS device that is included in the AMI image
  community.aws.autoscaling_launch_config:
    name: special
    image_id: ami-XXX
    key_name: default
    security_groups:
      - 'group'
      - 'group2'
    instance_type: t1.micro
    volumes:
      - device_name: /dev/sdf
        no_device: true

- name: Use EBS snapshot ID for volume
  block:
    - name: Set Volume Facts
      ansible.builtin.set_fact:
        volumes:
          - device_name: /dev/sda1
            volume_size: 20
            ebs:
              snapshot: snap-XXXX
              volume_type: gp2
              delete_on_termination: true
              encrypted: false

    - name: Create launch configuration
      community.aws.autoscaling_launch_config:
        name: lc1
        image_id: ami-xxxx
        assign_public_ip: true
        instance_type: t2.medium
        key_name: my-key
        security_groups:
          - 'sg-xxxx'
        volumes: "{{ volumes }}"
      register: lc_info

Возвращаемые значения

Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
arn string	Amazon Resource Name конфигурации запуска. Возвращается: когда state=present Пример: `"arn:aws:autoscaling:us-east-1:123456789012:launchConfiguration:888d9b58-d93a-40c4-90cf-759197a2621a:launchConfigurationName/launch_config_name"`
changed boolean	Изменилось ли состояние конфигурации запуска. Возвращается: всегда Пример: `false`
created_time string	Дата и время создания конфигурации запуска. Возвращается: когда state=present Пример: `"2017-11-03 23:46:44.841000"`
image_id string	ID Amazon Machine Image, используемого конфигурацией запуска. Возвращается: когда state=present Пример: `"ami-9be6f38c"`
instance_type string	Тип экземпляров. Возвращается: когда state=present Пример: `"t1.micro"`
name string	Имя конфигурации запуска. Возвращается: когда state=present Пример: `"launch_config_name"`
result complex	Сведения о спецификации конфигурации запуска. Возвращается: когда state=present
associate_public_ip_address boolean	(EC2-VPC) Указывает, следует ли назначить общедоступный IP-адрес каждому экземпляру. Возвращается: когда state=present Пример: `false`
block_device_mappings complex	Сопоставление блочных устройств, задающее блочные устройства. Возвращается: когда state=present
device_name string	Имя устройства, отображаемое экземпляру EC2 (например, /dev/sdh или xvdh). Возвращается: когда state=present Пример: `"/dev/sda1"`
ebs complex	Информация о томе Amazon EBS. Возвращается: когда state=present
snapshot_id string	ID снимка. Возвращается: когда state=present
volume_size string	Размер тома в ГиБ. Возвращается: когда state=present Пример: `"100"`
virtual_name string	Имя виртуального устройства (например, ephemeral0). Возвращается: когда state=present Пример: `"ephemeral0"`
classic_link_vpc_id string	ID VPC с поддержкой ClassicLink, к которой необходимо подключить экземпляры EC2-Classic. Возвращается: когда state=present
classic_link_vpc_security_groups list / элементы=string	ID одной или нескольких групп безопасности для VPC, указанной в ClassicLinkVPCId. Возвращается: когда state=present Пример: `[]`
created_time string	Дата и время создания конфигурации запуска. Возвращается: когда state=present Пример: `"2017-11-03 23:46:44.841000"`
delete_on_termination boolean	Указывает, удаляется ли том при завершении работы экземпляра. Возвращается: когда state=present Пример: `true`
ebs_optimized boolean	Указывает, оптимизирован ли экземпляр для операций ввода-вывода EBS `true` или нет `false`. Возвращается: когда state=present Пример: `false`
image_id string	ID Amazon Machine Image, используемого конфигурацией запуска. Возвращается: когда state=present Пример: `"ami-9be6f38c"`
instance_monitoring boolean	Указывает, запускаются ли экземпляры в этой группе с подробным `true` или базовым `false` мониторингом. Возвращается: когда state=present Пример: `true`
instance_profile_name string	Имя или Amazon Resource Name (ARN) профиля экземпляра, связанного с ролью IAM для экземпляра. Возвращается: когда state=present
instance_type string	Тип экземпляров. Возвращается: когда state=present Пример: `"t1.micro"`
iops integer	Количество операций ввода-вывода в секунду (IOPS), выделяемых для тома. Возвращается: когда state=present
kernel_id string	ID ядра, связанного с AMI. Возвращается: когда state=present Пример: `""`
key_name string	Имя пары ключей. Возвращается: когда state=present Пример: `"testkey"`
launch_configuration_arn string	Amazon Resource Name (ARN) конфигурации запуска. Возвращается: когда state=present Пример: `"arn:aws:autoscaling:us-east-1:123456789012:launchConfiguration:888d9b58-d93a-40c4-90cf-759197a2621a:launchConfigurationName/launch_config_name"`
member string	Возвращается: когда state=present Пример: `"\n "`
name string	Имя конфигурации запуска. Возвращается: когда state=present Пример: `"launch_config_name"`
PlacementTenancy string	Модель размещения экземпляров: стандартная или выделенная. Возвращается: когда state=present Пример: `"default"`
ramdisk_id string	ID RAM-диска, связанного с AMI. Возвращается: когда state=present Пример: `""`
security_groups list / элементы=string	Группы безопасности, связываемые с экземплярами. Возвращается: когда state=present Пример: `["sg-5e27db2f"]`
spot_price float	Цена ставки при запуске экземпляров Spot. Возвращается: когда state=present
use_block_device_types boolean	Указывает, следует ли скрыть сопоставление устройства. Возвращается: когда state=present Пример: `false`
user_data string	Пользовательские данные, доступные экземплярам. Возвращается: когда state=present Пример: `""`
volume_type string	Тип тома (один из следующих: standard, io1, gp2). Возвращается: когда state=present Пример: `"io1"`
security_groups list / элементы=string	Группы безопасности, связываемые с экземплярами. Возвращается: когда state=present Пример: `["sg-5e27db2f"]`

Авторы

Gareth Rushgrove (@garethr)
Willem van Ketwich (@wilvk)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/aws/autoscaling_launch_config_module.html