create-compute-environment

Описание

Создает среду выполнения Batch. Вы можете создать управляемые или неуправляемые среды выполнения. Управляемые среды выполнения могут использовать ресурсы Amazon EC2 или Fargate. Неуправляемые среды выполнения могут использовать только ресурсы EC2.

В управляемой среде выполнения Batch управляет емкостью и типами экземпляров вычислительных ресурсов в среде. Это основано на спецификации вычислительных ресурсов, которую вы определяете, или на шаблоне запуска, который вы указываете при создании среды выполнения. Вы можете выбрать использование экземпляров EC2 On-Demand и EC2 Spot. Или вы можете использовать емкость Fargate и Fargate Spot в своей управляемой среде выполнения. Вы можете задать максимальную цену, чтобы экземпляры Spot запускались только в том случае, если цена экземпляра Spot меньше определенного процента цены On-Demand.

Примечание

Многоузловые параллельные задания не поддерживаются на экземплярах Spot.

В неуправляемой среде выполнения вы можете управлять собственными вычислительными ресурсами EC2 и иметь гибкость в том, как вы настраиваете свои вычислительные ресурсы. Например, вы можете использовать пользовательские AMI. Однако вы должны убедиться, что каждый ваш AMI соответствует спецификации AMI экземпляра контейнера Amazon ECS. Дополнительную информацию см. в разделе AMI экземпляров контейнеров в руководстве разработчика Amazon Elastic Container Service. После создания неуправляемой среды выполнения вы можете использовать операцию DescribeComputeEnvironments для поиска связанного с ней кластера Amazon ECS. Затем вы можете запустить свои экземпляры контейнеров в этот кластер Amazon ECS. Дополнительную информацию см. в разделе Запуск экземпляра контейнера Amazon ECS в руководстве разработчика Amazon Elastic Container Service.

Примечание

Для создания среды выполнения, использующей ресурсы EKS, у вызывающего абонента должны быть разрешения на вызов eks:DescribeCluster.

Примечание

Batch не автоматически обновляет AMI в среде выполнения после ее создания. Например, он также не обновляет AMI в вашей среде выполнения, когда доступна новая версия оптимизированного для Amazon ECS AMI. Вы несете ответственность за управление гостевой операционной системой. Это включает любые обновления и исправления безопасности. Вы также несете ответственность за любое дополнительное программное обеспечение или утилиты, которые вы устанавливаете на вычислительные ресурсы. Есть два способа использовать новый AMI для ваших заданий Batch. Исходный метод заключается в выполнении следующих шагов:

Создайте новую среду выполнения с новым AMI.
Добавьте среду выполнения в существующую очередь заданий.
Удалите предыдущую среду выполнения из вашей очереди заданий.
Удалите предыдущую среду выполнения.

В апреле 2022 года Batch добавил расширенную поддержку обновления сред выполнения. Дополнительную информацию см. в разделе Обновление сред выполнения. Чтобы использовать расширенное обновление сред выполнения для обновления AMI, следуйте этим правилам:

Не задавайте параметр service role (serviceRole) или задайте его на связанную роль сервиса AWSBatchServiceRole.
Задайте параметр стратегии распределения (allocationStrategy) на BEST_FIT_PROGRESSIVE, SPOT_CAPACITY_OPTIMIZED или SPOT_PRICE_CAPACITY_OPTIMIZED.
Задайте параметр обновления до последней версии изображения (updateToLatestImageVersion) на true. Параметр updateToLatestImageVersion используется при обновлении среды выполнения. Этот параметр игнорируется при создании среды выполнения.
Не указывайте ID AMI в imageId, imageIdOverride (в ` ec2Configuration https://docs.aws.amazon.com/batch/latest/APIReference/API_Ec2Configuration.html`__ ), или в шаблоне запуска (launchTemplate). В этом случае Batch выбирает последний оптимизированный для Amazon ECS AMI, поддерживаемый Batch на момент инициирования обновления инфраструктуры. В качестве альтернативы вы можете указать ID AMI в параметрах imageId или imageIdOverride, или в шаблоне запуска, определенном свойствами LaunchTemplate. Изменение любого из этих свойств запускает обновление инфраструктуры. Если ID AMI указан в шаблоне запуска, он не может быть заменен указанием ID AMI в параметрах imageId или imageIdOverride. Его можно заменить только указанием другого шаблона запуска или, если версия шаблона запуска установлена на $Default или $Latest, задав либо новую версию по умолчанию для шаблона запуска (если $Default), либо добавив новую версию в шаблон запуска (если $Latest).

