register-task-definition

Имя ресурса Amazon (ARN) секрета, содержащего учетные данные частного репозитория.

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

Если вы используете контейнеры в задаче с сетевым режимом awsvpc или host, укажите открытые порты с помощью containerPort. hostPort можно оставить пустым или он должен совпадать со значением containerPort.

Большинство полей этого параметра (containerPort, hostPort, protocol) сопоставляются с PortBindings в команде docker container create и параметром --publish для docker run. Если для сетевого режима определения задачи установлено значение host, порты хоста должны быть либо неопределенными, либо совпадать с портом контейнера в сопоставлении портов.

После того как задача достигнет состояния RUNNING, ручные и автоматические назначения портов хоста и контейнера отображаются в разделе networkBindings ответов API DescribeTasks.

containerPort -> (целое число)

hostPort -> (целое число)

protocol -> (строка)

name -> (строка)

appProtocol -> (строка)

containerPortRange -> (строка)

Если параметр essential контейнера помечен как true, и этот контейнер по какой-либо причине завершает работу или останавливается, все остальные контейнеры, входящие в задачу, останавливаются. Если параметр essential контейнера помечен как false, его сбой не влияет на остальные контейнеры в задаче. Если этот параметр опущен, предполагается, что контейнер является важным.

Все задачи должны иметь хотя бы один важный контейнер. Если у вас есть приложение, которое состоит из нескольких контейнеров, сгруппируйте контейнеры, которые используются для общей цели, в компоненты и разделите разные компоненты на несколько определений задач. Для получения дополнительной информации см. Application Architecture в Руководстве разработчика Amazon Elastic Container Service .

Список кодов выхода, которые Amazon ECS будет игнорировать и не будет пытаться перезапустить. Вы можете указать не более 50 кодов выхода контейнера. По умолчанию Amazon ECS не игнорирует никакие коды выхода.

(integer)

Объект пары ключ-значение.

name -> (string)

value -> (string)

Список файлов, содержащих переменные среды, которые будут переданы в контейнер. Вы можете указать до десяти файлов среды. Файл должен иметь расширение .env. Каждая строка в файле среды должна содержать переменную среды в формате VARIABLE=VALUE. Строки, начинающиеся с #, рассматриваются как комментарии и игнорируются.

Если есть переменные среды, указанные с использованием параметра environment в определении контейнера, они имеют приоритет над переменными, содержащимися в файле среды. Если указано несколько файлов среды, содержащих одну и ту же переменную, они обрабатываются сверху вниз. Мы рекомендуем использовать уникальные имена переменных. Для получения дополнительной информации см. Use a file to pass environment variables to a container в Руководстве разработчика Amazon Elastic Container Service.

Файлы переменных среды являются объектами в Amazon S3, и ко всем соображениям безопасности Amazon S3 применяются.

Вы должны использовать следующие платформы для типа запуска Fargate:

• Linux platform version 1.4.0 или более поздняя.
• Windows platform version 1.0.0 или более поздняя.

Учитывайте следующее при использовании типа запуска Fargate:

• Файл обрабатывается как собственный env-file Docker.
• Нет поддержки обработки escape-символов оболочки.
• Точка входа контейнера интерпретирует VARIABLE значения.

value -> (string)

type -> (string)

Подробности точки монтирования тома данных, используемой в определении контейнера.

sourceVolume -> (string)

containerPath -> (string)

readOnly -> (boolean)

Подробности о томе данных из другого контейнера в том же определении задачи.

sourceContainer -> (string)

readOnly -> (boolean)

Возможности Linux для контейнера, которые добавляются или удаляются из конфигурации по умолчанию, предоставленной Docker.

add -> (list)

drop -> (list)

Любые устройства хоста, которые необходимо предоставить контейнеру. Этот параметр отображается на Devices в команде create docker container и на опцию --device для docker run.

(structure)

Значение размера (в MiB) тома /dev/shm. Этот параметр отображается на опцию --shm-size для docker run.

Путь к контейнеру, параметры монтирования и размер (в MiB) монтирования tmpfs. Этот параметр отображается на опцию --tmpfs для docker run.

(structure)

Общий объем памяти подкачки (в MiB), который может использовать контейнер. Этот параметр будет преобразован в опцию --memory-swap для docker run, где значение будет равно сумме памяти контейнера плюс значение maxSwap.

Если указано значение maxSwap 0, контейнер не будет использовать подкачку. Допустимые значения: 0 или любое положительное целое число. Если параметр maxSwap опущен, контейнер будет использовать конфигурацию подкачки для экземпляра контейнера, на котором он работает. Необходимо установить значение maxSwap для использования параметра swappiness.

Это позволяет настроить поведение подкачки памяти контейнера. Значение swappiness 0 приведет к тому, что подкачка не будет происходить, если только это абсолютно необходимо. Значение swappiness 100 приведет к очень агрессивной подкачке страниц. Допустимыми значениями являются целые числа от 0 до 100. Если параметр swappiness не указан, используется значение по умолчанию 60. Если значение не указано для maxSwap, этот параметр игнорируется. Этот параметр отображается на опцию --memory-swappiness для docker run.

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

• Чтобы внедрить конфиденциальные данные в ваши контейнеры в качестве переменных среды, используйте параметр определения контейнера secrets.
• Чтобы сослаться на конфиденциальную информацию в конфигурации журнала контейнера, используйте параметр определения контейнера secretOptions.

Для получения дополнительной информации см. раздел Указание конфиденциальных данных в Руководстве разработчика Amazon Elastic Container Service .

