aws_batch_compute_environment - Управление средами вычислений AWS Batch

Новая в версии 2.5.

Обзор
- Требования
Параметры
Примечания
Примеры
Значения возврата
Статус
- Автор

Обзор

Этот модуль позволяет управлять средами вычислений AWS Batch. Он идемпотентен и поддерживает режим «Проверка». Используйте модуль batch_compute_environment для управления средой вычислений, batch_job_queue для управления очередями задач и batch_job_definition для управления определениями задач.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

boto
boto3
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key	Значение по умолчанию: None	Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key
aws_secret_key	Значение по умолчанию: None	Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key
bid_percentage		Минимальный процент, на который цена Spot Instance должна быть ниже цены On-Demand для данного типа экземпляра, прежде чем экземпляры будут запущены. Например, если ваш процент ставки составляет 20%, то цена Spot должна быть ниже 20% текущей цены On-Demand для этого экземпляра EC2.
compute_environment_name обязательно		Имя вашей среды вычислений. Допускается до 128 символов (строчные и прописные буквы, цифры и символы подчеркивания).
compute_environment_state	Варианты: ENABLED ← DISABLED	Состояние среды вычислений. Если состояние равно ENABLED, среда вычислений принимает задачи из очереди и может автоматически масштабироваться в зависимости от очередей.
compute_resource_type обязательно	Варианты: EC2 SPOT	Тип вычислительного ресурса.
desiredv_cpus		Желаемое количество виртуальных процессоров EC2 в среде вычислений.
ec2_key_pair		Пара EC2, используемая для запуска экземпляров в среде вычислений.
ec2_url	Значение по умолчанию: None	URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где регион требуется. Должен быть указан для всех остальных модулей, если регион не используется. Если не задано, используется значение переменной окружения EC2_URL, если она есть.
image_id		Идентификатор образа Amazon Machine Image (AMI), используемый для запуска экземпляров в среде вычислений.
instance_role обязательно		Роль экземпляра Amazon ECS, применяемая к экземплярам Amazon EC2 в среде вычислений.
instance_types обязательно		Типы экземпляров, которые могут быть запущены.
maxv_cpus обязательно		Максимальное количество виртуальных процессоров EC2, которое может достичь среда.
minv_cpus обязательно		Минимальное количество виртуальных процессоров EC2, которое среда должна поддерживать.
profile (добавлен в 1.6)	Значение по умолчанию: None	Использует профиль 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_group_ids обязательно		Группы безопасности EC2, связанные с запущенными экземплярами в среде вычислений.
security_token (добавлен в 1.6)	Значение по умолчанию: None	Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token
service_role обязательно		Полный Amazon Resource Name (ARN) роли IAM, которая позволяет AWS Batch делать вызовы к другим службам AWS от вашего имени.
spot_iam_fleet_role		Amazon Resource Name (ARN) роли IAM Amazon EC2 Spot Fleet, применяемой к среде вычислений SPOT.
state обязательно	Варианты: present ← absent	Описывает желаемое состояние.
subnets обязательно		Подсети VPC, в которые запускаются вычислительные ресурсы.
tags		Теги с парами ключ-значение, которые должны быть применены к ресурсам, запущенным в среде вычислений.
type обязательно	Варианты: MANAGED UNMANAGED	Тип среды вычислений.
validate_certs (добавлен в 1.5)	Варианты: no yes ←	При установке в «no», сертификаты SSL не будут проверены для версий boto >= 2.6.0.

Примечания

Примечание

Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета 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

Примеры

---
- hosts: localhost
  gather_facts: no
  vars:
    state: present
  tasks:
  - name: My Batch Compute Environment
    aws_batch_compute_environment:
      compute_environment_name: computeEnvironmentName
      state: present
      region: us-east-1
      compute_environment_state: ENABLED
      type: MANAGED
      compute_resource_type: EC2
      minv_cpus: 0
      maxv_cpus: 2
      desiredv_cpus: 1
      instance_types:
        - optimal
      subnets:
        - my-subnet1
        - my-subnet2
      security_group_ids:
        - my-sg1
        - my-sg2
      instance_role: arn:aws:iam::<account>:instance-profile/<role>
      tags:
        tag1: value1
        tag2: value2
      service_role: arn:aws:iam::<account>:role/service-role/<role>

  - name: show results
    debug: var=aws_batch_compute_environment_action

Значения возврата

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

Ключ	Возвращаемое значение	Описание
output dict	всегда	возвращает, какое действие было выполнено, были ли какие-либо изменения, вызов и ответ Пример: {'invocation': {'module_args': {'profile': None, 'subnets': ['****'], 'tags': {'Environment': '<name>', 'Name': '<name>'}, 'instance_types': ['optimal'], 'bid_percentage': None, 'image_id': None, 'maxv_cpus': 8, 'ec2_url': None, 'security_group_ids': ['***'], 'aws_secret_key': None, 'instance_role': 'arn:aws:iam::...', 'aws_access_key': None, 'desiredv_cpus': 0, 'minv_cpus': 0, 'security_token': None, 'compute_resource_type': 'EC2', 'validate_certs': True, 'region': 'us-east-1', 'compute_environment_state': 'ENABLED', 'state': 'present', 'spot_iam_fleet_role': None, 'service_role': 'arn:aws:iam::....', 'compute_environment_name': '<name>', 'type': 'MANAGED', 'ec2_key_pair': None}}, 'changed': False, 'batch_compute_environment_action': 'none', 'response': {'status': 'VALID', 'serviceRole': 'arn:aws:iam::...', 'computeEnvironmentArn': 'arn:aws:batch:....', 'computeResources': {'subnets': ['***'], 'tags': {'Environment': '<name>', 'Name': '<name>'}, 'desiredvCpus': 0, 'minvCpus': 0, 'instanceTypes': ['optimal'], 'securityGroupIds': ['****'], 'instanceRole': 'arn:aws:iam::...', 'maxvCpus': 8, 'type': 'EC2'}, 'statusReason': 'ComputeEnvironment Healthy', 'ecsClusterArn': 'arn:aws:ecs:.....', 'state': 'ENABLED', 'computeEnvironmentName': '<name>', 'type': 'MANAGED'}}

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Автор

Jon Meran (@jonmer85)

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/aws_batch_compute_environment_module.html