Если эти правила соблюдаются, любое обновление, которое запускает обновление инфраструктуры, приводит к повторному выбору ID AMI. Если значение version в шаблоне запуска (launchTemplate) установлено на $Latest или $Default, последняя или версия по умолчанию шаблона запуска оценивается на момент обновления инфраструктуры, даже если launchTemplate не обновлялся.

См. также: Документация по API AWS

Синопсис

  create-compute-environment
--compute-environment-name <value>
--type <value>
[--state <value>]
[--unmanagedv-cpus <value>]
[--compute-resources <value>]
[--service-role <value>]
[--tags <value>]
[--eks-configuration <value>]
[--context <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--compute-environment-name (строка)

Имя вашей среды выполнения. Длина может составлять до 128 символов. Может содержать прописные и строчные буквы, цифры, дефисы (-) и подчеркивания (_).

--type (строка)

Тип среды выполнения: управляемый или неуправляемый. Дополнительную информацию см. в разделе Среды выполнения в руководстве пользователя Batch.

Возможные значения:

MANAGED
UNMANAGED

--state (строка)

Состояние среды выполнения. Если состояние равно ENABLED, среда выполнения принимает задания из очереди и может автоматически масштабироваться в зависимости от очереди.

Если состояние равно ENABLED, планировщик Batch может попытаться разместить задания из связанной очереди заданий на вычислительные ресурсы в среде. Если среда выполнения управляемая, она может автоматически масштабировать свои экземпляры вверх или вниз в зависимости от спроса очереди заданий.

Если состояние равно DISABLED, планировщик Batch не пытается размещать задания в среде. Задания в состоянии STARTING или RUNNING продолжают выполняться нормально. Управляемые среды выполнения в состоянии DISABLED не масштабируются.

Примечание

Среды выполнения в состоянии DISABLED могут продолжать взимать плату за использование. Чтобы избежать дополнительных расходов, отключите и удалите среду выполнения. Дополнительную информацию см. в разделе Состояние в руководстве пользователя Batch.

Когда экземпляр простаивает, он масштабируется до значения minvCpus. Однако размер экземпляра не меняется. Например, рассмотрим экземпляр c5.8xlarge с значением minvCpus равным 4 и значением desiredvCpus равным 36. Этот экземпляр не масштабируется до экземпляра c5.large.

Возможные значения:

ENABLED
DISABLED

--unmanagedv-cpus (целое число)

Максимальное количество виртуальных процессоров для неуправляемой среды выполнения. Этот параметр используется только для планирования по принципу справедливого распределения, чтобы резервировать емкость vCPU для новых идентификаторов распределения. Если этот параметр не указан для очереди заданий по принципу справедливого распределения, емкость vCPU не резервируется.

Примечание

Этот параметр поддерживается только при установке параметра type на значение UNMANAGED.

--compute-resources (структура)

Подробная информация о вычислительных ресурсах, управляемых вычислительной средой. Этот параметр требуется для управляемых вычислительных сред. Дополнительные сведения см. в разделе «Вычислительные среды» в руководстве пользователя Batch .

type -> (string)

Тип вычислительной среды: EC2 , SPOT , FARGATE или FARGATE_SPOT . Дополнительные сведения см. в разделе «Вычислительные среды» в руководстве пользователя Batch .

Если вы выберите SPOT , вы также должны указать роль Amazon EC2 Spot Fleet с параметром spotIamFleetRole . Дополнительные сведения см. в разделе «Роль флота Amazon EC2 spot» в руководстве пользователя Batch .

allocationStrategy -> (string)

Стратегия распределения вычислительных ресурсов, если невозможно выделить достаточное количество экземпляров наилучшего подходящего типа экземпляра. Это может быть связано с доступностью типа экземпляра в регионе или ограничениями сервиса Amazon EC2 . Дополнительные сведения см. в разделе «Стратегии распределения» в руководстве пользователя Batch .

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

BEST_FIT (по умолчанию)

Batch выбирает тип экземпляра, который наилучшим образом соответствует потребностям задач, отдавая предпочтение экземпляру с наименьшей стоимостью. Если дополнительные экземпляры выбранного типа экземпляра недоступны, Batch ожидает их доступности. Если экземпляров недостаточно или пользователь достигает ограничений сервиса Amazon EC2 , дополнительные задачи не будут выполняться до завершения текущих задач. Эта стратегия распределения снижает затраты, но может ограничить масштабирование. Если вы используете Spot Fleets с BEST_FIT , необходимо указать роль IAM Spot Fleet. Вычислительные ресурсы, использующие стратегию распределения BEST_FIT , не поддерживают обновления инфраструктуры и не могут обновлять некоторые параметры. Дополнительные сведения см. в разделе «Обновление вычислительных сред» в руководстве пользователя Batch .

BEST_FIT_PROGRESSIVE

Batch выбирает дополнительные типы экземпляров, достаточно большие для удовлетворения требований задач в очереди. Он отдает предпочтение типам экземпляров с меньшим количеством vCPU. Если дополнительные экземпляры ранее выбранных типов экземпляров недоступны, Batch выбирает новые типы экземпляров.

SPOT_CAPACITY_OPTIMIZED

Batch выбирает один или несколько типов экземпляров, достаточно больших для удовлетворения требований задач в очереди. Он отдает предпочтение типам экземпляров, которые с меньшей вероятностью будут прерваны. Эта стратегия распределения доступна только для вычислительных ресурсов типа Spot Instance.

SPOT_PRICE_CAPACITY_OPTIMIZED

Стратегия оптимизации цены и емкости рассматривает как цену, так и емкость для выбора пулов Spot Instance, которые с наименьшей вероятностью будут прерваны и имеют наименьшую возможную цену. Эта стратегия распределения доступна только для вычислительных ресурсов типа Spot Instance.

При использовании BEST_FIT_PROGRESSIVE , стратегии ``SPOT_CAPACITY_OPTIMIZED`` и SPOT_PRICE_CAPACITY_OPTIMIZED (рекомендуемая) с использованием On-Demand или Spot Instances, а также стратегии BEST_FIT с использованием Spot Instances, Batch может потребоваться превысить maxvCpus для удовлетворения ваших потребностей в емкости. В этом случае Batch никогда не превышает maxvCpus более чем на один экземпляр.

minvCpus -> (integer)

Минимальное количество vCPU, которое должна поддерживать вычислительная среда (даже если вычислительная среда DISABLED ).

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

maxvCpus -> (integer)

Максимальное количество vCPU, которое может поддерживать вычислительная среда.

Примечание

При использовании BEST_FIT_PROGRESSIVE , ``SPOT_CAPACITY_OPTIMIZED`` и SPOT_PRICE_CAPACITY_OPTIMIZED (рекомендуемая) стратегии с использованием On-Demand или Spot Instances, а также стратегии BEST_FIT с использованием Spot Instances, Batch может потребоваться превысить maxvCpus для удовлетворения ваших потребностей в емкости. В этом случае Batch никогда не превышает maxvCpus более чем на один экземпляр.

desiredvCpus -> (integer)

Желаемое количество vCPU в вычислительной среде. Batch изменяет это значение между минимальным и максимальным значениями в зависимости от спроса на очередь задач.

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

instanceTypes -> (list)

Типы экземпляров, которые можно запустить. Вы можете указать семейства экземпляров для запуска любого типа экземпляра в этих семействах (например, c5 или p3 ), или вы можете указать конкретные размеры в рамках семейства (например, c5.8xlarge ). Вы также можете выбрать optimal для выбора типов экземпляров (из семейств экземпляров C4, M4 и R4), которые соответствуют запросам ваших очередей задач.

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

Примечание

При создании вычислительной среды типы экземпляров, которые вы выбираете для вычислительной среды, должны иметь одинаковую архитектуру. Например, вы не можете смешивать x86 и ARM-экземпляры в одной вычислительной среде.

Примечание

В настоящее время optimal использует типы экземпляров из семейств C4, M4 и R4. В регионах, в которых нет типов экземпляров из этих семейств, используются типы экземпляров из семейств C5, M5 и R5.

(string)

imageId -> (string)

Идентификатор Amazon Machine Image (AMI), используемый для экземпляров, запущенных в вычислительной среде. Этот параметр переопределяется элементом imageIdOverride структуры Ec2Configuration .

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

Примечание

AMI, который вы выбираете для вычислительной среды, должен соответствовать архитектуре типов экземпляров, которые вы планируете использовать для этой вычислительной среды. Например, если ваша вычислительная среда использует типы экземпляров A1, AMI вычислительного ресурса, который вы выбираете, должен поддерживать ARM-экземпляры. Amazon ECS предоставляет как x86, так и ARM-версии Amazon ECS-оптимизированного AMI Amazon Linux 2. Дополнительные сведения см. в разделе «Amazon ECS-оптимизированный AMI Amazon Linux 2» в руководстве разработчика Amazon Elastic Container Service .

subnets -> (list)

Подсети VPC, в которых запускаются вычислительные ресурсы. Эти подсети должны находиться в одной VPC. Вычислительные ресурсы Fargate могут содержать до 16 подсетей. Дополнительные сведения см. в разделе «VPC и подсети» в руководстве пользователя Amazon VPC .

Примечание

Batch на Amazon EC2 и Batch на Amazon EKS поддерживают локальные зоны. Дополнительные сведения см. в разделе «Локальные зоны» в руководстве пользователя Amazon EC2 для Linux-экземпляров, Amazon EKS и локальные зоны Amazon Web Services в руководстве пользователя Amazon EKS и кластерах Amazon ECS в локальных зонах, зонах Wavelength и в сервисах Amazon Web Services Outposts в руководстве разработчика Amazon ECS .

Batch на Fargate в настоящее время не поддерживает локальные зоны.

(string)

securityGroupIds -> (list)

Группы безопасности Amazon EC2, связанные с экземплярами, запущенными в вычислительной среде. Одна или несколько групп безопасности должны быть указаны либо в securityGroupIds , либо с использованием шаблона запуска, указанного в launchTemplate . Этот параметр требуется для задач, выполняемых на ресурсах Fargate, и должен содержать по крайней мере одну группу безопасности. Fargate не поддерживает шаблоны запуска. Если группы безопасности указаны и в securityGroupIds , и в launchTemplate , используются значения из securityGroupIds .

(string)

ec2KeyPair -> (string)

Пара EC2-ключа Amazon, используемая для экземпляров, запущенных в вычислительной среде. Вы можете использовать эту пару ключей для входа в свои экземпляры с помощью SSH.

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

instanceRole -> (string)

Профиль экземпляра Amazon ECS, применяемый к экземплярам Amazon EC2 в вычислительной среде. Этот параметр требуется для типов экземпляров Amazon EC2. Вы можете указать короткое имя или полное имя Amazon Resource Name (ARN) профиля экземпляра. Например, `` ecsInstanceRole `` или ``arn:aws:iam::<aws_account_id> :instance-profile/ecsInstanceRole `` . Дополнительные сведения см. в разделе «Роль экземпляра Amazon ECS» в руководстве пользователя Batch .

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

tags -> (map)

Теги пары ключ-значение, которые будут применены к ресурсам Amazon EC2, запущенным в вычислительной среде. Для Batch эти теги имеют вид "String1": "String2" , где String1 — ключ тега, а String2 — значение тега (например, { "Name": "Batch Instance - C4OnDemand" } ). Это полезно для распознавания ваших экземпляров Batch в консоли Amazon EC2. Обновление этих тегов требует обновления инфраструктуры вычислительной среды. Дополнительные сведения см. в разделе «Обновление вычислительных сред» в руководстве пользователя Batch . Эти теги не видны при использовании операции API Batch ListTagsForResource .

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

key -> (string)

value -> (string)

placementGroup -> (string)

Группа размещения Amazon EC2 для ассоциации с вашими вычислительными ресурсами. Если вы планируете отправить многоузловые параллельные задачи в вычислительную среду, следует рассмотреть создание группы размещения кластера и ассоциацию с вычислительными ресурсами. Это позволяет сохранять вашу многоузловую параллельную задачу в логической группе экземпляров в одной зоне доступности с высокой потенциальной скоростью сетевого трафика. Дополнительные сведения см. в разделе «Группы размещения» в руководстве пользователя Amazon EC2 для Linux-экземпляров.

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

bidPercentage -> (integer)

Максимальный процент, на который цена Spot Instance может превышать цену On-Demand для этого типа экземпляра, прежде чем будут запущены экземпляры. Например, если ваш максимальный процент составляет 20 %, то цена Spot должна быть меньше 20 % текущей цены On-Demand для этого экземпляра Amazon EC2. Вы всегда платите самую низкую (рыночную) цену и никогда не больше вашего максимального процента. Если вы оставите это поле пустым, значение по умолчанию составляет 100 % от цены On-Demand. Для большинства случаев использования рекомендуется оставить это поле пустым.

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

spotIamFleetRole -> (string)

Идентификатор ресурса Amazon (ARN) роли IAM Amazon EC2 Spot Fleet, применяемой к среде выполнения SPOT. Эта роль необходима, если стратегия распределения задана как BEST_FIT или если стратегия распределения не указана. Дополнительную информацию см. в разделе Роль Amazon EC2 spot fleet в руководстве пользователя Batch .

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

Предупреждение

Чтобы при создании метки вашей Spot Instance, роль IAM Spot Fleet, указанная здесь, должна использовать более новую управляемую политику AmazonEC2SpotFleetTaggingRole. Предыдущая рекомендованная управляемая политика AmazonEC2SpotFleetRole не имеет необходимых разрешений для маркировки Spot Instance. Дополнительную информацию см. в разделе Spot instances not tagged on creation в руководстве пользователя Batch .

launchTemplate -> (структура)

Шаблон запуска, используемый для ваших ресурсов вычислительной среды. Любые другие параметры ресурсов вычислительной среды, которые вы указываете в операции API CreateComputeEnvironment, перезаписывают те же параметры в шаблоне запуска. Вы должны указать либо идентификатор шаблона запуска, либо имя шаблона запуска в запросе, но не оба. Дополнительную информацию см. в разделе Поддержка шаблонов запуска в руководстве пользователя Batch .

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

launchTemplateId -> (строка)

Идентификатор шаблона запуска.

launchTemplateName -> (строка)

Имя шаблона запуска.

version -> (строка)

Номер версии шаблона запуска, $Default , или $Latest .

Если значение равно $Default , используется версия шаблона запуска по умолчанию. Если значение равно $Latest , используется последняя версия шаблона запуска.

Предупреждение

Если идентификатор AMI, используемый в среде выполнения, получен из шаблона запуска, AMI не изменяется при обновлении среды выполнения. Он изменяется только в том случае, если параметр updateToLatestImageVersion для среды выполнения установлен на true . Во время обновления инфраструктуры, если указаны либо $Default , либо $Latest , Batch повторно оценивает версию шаблона запуска, и может использовать другую версию шаблона запуска. Это происходит даже в том случае, если шаблон запуска не указан в обновлении. При обновлении среды выполнения изменение шаблона запуска требует обновления инфраструктуры среды выполнения. Дополнительную информацию см. в разделе Обновление сред выполнения в руководстве пользователя Batch .

По умолчанию: $Default

Последняя: $Latest

overrides -> (список)

Шаблон запуска, используемый вместо шаблона запуска по умолчанию. Вы должны указать либо идентификатор шаблона запуска, либо имя шаблона запуска в запросе, но не оба.

Вы можете указать до десяти (10) наложений шаблонов запуска, связанных с уникальными типами или семействами экземпляров для каждой среды выполнения.

Примечание

Чтобы сбросить все наложения шаблонов для среды выполнения, вы можете передать пустой массив в параметр UpdateComputeEnvironment.overrides или не включать параметр overrides при отправке операции API UpdateComputeEnvironment.

(структура)

Объект, представляющий шаблон запуска, используемый вместо шаблона запуска по умолчанию. Вы должны указать либо идентификатор шаблона запуска, либо имя шаблона запуска в запросе, но не оба.

Если группы безопасности указаны как с помощью параметра securityGroupIds операции CreateComputeEnvironment, так и в шаблоне запуска, будут использоваться значения параметра securityGroupIds операции CreateComputeEnvironment.

Вы можете определить до десяти (10) наложений для каждой среды выполнения.

Примечание

Этот объект не применим к задачам, выполняющимся на ресурсах Fargate.

Примечание

launchTemplateId -> (строка)

Идентификатор шаблона запуска.

Примечание: Если вы указываете launchTemplateId, вы не можете указать launchTemplateName.

launchTemplateName -> (строка)

Имя шаблона запуска.

Примечание: Если вы указываете launchTemplateName, вы не можете указать launchTemplateId.

version -> (строка)

Номер версии шаблона запуска, $Default , или $Latest .

Предупреждение

По умолчанию: $Default

Последняя: $Latest

targetInstanceTypes -> (список)

Тип или семейство экземпляров, к которым должно применяться этот наложение шаблона запуска.

Этот параметр обязателен при определении наложения шаблона запуска.

Информация, включенная в этот параметр, должна соответствовать следующим требованиям:

Должен быть допустимым типом или семейством экземпляров Amazon EC2.
optimal не разрешено.
targetInstanceTypes может направляться только на типы и семейства экземпляров, включенные в набор ` ComputeResource.instanceTypes https://docs.aws.amazon.com/batch/latest/APIReference/API_ComputeResource.html#Batch-Type-ComputeResource-instanceTypes`__ . targetInstanceTypes не обязательно должен включать все экземпляры из набора instanceType , но по крайней мере подмножество. Например, если ComputeResource.instanceTypes включает [m5, g5] , targetInstanceTypes может включать [m5.2xlarge] и [m5.large], но не [c5.large] .
targetInstanceTypes, включенные в рамках одного наложения шаблона запуска или наложений шаблонов запуска, не могут перекрываться для одной и той же среды выполнения. Например, вы не можете определить одно наложение шаблона запуска для назначения семейства экземпляров, а другое - для назначения типа экземпляра в рамках этого же семейства.

(строка)

ec2Configuration -> (список)

Предоставляет информацию, используемую для выбора образов Amazon Machine Images (AMI) для экземпляров Amazon EC2 в среде выполнения. Если Ec2Configuration не указан, по умолчанию используется ECS_AL2 .

Можно указать одно или два значения.

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

(структура)

Предоставляет информацию, используемую для выбора образов Amazon Machine Images (AMI) для экземпляров в среде выполнения. Если Ec2Configuration не указан, по умолчанию используется ECS_AL2 (Amazon Linux 2 ).

Примечание

Этот объект не применим к задачам, выполняющимся на ресурсах Fargate.

imageType -> (строка)

Тип образа, который соответствует типу экземпляра для выбора AMI. Поддерживаемые значения различаются для ресурсов ECS и EKS.

ECS

Если параметр imageIdOverride не указан, то используется недавний оптимизированный для Amazon ECS образ Amazon Linux 2 (ECS_AL2 ). Если новый тип образа указан в обновлении, но ни параметр imageId , ни параметр imageIdOverride не указаны, то используется последний оптимизированный для Amazon ECS образ AMI для этого типа образа, поддерживаемый Batch.

ECS_AL2

Amazon Linux 2 : По умолчанию для всех семейств экземпляров без графических процессоров.

ECS_AL2_NVIDIA

Amazon Linux 2 (GPU) : По умолчанию для всех семейств экземпляров с графическими процессорами (например, P4 и G4 ) и может использоваться для всех типов экземпляров без графических процессоров от Amazon Web Services.

ECS_AL2023

Amazon Linux 2023 : Batch поддерживает Amazon Linux 2023.

Примечание

Amazon Linux 2023 не поддерживает A1 экземпляры.

ECS_AL1

Amazon Linux . Amazon Linux достиг конца жизненного цикла стандартной поддержки. Дополнительную информацию см. в Amazon Linux AMI .

EKS

Если параметр imageIdOverride не указан, используется недавний образ Amazon Linux AMI, оптимизированный для Amazon EKS (EKS_AL2 ). Если новый тип образа указан в обновлении, но ни параметр imageId , ни параметр imageIdOverride не указаны, то используется последний оптимизированный для Amazon EKS образ AMI для этого типа образа, поддерживаемый Batch.

EKS_AL2

Amazon Linux 2 : По умолчанию для всех семейств экземпляров без графических процессоров.

EKS_AL2_NVIDIA

Amazon Linux 2 (ускоренный) : По умолчанию для всех семейств экземпляров с графическими процессорами (например, P4 и G4 ) и может использоваться для всех типов экземпляров без графических процессоров от Amazon Web Services.

imageIdOverride -> (строка)

Идентификатор AMI, используемый для экземпляров, запущенных в среде выполнения, которые соответствуют типу образа. Это значение перезаписывает значение imageId в объекте computeResource.

Примечание

AMI, который вы выбираете для среды выполнения, должен соответствовать архитектуре типов экземпляров, которые вы намерены использовать для этой среды выполнения. Например, если ваша среда выполнения использует типы экземпляров A1, AMI ресурса среды выполнения, который вы выбираете, должен поддерживать ARM-экземпляры. Amazon ECS предоставляет как x86, так и ARM версии оптимизированного для Amazon ECS образа Amazon Linux 2. Дополнительную информацию см. в разделе Оптимизированный для Amazon ECS образ Amazon Linux 2 в руководстве разработчика Amazon Elastic Container Service .

imageKubernetesVersion -> (строка)

Версия Kubernetes для среды выполнения. Если вы не указываете значение, используется последняя поддерживаемая Batch версия.

Синтаксис JSON:

{
  "type": "EC2"|"SPOT"|"FARGATE"|"FARGATE_SPOT",
  "allocationStrategy": "BEST_FIT"|"BEST_FIT_PROGRESSIVE"|"SPOT_CAPACITY_OPTIMIZED"|"SPOT_PRICE_CAPACITY_OPTIMIZED",
  "minvCpus": integer,
  "maxvCpus": integer,
  "desiredvCpus": integer,
  "instanceTypes": ["string", ...],
  "imageId": "string",
  "subnets": ["string", ...],
  "securityGroupIds": ["string", ...],
  "ec2KeyPair": "string",
  "instanceRole": "string",
  "tags": {"string": "string"
    ...},
  "placementGroup": "string",
  "bidPercentage": integer,
  "spotIamFleetRole": "string",
  "launchTemplate": {
    "launchTemplateId": "string",
    "launchTemplateName": "string",
    "version": "string",
    "overrides": [
      {
        "launchTemplateId": "string",
        "launchTemplateName": "string",
        "version": "string",
        "targetInstanceTypes": ["string", ...]
      }
      ...
    ]
  },
  "ec2Configuration": [
    {
      "imageType": "string",
      "imageIdOverride": "string",
      "imageKubernetesVersion": "string"
    }
    ...
  ]
}

--service-role (строка)

Полное имя Amazon Resource Name (ARN) роли IAM, которая позволяет Batch делать вызовы к другим службам Amazon Web Services от вашего имени. Дополнительную информацию см. в разделе Роль IAM службы Batch в руководстве пользователя Batch .

Предупреждение

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

Если у указанной роли есть путь, отличный от /, то вы должны указать либо полное имя ARN роли (рекомендуется), либо префикс имени роли с путем. Например, если роль с именем bar имеет путь /foo/, укажите /foo/bar как имя роли. Дополнительную информацию см. в разделе Дружественные имена и пути в Руководстве пользователя IAM .

Примечание

В зависимости от того, как вы создали роль службы Batch, ее ARN может содержать префикс пути service-role. Когда вы указываете только имя роли службы, Batch предполагает, что ваш ARN не использует префикс пути service-role. По этой причине рекомендуется указывать полное ARN вашей роли службы при создании вычислительных сред.

--tags (массив)

Теги, которые вы применяете к вычислительной среде, чтобы помочь вам категоризировать и организовывать ваши ресурсы. Каждый тег состоит из ключа и необязательного значения. Дополнительную информацию см. в разделе Присвоение тегов ресурсам Amazon Web Services в Общей справке Amazon Web Services .

Эти теги можно обновлять или удалять с помощью операций API TagResource и UntagResource. Эти теги не распространяются на базовые вычислительные ресурсы.

ключ -> (строка)

значение -> (строка)

Краткая синтаксическая конструкция:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--eks-configuration (структура)

Детали кластера Amazon EKS, поддерживающего вычислительную среду.

eksClusterArn -> (строка)

Имя Amazon Resource Name (ARN) кластера Amazon EKS. Пример: ``arn:aws :eks:us-east-1 :123456789012 :cluster/ClusterForBatch `` .

kubernetesNamespace -> (строка)

Пространство имен кластера Amazon EKS. Batch управляет поддосами в этом пространстве имен. Значение не может быть пустым или нулевым. Оно должно быть короче 64 символов, не может быть равно default, не может начинаться с “kube-” и должно соответствовать этому регулярному выражению: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$. Дополнительную информацию см. в разделе Пространства имен в документации Kubernetes.

Краткая синтаксическая конструкция:

eksClusterArn=string,kubernetesNamespace=string

Синтаксис JSON:

{
  "eksClusterArn": "string",
  "kubernetesNamespace": "string"
}

--context (строка)

Зарезервировано.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения перепишут значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводится пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, будет напечатан пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, оно валидирует входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладочную запись в журнал.

--endpoint-url (строка)

Переопределить стандартный URL команды указанным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении со службами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

json
text
таблица
yaml
yaml-потоковый

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Используемый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отображение версии этого инструмента.

--color (строка)

Включение/выключение цветного вывода.

включено
выключено
авто

--no-sign-request (булево)

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

--ca-bundle (строка)

Файл с набором сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь тайм-аута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь тайм-аута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строкой base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (булево)

Отключить пейджер командной строки для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры входных данных командной строки.

--no-cli-auto-prompt (булево)

Отключить автоматическое запроса параметров входных данных командной строки.

Примеры

Примечание

Для использования следующих примеров требуется установленный и настроенный AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.

Если не указано иное, во всех примерах используются правила цитирования, похожие на правила Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI .

Создание управляемой вычислительной среды с экземплярами On-Demand

В этом примере создается управляемая вычислительная среда со специфическими типами экземпляров C4, которые запускаются по запросу. Имя вычислительной среды — C4OnDemand.

Команда:

aws batch create-compute-environment --cli-input-json file://<path_to_json_file>/C4OnDemand.json

Формат файла JSON:

{
  "computeEnvironmentName": "C4OnDemand",
  "type": "MANAGED",
  "state": "ENABLED",
  "computeResources": {
    "type": "EC2",
    "minvCpus": 0,
    "maxvCpus": 128,
    "desiredvCpus": 48,
    "instanceTypes": [
      "c4.large",
      "c4.xlarge",
      "c4.2xlarge",
      "c4.4xlarge",
      "c4.8xlarge"
    ],
    "subnets": [
      "subnet-220c0e0a",
      "subnet-1a95556d",
      "subnet-978f6dce"
    ],
    "securityGroupIds": [
      "sg-cf5093b2"
    ],
    "ec2KeyPair": "id_rsa",
    "instanceRole": "ecsInstanceRole",
    "tags": {
      "Name": "Batch Instance - C4OnDemand"
    }
  },
  "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole"
}

Вывод:

{
    "computeEnvironmentName": "C4OnDemand",
    "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/C4OnDemand"
}

Создание управляемой вычислительной среды с экземплярами Spot

В этом примере создается управляемая вычислительная среда с типом экземпляра M4, который запускается, когда цена предложения Spot равна или ниже 20% от цены On-Demand для типа экземпляра. Имя вычислительной среды — M4Spot.

Команда:

aws batch create-compute-environment --cli-input-json file://<path_to_json_file>/M4Spot.json

Формат файла JSON:

{
  "computeEnvironmentName": "M4Spot",
  "type": "MANAGED",
  "state": "ENABLED",
  "computeResources": {
    "type": "SPOT",
    "spotIamFleetRole": "arn:aws:iam::012345678910:role/aws-ec2-spot-fleet-role",
    "minvCpus": 0,
    "maxvCpus": 128,
    "desiredvCpus": 4,
    "instanceTypes": [
      "m4"
    ],
    "bidPercentage": 20,
    "subnets": [
      "subnet-220c0e0a",
      "subnet-1a95556d",
      "subnet-978f6dce"
    ],
    "securityGroupIds": [
      "sg-cf5093b2"
    ],
    "ec2KeyPair": "id_rsa",
    "instanceRole": "ecsInstanceRole",
    "tags": {
      "Name": "Batch Instance - M4Spot"
    }
  },
  "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole"
}

Вывод:

{
    "computeEnvironmentName": "M4Spot",
    "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/M4Spot"
}

Вывод

computeEnvironmentName -> (строка)

Имя вычислительной среды. Длина может быть до 128 символов. Она может содержать прописные и строчные буквы, цифры, дефисы (-) и подчеркивания (_).

computeEnvironmentArn -> (строка)

Amazon Resource Name (ARN) вычислительной среды.