name -> (string)

valueFrom -> (string)

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

Вашим экземплярам контейнеров Amazon ECS требуется как минимум версия 1.26.0 агента контейнера для использования зависимостей контейнеров. Однако мы рекомендуем использовать последнюю версию агента контейнера. Информацию о проверке версии агента и обновлении до последней версии см. в разделе Обновление агента контейнера Amazon ECS в Руководстве разработчика Amazon Elastic Container Service . Если вы используете оптимизированный для Amazon ECS дистрибутив Linux AMI, вашему экземпляру требуется как минимум версия 1.26.0-1 пакета ecs-init. Если ваши экземпляры контейнеров запускаются с версии 20190301 или более поздней, они содержат необходимые версии агента контейнера и ecs-init . Дополнительные сведения см. в разделе Оптимизированный для Amazon ECS дистрибутив Linux AMI в Руководстве разработчика Amazon Elastic Container Service .

Дополнительные сведения о создании зависимости контейнера см. в разделе Зависимость контейнера в Руководстве разработчика Amazon Elastic Container Service .

containerName -> (string)

condition -> (string)

Записи имен хостов и IP-адресов, которые добавляются в файл /etc/hosts контейнера через параметр extraHosts его ContainerDefinition.

hostname -> (string)

ipAddress -> (string)

Параметры ulimit для передачи контейнеру.

Задачи Amazon ECS, размещенные на Fargate, используют значения лимитов ресурсов по умолчанию, установленные операционной системой, за исключением параметра лимита ресурсов nofile, который Fargate переопределяет. Лимит ресурсов nofile устанавливает ограничение на количество открытых файлов, которые может использовать контейнер. Значение мягкого лимита nofile по умолчанию — 65535, а жесткого лимита — 65535.

Вы можете указать параметры ulimit для контейнера в определении задачи.

name -> (string)

softLimit -> (integer)

hardLimit -> (integer)

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

Для задач в Fargate поддерживаемыми драйверами журналов являются awslogs, splunk и awsfirelens.

Для задач, размещенных на экземплярах Amazon EC2, поддерживаемыми драйверами журналов являются awslogs, fluentd, gelf, json-file, journald, syslog, splunk и awsfirelens.

Дополнительные сведения об использовании драйвера awslogs журнала см. в разделе Отправка журналов Amazon ECS в CloudWatch в Руководстве разработчика Amazon Elastic Container Service .

Дополнительные сведения об использовании драйвера awsfirelens журнала см. в разделе Отправка журналов Amazon ECS в службу Amazon Web Services или партнера Amazon Web Services.

Параметры конфигурации для отправки в драйвер журнала.

Параметры, которые можно указать, зависят от драйвера журнала. Некоторые из параметров, которые можно указать при использовании драйвера журнала awslogs для маршрутизации журналов в Amazon CloudWatch, включают следующие:

Обязательно: Нет

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

Обязательно: Да

Укажите регион Amazon Web Services, в который драйвер журнала awslogs должен отправлять ваши журналы Docker. Вы можете отправлять все свои журналы из кластеров в разных регионах в один регион в CloudWatch Logs. Это сделано для того, чтобы они были видны в одном месте. В противном случае вы можете разделить их по регионам для большей детализации. Убедитесь, что указанная группа журналов существует в регионе, который вы указываете с помощью этого параметра.

Обязательно: Да

Убедитесь, что указана группа журналов, в которую драйвер журнала awslogs отправляет свои потоки журналов.

Обязательно: Да, при использовании Fargate. Необязательно при использовании EC2.

Используйте параметр awslogs-stream-prefix, чтобы связать поток журналов с указанным префиксом, именем контейнера и идентификатором задачи Amazon ECS, к которой принадлежит контейнер. Если вы укажете префикс с этим параметром, то поток журналов будет иметь формат prefix-name/container-name/ecs-task-id.

Если вы не укажете префикс с этим параметром, поток журналов будет назван в соответствии с идентификатором контейнера, назначенным демоном Docker на экземпляре контейнера. Поскольку сложно отследить журналы обратно к контейнеру, который их отправил, только с идентификатором контейнера Docker (который доступен только на экземпляре контейнера), мы рекомендуем указать префикс с этим параметром.

Для сервисов Amazon ECS вы можете использовать имя сервиса в качестве префикса. Это позволяет вам отслеживать потоки журналов до сервиса, к которому принадлежит контейнер, имени контейнера, который их отправил, и идентификатора задачи, к которой принадлежит контейнер.

Вы должны указать префикс потока, чтобы ваши журналы отображались на панели «Журнал» при использовании консоли Amazon ECS.

Обязательно: Нет

Этот параметр определяет шаблон начала многострочной записи в формате Python strftime. Сообщение журнала состоит из строки, соответствующей шаблону, и любых последующих строк, которые не соответствуют шаблону. Соответствующая строка является разделителем между сообщениями журнала.

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

Дополнительные сведения см. в разделе awslogs-datetime-format.

Нельзя настроить параметры awslogs-datetime-format и awslogs-multiline-pattern.

Обязательно: Нет

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

Дополнительные сведения см. в разделе awslogs-multiline-pattern.

Этот параметр игнорируется, если awslogs-datetime-format также настроен.

Нельзя настроить параметры awslogs-datetime-format и awslogs-multiline-pattern.

Следующие параметры применимы ко всем поддерживаемым драйверам журналов.

Обязательно: Нет

Допустимые значения: non-blocking | blocking

Этот параметр определяет режим доставки сообщений журнала из контейнера в драйвер журнала, указанный с помощью logDriver. Выбранный вами режим доставки влияет на доступность приложения при прерывании потока журналов из контейнера.

Если вы используете режим blocking и поток журналов прерывается, вызовы из кода контейнера для записи в потоки stdout и stderr будут блокироваться. В результате будет заблокирован поток ведения журнала приложения. Это может привести к тому, что приложение перестанет отвечать на запросы и приведет к сбою проверки работоспособности контейнера.

Если вы используете режим non-blocking, журналы контейнера вместо этого хранятся во внутреннем промежуточном буфере, настроенном с помощью параметра max-buffer-size. Это предотвращает зависание приложения при невозможности отправки журналов. Мы рекомендуем использовать этот режим, если вы хотите обеспечить доступность сервиса и согласны с некоторой потерей журналов. Дополнительные сведения см. в разделе Предотвращение потери журналов в неблокирующем режиме в драйвере журнала контейнера ``awslogs` <http://aws.amazon.com/blogs/containers/preventing-log-loss-with-non-blocking-mode-in-the-awslogs-container-log-driver/>`__ .

Вы можете установить значение по умолчанию mode для всех контейнеров в определенном регионе Amazon Web Services, используя параметр учетной записи defaultLogDriverMode. Если вы не укажете параметр mode или не настроите параметр учетной записи, Amazon ECS по умолчанию будет использовать режим blocking. Дополнительные сведения о настройке учетной записи см. в разделе Режим драйвера журнала по умолчанию в Руководстве разработчика Amazon Elastic Container Service .

Обязательно: Нет

Значение по умолчанию: 1m

При использовании режима non-blocking параметр журнала max-buffer-size управляет размером буфера, используемого для промежуточного хранения сообщений. Убедитесь, что указан достаточный размер буфера, в зависимости от вашего приложения. Когда буфер заполнится, дальнейшие журналы не могут быть сохранены. Журналы, которые не могут быть сохранены, теряются.

Чтобы маршрутизировать журналы с помощью маршрутизатора журналов splunk, необходимо указать splunk-token и splunk-url.

Когда вы используете маршрутизатор журналов awsfirelens для маршрутизации журналов в пункт назначения сети Amazon Web Services Service или Amazon Web Services Partner для хранения и анализа журналов, вы можете установить параметр log-driver-buffer-limit, чтобы ограничить количество событий, буферизированных в памяти, перед отправкой в контейнер маршрутизатора журналов. Это может помочь решить потенциальную проблему потери журналов, поскольку высокая пропускная способность может привести к нехватке памяти для буфера внутри Docker.

Другие параметры, которые можно указать при использовании awsfirelens для маршрутизации журналов, зависят от пункта назначения. При экспорте журналов в Amazon Data Firehose вы можете указать регион Amazon Web Services с помощью region и имя потока журналов с помощью delivery_stream.

При экспорте журналов в Amazon Kinesis Data Streams вы можете указать регион Amazon Web Services с помощью region и имя потока данных с помощью stream.

При экспорте журналов в Amazon OpenSearch Service вы можете указать такие параметры, как Name, Host (конечная точка OpenSearch Service без протокола), Port, Index, Type, Aws_auth, Aws_region, Suppress_Type_Name и tls. Дополнительные сведения см. в разделе Под капотом: FireLens для задач Amazon ECS.

При экспорте журналов в Amazon S3 вы можете указать сегмент, используя параметр bucket. Вы также можете указать region, total_file_size, upload_timeout и use_put_object в качестве параметров.

Для этого параметра требуется версия 1.19 API удаленного доступа Docker или выше на вашем экземпляре контейнера. Чтобы проверить версию API удаленного доступа Docker на вашем экземпляре контейнера, войдите в свой экземпляр контейнера и выполните следующую команду: sudo docker version --format '{{.Server.APIVersion}}'

key -> (string)

value -> (string)

Секреты, передаваемые в конфигурацию журнала. Для получения дополнительной информации см. раздел Указание конфиденциальных данных в Руководстве разработчика Amazon Elastic Container Service .

(структура)

Массив строк, представляющий команду, которую контейнер запускает, чтобы определить, является ли он работоспособным. Массив строк должен начинаться с CMD, чтобы непосредственно запускать аргументы команды, или CMD-SHELL, чтобы запускать команду с оболочкой по умолчанию для контейнера.

При использовании панели JSON консоли управления Amazon Web Services, интерфейса командной строки или API заключите список команд в двойные кавычки и скобки.

Не включайте двойные кавычки и скобки при использовании консоли управления Amazon Web Services.

Код выхода 0 указывает на успех, а ненулевой код выхода указывает на неудачу. Для получения дополнительной информации см. HealthCheck в команде docker container create.

(string)

Дополнительный льготный период для предоставления контейнерам времени для загрузки, прежде чем неудачные проверки работоспособности будут учитываться в максимальном количестве повторных попыток. Можно указать от 0 до 300 секунд. По умолчанию startPeriod выключен. Это значение применяется только в том случае, если указан command.

Список именованных параметров ядра для установки в контейнере. Этот параметр сопоставляется с Sysctls в команде docker container create и опцией --sysctl для docker run. Например, можно настроить параметр net.ipv4.tcp_keepalive_time для поддержания более длительных подключений.

Мы не рекомендуем указывать связанные с сетью параметры systemControls для нескольких контейнеров в одной задаче, которая также использует либо сетевой режим awsvpc, либо host. Это имеет следующие недостатки:

• Для задач, использующих сетевой режим awsvpc, включая Fargate, если вы установите systemControls для любого контейнера, он будет применен ко всем контейнерам в задаче. Если вы установите разные systemControls для нескольких контейнеров в одной задаче, контейнер, запущенный последним, определит, какие systemControls вступят в силу.
• Для задач, использующих сетевой режим host, не поддерживается пространство имен сети systemControls.

Если вы настраиваете пространство имен ресурса IPC для использования для контейнеров в задаче, к вашим системным элементам управления применяются следующие условия. Для получения дополнительной информации см. Режим IPC .

• Для задач, использующих режим IPC host, пространство имен IPC systemControls не поддерживается.
• Для задач, использующих режим IPC task, значения пространства имен IPC systemControls применяются ко всем контейнерам в задаче.

namespace -> (string)

value -> (string)

Тип и объем ресурса для назначения контейнеру. Поддерживаемые типы ресурсов — это графические процессоры и ускорители Elastic Inference. Для получения дополнительной информации см. Работа с графическими процессорами в Amazon ECS или Работа с Amazon Elastic Inference в Amazon ECS в Руководстве разработчика Amazon Elastic Container Service

value -> (string)

type -> (string)

Параметры, которые необходимо использовать при настройке маршрутизатора журналов. Это поле является необязательным и может использоваться для указания пользовательского файла конфигурации или для добавления дополнительных метаданных, таких как задача, определение задачи, кластер и сведения об экземпляре контейнера в событие журнала. Если указано, необходимо использовать синтаксис "options":{"enable-ecs-log-metadata":"true|false","config-file-type:"s3|file","config-file-value":"arn:aws:s3:::mybucket/fluent.conf|filepath"}. Для получения дополнительной информации см. Создание определения задачи, использующего конфигурацию FireLens, в Руководстве разработчика Amazon Elastic Container Service .

key -> (string)

value -> (string)

При использовании параметра host укажите sourcePath, чтобы объявить путь на экземпляре контейнера хоста, который представляется контейнеру. Если этот параметр пуст, демон Docker назначил вам путь хоста. Если параметр host содержит расположение файла sourcePath, том данных сохраняется в указанном месте на экземпляре контейнера хоста до тех пор, пока вы не удалите его вручную. Если значение sourcePath не существует на экземпляре контейнера хоста, демон Docker создает его. Если местоположение существует, содержимое папки исходного пути экспортируется.

Если вы используете тип запуска Fargate, параметр sourcePath не поддерживается.

Если это значение true, том Docker создается, если он еще не существует.

Сопоставление параметров, зависящих от драйвера Docker, которые передаются. Этот параметр соответствует DriverOpts в команде docker create-volume и параметру xxopt для docker volume create.

key -> (string)

value -> (string)

Пользовательские метаданные для добавления в том Docker. Этот параметр соответствует Labels в команде docker container create и параметру xxlabel для docker volume create.

key -> (string)

value -> (string)

Каталог в файловой системе Amazon EFS, который необходимо смонтировать в качестве корневого каталога внутри хоста. Если этот параметр опущен, будет использоваться корень тома Amazon EFS. Указание / будет иметь тот же эффект, что и опускание этого параметра.

Сведения о конфигурации авторизации для файловой системы Amazon EFS.

accessPointId -> (string)

iam -> (string)

Сведения о конфигурации авторизации для файловой системы Amazon FSx for Windows File Server.

credentialsParameter -> (string)

domain -> (string)

Изображение, используемое для запуска контейнера. Эта строка передается непосредственно демону Docker. По умолчанию доступны изображения в реестре Docker Hub. Другие репозитории указываются либо с помощью `` repository-url /image :tag `` , либо с помощью `` repository-url /image @*digest* `` . Допускается до 255 букв (прописных и строчных), цифр, дефисов, символов подчеркивания, двоеточий, точек, косых черт и знаков номера. Этот параметр сопоставляется с Image в команде создания контейнера docker и с параметром IMAGE для docker run.

• Когда запускается новая задача, агент контейнера Amazon ECS извлекает последнюю версию указанного изображения и тега для использования контейнером. Однако последующие обновления изображения репозитория не распространяются на уже запущенные задачи.
• Изображения в репозиториях Amazon ECR можно указать, используя полное registry/repository:tag или registry/repository@digest . Например, 012345678910.dkr.ecr.<region-name>.amazonaws.com/<repository-name>:latest или 012345678910.dkr.ecr.<region-name>.amazonaws.com/<repository-name>@sha256:94afd1f2e64d908bc90dbca0035a5b567EXAMPLE .
• Изображения в официальных репозиториях Docker Hub используют одно имя (например, ubuntu или mongo ).
• Изображения в других репозиториях Docker Hub указываются с именем организации (например, amazon/amazon-ecs-agent ).
• Изображения в других онлайн-репозиториях указываются далее по имени домена (например, quay.io/assemblyline/ubuntu ).

Учетные данные аутентификации частного репозитория, которые следует использовать.

credentialsParameter -> (string)

Количество единиц cpu , зарезервированных для контейнера. Этот параметр сопоставляется с CpuShares в команде создания контейнера docker и с параметром --cpu-shares для docker run.

Это поле является необязательным для задач, использующих тип запуска Fargate, и единственное требование заключается в том, чтобы общее количество ЦП, зарезервированных для всех контейнеров в задаче, было ниже значения cpu на уровне задачи.

Контейнеры Linux совместно используют незарезервированные единицы ЦП с другими контейнерами в экземпляре контейнера с тем же соотношением, что и выделенное количество. Например, если вы запускаете одноконтейнерную задачу на одноядерном типе экземпляра с указанными 512 единицами ЦП для этого контейнера, и это единственная задача, выполняемая в экземпляре контейнера, этот контейнер может использовать полный общий ресурс ЦП в размере 1024 единицы в любой момент времени. Однако, если вы запустили другую копию той же задачи в этом экземпляре контейнера, каждой задаче гарантируется минимум 512 единиц ЦП при необходимости. Более того, каждый контейнер может перейти к более высокому использованию ЦП, если другой контейнер не использует его. Если обе задачи были активны на 100% все время, они будут ограничены 512 единицами ЦП.

В экземплярах контейнеров Linux демон Docker в экземпляре контейнера использует значение ЦП для расчета относительных коэффициентов совместного использования ЦП для работающих контейнеров. Минимальное допустимое значение совместного использования ЦП, разрешенное ядром Linux, равно 2, а максимальное допустимое значение совместного использования ЦП, разрешенное ядром Linux, равно 262144. Однако параметр ЦП не является обязательным, и вы можете использовать значения ЦП ниже 2 или выше 262144 в определениях контейнеров. Для значений ЦП ниже 2 (включая null) или выше 262144 поведение варьируется в зависимости от версии агента контейнера Amazon ECS:

• Версии агентов, не превышающие 1.1.0: Нулевые и нулевые значения ЦП передаются Docker как 0, которое Docker затем преобразует в 1024 доли ЦП. Значения ЦП, равные 1, передаются Docker как 1, которое ядро Linux преобразует в две доли ЦП.
• Версии агентов, превышающие 1.2.0: Нулевые, нулевые и значения ЦП, равные 1, передаются Docker как 2.
• Версии агентов, превышающие 1.84.0: Значения ЦП, превышающие 256 vCPU, передаются Docker как 256, что эквивалентно 262144 долям ЦП.

В экземплярах контейнеров Windows ограничение ЦП применяется как абсолютный предел или квота. Контейнеры Windows имеют доступ только к указанному объему ЦП, описанному в определении задачи. Нулевое или нулевое значение ЦП передается Docker как 0 , который Windows интерпретирует как 1% от одного ЦП.

Объем (в МиБ) памяти, который необходимо предоставить контейнеру. Если ваш контейнер пытается превысить указанную здесь память, контейнер уничтожается. Общий объем памяти, зарезервированной для всех контейнеров в задаче, должен быть меньше значения memory задачи, если оно указано. Этот параметр сопоставляется с Memory в команде создания контейнера docker и с параметром --memory для docker run.

При использовании типа запуска Fargate этот параметр является необязательным.

При использовании типа запуска EC2 необходимо указать либо значение памяти на уровне задачи, либо значение памяти на уровне контейнера. Если вы укажете и значение memory на уровне контейнера, и значение memoryReservation , то memory должно быть больше memoryReservation . Если вы укажете memoryReservation , то это значение вычитается из доступных ресурсов памяти для экземпляра контейнера, где размещен контейнер. В противном случае используется значение memory .

Демон Docker 20.10.0 или более поздней версии резервирует не менее 6 МиБ памяти для контейнера. Поэтому не указывайте менее 6 МиБ памяти для своих контейнеров.

Демон Docker 19.03.13-ce или более ранней версии резервирует не менее 4 МиБ памяти для контейнера. Поэтому не указывайте менее 4 МиБ памяти для своих контейнеров.

Мягкое ограничение (в МиБ) памяти, которую необходимо зарезервировать для контейнера. Когда системная память сильно оспаривается, Docker пытается поддерживать память контейнера на этом мягком ограничении. Однако ваш контейнер может потреблять больше памяти, когда это необходимо, вплоть до жесткого ограничения, указанного с помощью параметра memory (если применимо), или всей доступной памяти в экземпляре контейнера, в зависимости от того, что произойдет раньше. Этот параметр сопоставляется с MemoryReservation в команде создания контейнера docker и с параметром --memory-reservation для docker run.

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

Например, если ваш контейнер обычно использует 128 МиБ памяти, но иногда может потреблять до 256 МиБ памяти в течение коротких периодов времени, вы можете установить значение memoryReservation равным 128 МиБ и жесткое ограничение memory 300 МиБ. Эта конфигурация позволит контейнеру резервировать только 128 МиБ памяти из оставшихся ресурсов в экземпляре контейнера, но также позволит контейнеру потреблять больше ресурсов памяти при необходимости.

Демон Docker 20.10.0 или более поздней версии резервирует не менее 6 МиБ памяти для контейнера. Поэтому не указывайте менее 6 МиБ памяти для своих контейнеров.

Демон Docker 19.03.13-ce или более ранней версии резервирует не менее 4 МиБ памяти для контейнера. Поэтому не указывайте менее 4 МиБ памяти для своих контейнеров.

Параметр links позволяет контейнерам обмениваться данными друг с другом без необходимости сопоставления портов. Этот параметр поддерживается, только если сетевой режим определения задачи — bridge . Конструкция name:internalName аналогична name:alias в ссылках Docker. Допускается до 255 букв (прописных и строчных), цифр, символов подчеркивания и дефисов. Этот параметр сопоставляется с Links в команде создания контейнера docker и с параметром --link для docker run.

(string)

Список отображений портов для контейнера. Отображения портов позволяют контейнерам получать доступ к портам в экземпляре контейнера хоста для отправки или получения трафика.

Для определений задач, использующих сетевой режим awsvpc, укажите только containerPort. hostPort можно оставить пустым или оно должно быть таким же значением, как и containerPort.

Отображения портов в Windows используют адрес шлюза NetNAT, а не localhost. Нет петли для отображений портов в Windows, поэтому вы не можете получить доступ к сопоставленному порту контейнера из самого хоста.

Этот параметр сопоставляется с PortBindings в команде создания контейнера docker и опцией --publish для запуска docker. Если для сетевого режима определения задачи установлено значение none, то вы не можете указать отображения портов. Если для сетевого режима определения задачи установлено значение host, то порты хоста должны быть либо неопределены, либо они должны соответствовать порту контейнера в отображении порта.

(структура)

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

Все задачи должны иметь хотя бы один важный контейнер. Если у вас есть приложение, состоящее из нескольких контейнеров, сгруппируйте контейнеры, которые используются для общей цели, в компоненты и разделите разные компоненты на несколько определений задач. Для получения дополнительной информации см. Application Architecture в Руководстве разработчика Amazon Elastic Container Service.

Политика перезапуска для контейнера. При настройке политики перезапуска Amazon ECS может перезапустить контейнер без необходимости замены задачи. Дополнительные сведения см. в разделе Restart individual containers in Amazon ECS tasks with container restart policies в Руководстве разработчика Amazon Elastic Container Service.

enabled -> (boolean)

ignoredExitCodes -> (list)

restartAttemptPeriod -> (integer)

Точка входа, которая передается в контейнер. Этот параметр соответствует Entrypoint в команде создания контейнера docker и параметру --entrypoint в docker run.

(string)

Команда, которая передается в контейнер. Этот параметр соответствует Cmd в команде создания контейнера docker и параметру COMMAND в docker run. Если имеется несколько аргументов, каждый аргумент представляет собой отдельную строку в массиве.

(string)

Переменные среды, которые нужно передать контейнеру. Этот параметр соответствует Env в команде создания контейнера docker и параметру --env в docker run.

(structure)

Список файлов, содержащих переменные среды, которые нужно передать контейнеру. Этот параметр соответствует параметру --env-file в docker run.

Можно указать до десяти файлов среды. Файл должен иметь расширение .env . Каждая строка в файле среды содержит переменную среды в формате VARIABLE=VALUE . Строки, начинающиеся с # , рассматриваются как комментарии и игнорируются.

Если переменные среды указаны с использованием параметра environment в определении контейнера, они имеют приоритет над переменными, содержащимися в файле среды. Если указано несколько файлов среды, которые содержат одну и ту же переменную, они обрабатываются сверху вниз. Мы рекомендуем использовать уникальные имена переменных. Дополнительные сведения см. в разделе Specifying Environment Variables в Руководстве разработчика Amazon Elastic Container Service.

(structure)

Точки монтирования для томов данных в вашем контейнере.

Этот параметр соответствует Volumes в команде создания контейнера docker и параметру --volume в docker run.

Контейнеры Windows могут монтировать целые каталоги на том же диске, что и $env:ProgramData . Контейнеры Windows не могут монтировать каталоги на другом диске, и точка монтирования не может быть между дисками.

(structure)

Тома данных для монтирования из другого контейнера. Этот параметр соответствует VolumesFrom в команде создания контейнера docker и параметру --volumes-from в docker run.

(structure)

Возможности Linux для контейнера, которые добавлены или удалены из конфигурации по умолчанию, предоставляемой Docker.

add -> (list)

drop -> (list)

Любые устройства хоста, которые необходимо предоставить контейнеру. Этот параметр соответствует Devices в команде создания контейнера docker и опции --device для docker run.

(структура)

Значение размера (в МиБ) тома /dev/shm. Этот параметр соответствует опции --shm-size для docker run.

Путь к контейнеру, параметры монтирования и размер (в МиБ) монтирования tmpfs. Этот параметр соответствует опции --tmpfs для docker run.

(структура)

Общий объем памяти подкачки (в МиБ), который может использовать контейнер. Этот параметр будет преобразован в опцию --memory-swap для docker run, где значение будет суммой памяти контейнера плюс значение maxSwap.

Если указано значение maxSwap 0, контейнер не будет использовать подкачку. Допустимые значения: 0 или любое положительное целое число. Если параметр maxSwap опущен, контейнер будет использовать конфигурацию подкачки для экземпляра контейнера, на котором он работает. Значение maxSwap должно быть установлено для использования параметра swappiness.

Это позволяет настроить поведение подкачки памяти контейнера. Значение swappiness 0 приведет к тому, что подкачка не произойдет, если это абсолютно необходимо. Значение swappiness 100 приведет к очень агрессивной подкачке страниц. Допустимые значения — целые числа от 0 до 100. Если параметр swappiness не указан, используется значение по умолчанию 60. Если значение не указано для maxSwap, этот параметр игнорируется. Этот параметр соответствует опции --memory-swappiness для docker run.

Объект, представляющий секрет для предоставления вашему контейнеру. Секреты могут быть предоставлены контейнеру следующими способами:

• Чтобы внедрить конфиденциальные данные в ваши контейнеры в качестве переменных среды, используйте параметр определения контейнера secrets.
• Чтобы сослаться на конфиденциальную информацию в конфигурации журнала контейнера, используйте параметр определения контейнера secretOptions.

Для получения дополнительной информации см. раздел «Указание конфиденциальных данных» в Руководстве разработчика Amazon Elastic Container Service.

name -> (string)

valueFrom -> (string)

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

Для задач, использующих тип запуска EC2, экземпляры контейнеров требуют как минимум версию 1.26.0 агента контейнера, чтобы включить зависимости контейнеров. Однако мы рекомендуем использовать последнюю версию агента контейнера. Информацию о проверке версии агента и обновлении до последней версии см. в разделе Обновление агента контейнера Amazon ECS в Руководстве разработчика Amazon Elastic Container Service. Если вы используете оптимизированный для Amazon ECS дистрибутив Linux AMI, вашему экземпляру потребуется как минимум версия 1.26.0-1 пакета ecs-init. Если ваши экземпляры контейнеров запускаются с версии 20190301 или более поздней, то они содержат необходимые версии агента контейнера и ecs-init . Для получения дополнительной информации см. раздел Amazon ECS-optimized Linux AMI в Руководстве разработчика Amazon Elastic Container Service.

Для задач, использующих тип запуска Fargate, задача или сервис требует следующих платформ:

• Версия платформы Linux 1.3.0 или более поздняя.
• Версия платформы Windows 1.0.0 или более поздняя.

(структура)

startTimeout -> (integer)

stopTimeout -> (integer)

versionConsistency -> (string)

hostname -> (string)

user -> (string)

workingDirectory -> (string)

disableNetworking -> (boolean)

privileged -> (boolean)

readonlyRootFilesystem -> (boolean)

dnsServers -> (list)

Список DNS-серверов, представленных контейнеру. Этот параметр сопоставляется с Dns в команде создания контейнера docker и опцией --dns для docker run.

(string)

Список доменов поиска DNS, представленных контейнеру. Этот параметр сопоставляется с DnsSearch в команде создания контейнера docker и опцией --dns-search для docker run.

(string)

Список имен хостов и сопоставлений IP-адресов для добавления в файл /etc/hosts в контейнере. Этот параметр сопоставляется с ExtraHosts в команде создания контейнера docker и опцией --add-host для docker run.

(structure)

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

Для задач Linux в EC2 этот параметр можно использовать для ссылки на пользовательские метки для систем безопасности SELinux и AppArmor multi-level.

Для любых задач в EC2 этот параметр можно использовать для ссылки на файл спецификации учетных данных, который настраивает контейнер для аутентификации Active Directory. Для получения дополнительной информации см. раздел Using gMSAs for Windows Containers and Using gMSAs for Linux Containers в Руководстве разработчика Amazon Elastic Container Service .

Этот параметр сопоставляется с SecurityOpt в команде создания контейнера docker и опцией --security-opt для docker run.

Допустимые значения: “no-new-privileges” | “apparmor:PROFILE” | “label:value” | “credentialspec:CredentialSpecFilePath”

(string)

Сопоставление пар «ключ-значение» меток для добавления в контейнер. Этот параметр сопоставляется с Labels в команде создания контейнера docker и опцией --label для docker run. Этот параметр требует версию 1.18 Docker Remote API или выше в экземпляре контейнера. Чтобы проверить версию Docker Remote API в экземпляре контейнера, войдите в экземпляр контейнера и выполните следующую команду: sudo docker version --format '{{.Server.APIVersion}}'

key -> (string)

value -> (string)

Список ulimits для установки в контейнере. Если значение ulimit указано в определении задачи, оно переопределяет значения по умолчанию, установленные Docker. Этот параметр сопоставляется с Ulimits в команде создания контейнера docker и опцией --ulimit для docker run. Допустимые значения имен отображаются в типе данных Ulimit.

Задачи Amazon ECS, размещенные на Fargate, используют значения лимитов ресурсов по умолчанию, установленные операционной системой, за исключением параметра лимита ресурсов nofile, который Fargate переопределяет. Лимит ресурсов nofile устанавливает ограничение на количество открытых файлов, которые может использовать контейнер. Значение по умолчанию nofile мягкого лимита равно 65535, а значение по умолчанию жесткого лимита равно 65535.

Этот параметр требует версию 1.18 Docker Remote API или выше в экземпляре контейнера. Чтобы проверить версию Docker Remote API в экземпляре контейнера, войдите в экземпляр контейнера и выполните следующую команду: sudo docker version --format '{{.Server.APIVersion}}'

(structure)

Спецификация конфигурации журнала для контейнера.

Этот параметр отображается на LogConfig в команде создания контейнера Docker и опции --log-driver для docker run. По умолчанию контейнеры используют тот же драйвер ведения журнала, который использует демон Docker. Однако контейнер может использовать другой драйвер ведения журнала, чем демон Docker, указав драйвер журнала с этим параметром в определении контейнера. Чтобы использовать другой драйвер ведения журнала для контейнера, система ведения журнала должна быть правильно настроена в экземпляре контейнера (или на другом сервере журналов для параметров удаленного ведения журнала).

Этот параметр требует версию 1.18 удаленного API Docker или более позднюю версию в вашем экземпляре контейнера. Чтобы проверить версию удаленного API Docker в вашем экземпляре контейнера, войдите в свой экземпляр контейнера и выполните следующую команду: sudo docker version --format '{{.Server.APIVersion}}'

logDriver -> (string)

options -> (map)

secretOptions -> (list)

Секреты для передачи в конфигурацию журнала. Для получения дополнительной информации см. раздел Указание конфиденциальных данных в Руководстве разработчика Amazon Elastic Container Service .

(структура)

Строковый массив, представляющий команду, которую контейнер выполняет для определения его работоспособности. Строковый массив должен начинаться с CMD , чтобы выполнить аргументы команды напрямую, или CMD-SHELL , чтобы выполнить команду с оболочкой по умолчанию контейнера.

При использовании панели JSON консоли управления Amazon Web Services, интерфейса командной строки или API заключите список команд в двойные кавычки и скобки.

Вы не включаете двойные кавычки и скобки при использовании консоли управления Amazon Web Services.

Код выхода 0 указывает на успех, а ненулевой код выхода указывает на сбой. Для получения дополнительной информации см. HealthCheck в команде создания контейнера docker.

(string)

Необязательный льготный период, чтобы предоставить контейнерам время для загрузки перед тем, как неудачные проверки работоспособности будут учитываться в максимальном количестве повторных попыток. Можно указать от 0 до 300 секунд. По умолчанию startPeriod выключен. Это значение применяется только при указании command .

Список имен параметров ядра для настройки в контейнере. Этот параметр соответствует Sysctls в команде создания контейнера docker и параметру --sysctl docker run. Например, можно настроить настройку net.ipv4.tcp_keepalive_time для поддержания более длительных соединений.

Мы не рекомендуем указывать параметры systemControls, связанные с сетью, для нескольких контейнеров в одной задаче, которая также использует сетевой режим awsvpc или host. Это имеет следующие недостатки:

• Для задач, использующих сетевой режим awsvpc, включая Fargate, если вы установите systemControls для любого контейнера, он применяется ко всем контейнерам в задаче. Если вы установите разные systemControls для нескольких контейнеров в одной задаче, контейнер, который запускается последним, определяет, какие systemControls вступают в силу.
• Для задач, использующих сетевой режим host, не поддерживаются пространства имен сети systemControls.

Если вы настраиваете пространство имен ресурса IPC для использования контейнерами в задаче, к вашим элементам управления системой применяются следующие условия. Дополнительные сведения см. в разделе Режим IPC .

• Для задач, использующих режим IPC host, не поддерживаются пространства имен IPC systemControls.
• Для задач, использующих режим IPC task, значения пространств имен IPC systemControls применяются ко всем контейнерам в задаче.

namespace -> (string)

value -> (string)

Тип и количество ресурса, назначаемого контейнеру. Поддерживаемые типы ресурсов — GPU и ускорители Elastic Inference. Дополнительные сведения см. в разделе Работа с GPU в Amazon ECS или Работа с Amazon Elastic Inference в Amazon ECS в Руководстве разработчика Amazon Elastic Container Service

value -> (string)

type -> (string)

Параметры, которые следует использовать при настройке маршрутизатора журналов. Это поле является необязательным и может использоваться для указания пользовательского файла конфигурации или для добавления дополнительных метаданных, таких как задача, определение задачи, кластер и сведения об экземпляре контейнера в событие журнала. При указании используйте синтаксис "options":{"enable-ecs-log-metadata":"true|false","config-file-type:"s3|file","config-file-value":"arn:aws:s3:::mybucket/fluent.conf|filepath"} . Дополнительные сведения см. в разделе Создание определения задачи, использующего конфигурацию FireLens, в Руководстве разработчика Amazon Elastic Container Service .

key -> (string)

value -> (string)

Имя тома. Допускается до 255 букв (прописных и строчных), цифр, подчеркиваний и дефисов.

При использовании тома, настроенного при запуске, name является обязательным и также должно быть указано в качестве имени тома в параметре ServiceVolumeConfiguration или TaskVolumeConfiguration при создании сервиса или отдельной задачи.

Для всех других типов томов это имя указывается в параметре sourceVolume объекта mountPoints в определении контейнера.

Когда том использует efsVolumeConfiguration, имя является обязательным.

Этот параметр указывается при использовании томов хоста с привязкой к точке монтирования. Содержимое параметра host определяет, сохраняется ли том хоста с привязкой к точке монтирования в экземпляре контейнера хоста и где он хранится. Если параметр host пуст, демон Docker назначает путь хоста для вашего тома данных. Однако не гарантируется, что данные будут сохранены после завершения работы контейнеров, связанных с ним.

Контейнеры Windows могут монтировать целые каталоги на том же диске, что и $env:ProgramData. Контейнеры Windows не могут монтировать каталоги на другом диске, и точка монтирования не может находиться на разных дисках. Например, можно смонтировать C:\my\path:C:\my\path и D:\:D:\, но не D:\my\path:C:\my\path или D:\:C:\my\path.

sourcePath -> (string)

Этот параметр указывается при использовании томов Docker.

Контейнеры Windows поддерживают только использование драйвера local. Чтобы использовать точки монтирования, укажите вместо этого параметр host.

scope -> (string)

autoprovision -> (boolean)

driver -> (string)

driverOpts -> (map)

labels -> (map)

Этот параметр указывается при использовании файловой системы Amazon Elastic File System для хранения задач.

fileSystemId -> (string)

rootDirectory -> (string)

transitEncryption -> (string)

transitEncryptionPort -> (integer)

authorizationConfig -> (structure)

Этот параметр указывается при использовании файловой системы Amazon FSx for Windows File Server для хранения задач.

fileSystemId -> (string)

rootDirectory -> (string)

authorizationConfig -> (structure)

Указывает, следует ли настраивать том во время запуска. Это используется для создания томов Amazon EBS для отдельных задач или задач, созданных в рамках сервиса. Каждая редакция определения задачи может иметь только один том, настроенный при запуске в конфигурации тома.

Чтобы настроить том во время запуска, используйте эту редакцию определения задачи и укажите объект volumeConfigurations при вызове API CreateService, UpdateService, RunTask или StartTask.

Объект пары "ключ-значение".

name -> (string)

value -> (string)