Família Tipos de inicialização Função da tarefa Função de execução de tarefas Modo de rede Plataforma de runtime Tamanho da tarefa Definições de contêiner Nome do acelerador de inferência elástica Limitações de posicionamento de tarefa Configuração do proxy Volumes Tags Outros parâmetros de definição de tarefa

Parâmetros de definição de tarefa

As definições de tarefas são divididas em partes separadas: a família de tarefas, a função da tarefa AWS Identity and Access Management (IAM), o modo de rede, as definições de contêiner, os volumes, as restrições de posicionamento da tarefa e os tipos de lançamento. As definições de família e de contêiner são obrigatórias em uma definição de tarefa. Por outro lado, a função de tarefa, o modo da rede, volumes, restrições de posicionamento de tarefa e o tipo de inicialização são opcionais.

É possível usar esses parâmetros em um arquivo JSON para configurar sua definição de tarefa. Para ter mais informações, consulte Exemplo de definições de tarefas de opções de log.

Veja a seguir as descrições mais detalhadas de cada parâmetro de definição de tarefa.

Família

family

Tipo: sequência

Obrigatório: Sim

Ao registrar uma definição de tarefa, você dá a ela uma família, semelhante a um nome para várias versões da definição de tarefa, especificada com um número de revisão. A primeira definição de tarefa registrada em uma determinada família recebe uma revisão 1, e todas as definições de tarefa registradas depois receberão um número de revisão sequencial.

Tipos de inicialização

Ao registrar uma definição de tarefa, você pode especificar um tipo de inicialização em relação à qual o Amazon ECS deve validar a definição de tarefa. Se a definição de tarefa não for validada em relação às compatibilidades especificadas, uma exceção de cliente será retornada. Para ter mais informações, consulte Tipos de inicialização do Amazon ECS.

O seguinte parâmetro é permitido em uma definição de tarefa.

requiresCompatibilities

Tipo: Matriz de strings

Obrigatório: Não

Valores válidos: EC2 | FARGATE | EXTERNAL

O tipo de inicialização em relação à qual a definição de tarefa é validada. Isso inicia uma verificação para garantir que todos os parâmetros usados na definição de tarefa atendam aos requisitos do tipo de inicialização.

Função da tarefa

taskRoleArn

Tipo: string

Obrigatório: não

Ao registrar uma definição de tarefa, você pode fornecer uma função de tarefa para uma função do IAM que permita que os contêineres da permissão de tarefa chame as APIs da AWS especificadas nas políticas associadas em seu nome. Para ter mais informações, consulte Função do IAM de tarefa.

Quando você inicia a AMI do Windows Server otimizada para o Amazon ECS, os perfis do IAM para tarefas no Windows exigem que a opção -EnableTaskIAMRole seja definida. Seus contêineres também devem executar algum código de configuração para usar o recurso. Para ter mais informações, consulte Configuração adicional para funções do IAM do Windows para tarefas.

Função de execução de tarefas

executionRoleArn

Tipo: string

Obrigatório: Condicional

O Amazon Resource Name (ARN) da função de execução de tarefas que concede ao agente de contêiner do Amazon ECS permissão para fazer chamadas de AWS API em seu nome.

nota

A função do IAM para execução da tarefa é necessária dependendo dos requisitos da sua tarefa. Para ter mais informações, consulte Função do IAM de execução de tarefas do Amazon ECS.

Modo de rede

networkMode

Tipo: string

Obrigatório: não

O modo de rede do Docker a ser usado para os contêineres na tarefa. Para tarefas do Amazon ECS hospedadas em instâncias do Linux do Amazon EC2, os valores válidos são none, bridge, awsvpc e host. Se nenhum modo de rede for especificado, o modo de rede padrão será bridge. Para tarefas do Amazon ECS hospedadas em instâncias do Windows do Amazon EC2, os valores válidos são default e awsvpc. Se nenhum modo de rede for especificado, o modo de rede defaultserá usado. Para tarefas do Amazon ECS hospedadas no Fargate, awsvpc o modo de rede é necessário.

Caso o modo de rede estiver definido como none, os contêineres da tarefa não terão conectividade externa e os mapeamentos de porta não poderão ser especificados na definição de contêiner.

Se o modo da rede for bridge, a tarefa usará a rede virtual integrada do Docker no Linux, que é executada em cada instância do Amazon EC2 que hospeda a tarefa. A rede virtual integrada no Linux usa o driver de rede bridge do Docker.

Se o modo de rede for host, a tarefa usará a rede do host que ignora a rede virtual integrada do Docker mapeando as portas de contêiner diretamente para a ENI da instância do Amazon EC2 que hospeda a tarefa. Os mapeamentos dinâmicos de portas não podem ser usados nesse modo de rede. Um contêiner em uma definição de tarefa que use esse modo deve especificar um número de hostPort específico. Um número de porta em um host não pode ser usado por várias tarefas. Como resultado, não é possível executar várias tarefas da mesma definição de tarefa em uma única instância do Amazon EC2.

Importante

Ao executar tarefas que usam o modo de rede host, não execute contêineres usando o usuário raiz (UID 0) para melhor segurança. Como uma prática recomendada de segurança, sempre utilize um usuário não raiz.

Para os tipos de execução do Amazon EC2, se o modo de rede forawsvpc, a tarefa será alocada em uma interface de rede elástica, e você deverá especificar uma NetworkConfiguration ao criar um serviço ou executar uma tarefa com a definição da tarefa. Para ter mais informações, consulte Rede de tarefas para tarefas em instâncias do Amazon EC2.

Se o modo da rede for default, a tarefa usará a rede virtual integrada do Docker no Windows, que é executada em cada instância do Amazon EC2 que hospeda a tarefa. A rede virtual integrada no Windows usa o driver de rede nat do Docker.

Para os tipos de inicialização do Fargate, quando o modo de rede estáawsvpc, a tarefa é alocada em uma interface de rede elástica, e você deve especificar uma NetworkConfiguration ao criar um serviço ou executar uma tarefa com a definição da tarefa. Para obter mais informações, consulte Fargate Task Networking. O modo de rede awsvpc oferece a melhor performance de rede para contêineres, pois usa a pilha de rede do Amazon EC2. As portas do contêiner expostas são mapeadas diretamente para a porta da interface de rede elástica conectada. Por causa disso, não é possível usar mapeamentos dinâmicos de portas de host.

Os modos de rede host e awsvpc oferecem a melhor performance de rede para contêineres, pois usam a pilha de rede do Amazon EC2. Com os modos de rede host e awsvpc, as portas do contêiner expostas são mapeadas diretamente para a porta do host correspondente (para o modo de rede do host) ou para a porta de interface de rede elástica anexada (para o modo de rede awsvpc). Por causa disso, não é possível usar mapeamentos dinâmicos de portas de host.

Se você estiver usando o tipo de inicialização do Fargate, será necessário o modo de rede awsvpc. Se você estiver usando o tipo de inicialização do EC2, o modo de rede permitido depende do sistema operacional da instância do EC2 subjacente. Se for o Linux, qualquer modo de rede pode ser usado. Se for o Windows, podem ser usados os modos default e awsvpc.

Plataforma de runtime

operatingSystemFamily

Tipo: string

Obrigatório: Condicional

Padrão: LINUX

Esse parâmetro é necessário para tarefas do Amazon ECS hospedadas no Fargate.

Ao registrar uma definição de tarefa, você especifica a família do sistema operacional.

Os valores válidos para tarefas do Amazon ECS hospedadas no Fargate são LINUX, WINDOWS_SERVER_2019_FULL, WINDOWS_SERVER_2019_CORE, WINDOWS_SERVER_2022_FULL e WINDOWS_SERVER_2022_CORE.

Os valores válidos para tarefas do Amazon ECS hospedadas no EC2 são LINUX, WINDOWS_SERVER_2022_CORE, WINDOWS_SERVER_2022_FULL, WINDOWS_SERVER_2019_FULL e WINDOWS_SERVER_2019_CORE, WINDOWS_SERVER_2016_FULL, WINDOWS_SERVER_2004_CORE e WINDOWS_SERVER_20H2_CORE.

Todas as definições de tarefa usadas em um serviço devem ter o mesmo valor para esse parâmetro.

Quando uma definição de tarefa faz parte de um serviço, esse valor deve corresponder ao valor platformFamily do serviço.

cpuArchitecture

Tipo: string

Obrigatório: Condicional

Padrão: X86_64

Esse parâmetro é necessário para tarefas do Amazon ECS hospedadas no Fargate. Se o parâmetro for deixado como null, o valor padrão é atribuído automaticamente ao iniciar uma tarefa hospedada no Fargate.

Ao registrar uma definição de tarefa, você especifica a arquitetura da CPU. Os valores válidos são X86_64 e ARM64.

Todas as definições de tarefa usadas em um serviço devem ter o mesmo valor para esse parâmetro.

Quando você tem tarefas do Linux para o tipo de inicialização do Fargate ou para o tipo de inicialização do EC2, você pode definir o valor como ARM64. Para ter mais informações, consulte Trabalhar com workloads ARM de 64 bits no Amazon ECS.

Tamanho da tarefa

Ao registrar uma definição de tarefa, você pode especificar o total de CPU e memória usados para a tarefa. Isso é separado dos valores de cpu e memory no nível de definição de contêiner. Para tarefas hospedadas em instâncias do Amazon EC2, esses campos são opcionais. Para tarefas hospedadas no Fargate (tanto de Linux quanto de Windows), esses campos são obrigatórios e existem valores específicos para cpu e memory com suporte.

nota

Os parâmetros de CPU e memória em nível de tarefa são ignorados para contêineres do Windows. É recomendável especificar recursos em nível de contêiner para contêineres do Windows.

O seguinte parâmetro é permitido em uma definição de tarefa:

cpu

Tipo: string

Obrigatório: Condicional

nota

Este parâmetro não é compatível com contêineres do Windows.

O limite rígido de unidades de CPU a ser apresentado para a tarefa. Ela pode ser expressa usando unidades de CPU (por exemplo,1024) ou usando vCPUs (por exemplo1 vCPU, 1 vcpu ou) em uma definição de tarefa. Quando a definição de tarefa for registrada, um valor de vCPU será convertido em um inteiro indicando as unidades de CPU.

Para tarefas executadas em instâncias do EC2 ou em instâncias externas, este campo é opcional. Se o seu cluster não tiver registrado instâncias de contêiner com as unidades de CPU solicitadas disponíveis, ocorrerá uma falha na tarefa. Os valores com suporte para tarefas executadas em instâncias do EC2 ou em instâncias externas estão entre 0.125 vCPUs e 10 vCPUs.

Para tarefas executadas no Fargate (tanto contêineres do Linux quanto do Windows), este campo é obrigatório e você deve usar um dos valores a seguir, o que determina seu intervalo de valores com suporte para o parâmetro memory. A tabela a seguir mostra as combinações válidas para CPU e memória em nível de tarefa.

Valor de CPU	Valor de memória	Sistemas operacionais com suporte para o AWS Fargate
256 (0,25 vCPU)	512 MiB, 1 GB, 2 GB	Linux
512 (0,5 vCPU)	1 GB, 2 GB, 3 GB, 4 GB	Linux
1024 (1 vCPU)	2 GB, 3 GB, 4 GB, 5 GB, 6 GB, 7 GB, 8 GB	Linux, Windows
2048 (2 vCPU)	Entre 4 GB e 16 GB em incrementos de 1 GB	Linux, Windows
4096 (4 vCPU)	Entre 8 GB e 30 GB em incrementos de 1 GB	Linux, Windows
8192 (8 vCPU) nota Essa opção requer a plataforma Linux `1.4.0` ou posterior.	Entre 16 GB e 60 GB em incrementos de 4 GB	Linux
16384 (16 vCPU) nota Essa opção requer a plataforma Linux `1.4.0` ou posterior.	Entre 32 GB e 120 GB em incrementos de 8 GB	Linux

memory

Tipo: string

Obrigatório: Condicional

nota

Este parâmetro não é compatível com contêineres do Windows.

O limite rígido (em MiB) de memória a ser apresentado para a tarefa. Ele pode ser expresso usando MiB (por exemplo1024) ou usando GB (por exemplo 1GB ou1 GB) em uma definição de tarefa. Quando a definição de tarefa for registrada, um valor em GB será convertido em um inteiro indicando o MiB.

Para tarefas hospedadas em instâncias do Amazon EC2, esse campo é opcional e qualquer valor pode ser usado. Se um valor de memória no nível de tarefa for especificado, o valor de memória no nível de contêiner será opcional. Se o seu cluster não tiver registrado instâncias de contêiner com a memória solicitada disponível, ocorrerá uma falha na tarefa. É possível maximizar a utilização de recursos fornecendo às tarefas o máximo de memória possível para um determinado tipo de instância. Para ter mais informações, consulte Gerenciamento de memória de instâncias de contêiner.

Para tarefas hospedadas no Fargate (tanto contêineres de Linux quanto de Windows), esse campo é obrigatório e você deve usar um dos seguintes valores, o que determina seu intervalo de valores com suporte com o parâmetro cpu:

Valor da memória (em MiB, com valor equivalente aproximado em GB)	Valor de CPU	Sistemas operacionais com suporte para o Fargate
512 (0,5 GB), 1024 (1 GB), 2048 (2 GB)	256 (0,25 vCPU)	Linux
1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB)	512 (0,5 vCPU)	Linux
2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB)	1024 (1 vCPU)	Linux, Windows
Entre 4096 (4 GB) e 16384 (16 GB) em incrementos de 1024 (1 GB)	2048 (2 vCPU)	Linux, Windows
Entre 8192 (8 GB) e 30720 (30 GB) em incrementos de 1024 (1 GB)	4096 (4 vCPU)	Linux, Windows
Entre 16 GB e 60 GB em incrementos de 4 GB nota Essa opção requer a plataforma Linux `1.4.0` ou posterior.	8192 (8 vCPU)	Linux
Entre 32 GB e 120 GB em incrementos de 8 GB nota Essa opção requer a plataforma Linux `1.4.0` ou posterior.	16384 (16 vCPU)	Linux

Definições de contêiner

Ao registrar uma definição de tarefa, você deve especificar uma lista de definições de contêiner passadas para o daemon do Docker em uma instância de contêiner. Os parâmetros a seguir são permitidos em uma definição de contêiner.

Tópicos

Parâmetros padrão de definição de contêiner
Parâmetros avançados de definição de contêiner
Outros parâmetros de definição de contêiner

Parâmetros padrão de definição de contêiner

Os parâmetros de definição de tarefa a seguir são obrigatórios ou usados na maioria das definições de contêiner.

Nome

name

Tipo: string

Obrigatório: não

O nome de um contêiner. São permitidos até 255 letras (caixa alta e baixa), números, hífens e sublinhados. Se estiver vinculando vários contêineres em uma definição de tarefa, o name de um contêiner poderá ser informado no links de outro contêiner. Isso deve ser feito para conectar os contêineres.

Imagem

image

Tipo: string

Obrigatório: não

A imagem usada para iniciar um contêiner. Essa string é passada diretamente para o daemon do Docker. Por padrão, as imagens no registro do Docker Hub estão disponíveis. Você também pode especificar outros repositórios com repository-url/image:tag ou repository-url/image@digest. São permitidos até 255 letras (caixa alta e baixa), números, hifens, sublinhados, dois pontos, ponto, barras e sinais numéricos. Esse parâmetro é mapeado para Image na seção Criar um contêiner da API remota do Docker e o parâmetro IMAGE de docker run.

Quando uma nova tarefa é iniciada, o agente do contêiner do Amazon ECS obtém a versão mais recente da imagem especificada e a tag do contêiner a ser usado. No entanto, as atualizações subsequentes feitas em um repositório de imagens não são propagadas para tarefas já em execução.
As imagens em registros privados são suportadas. Para ter mais informações, consulte Autenticação de registro privado para tarefas.
As imagens nos repositórios do Amazon ECR podem ser especificadas usando a convenção de nomenclatura completa registry/repository:tag ou registry/repository@digest (por exemplo, aws_account_id.dkr.ecr.region.amazonaws.com/my-web-app:latest ou aws_account_id.dkr.ecr.region.amazonaws.com/my-web-app@sha256:94afd1f2e64d908bc90dbca0035a5b567EXAMPLE).
As imagens em repositórios oficiais no Docker Hub usam um único nome (por exemplo, ubuntu ou mongo).
Imagens em outros repositórios Docker Hub são qualificadas com um nome de organização (por exemplo, amazon/amazon-ecs-agent).
Imagens em outros repositórios online também são qualificadas por um nome de domínio (por exemplo, quay.io/assemblyline/ubuntu).

Memória

memory

Tipo: inteiro

Obrigatório: não

A quantidade (em MiB) de memória a ser apresentada ao contêiner. Caso tente exceder a memória especificada aqui, o contêiner será excluído. A quantidade total de memória reservada para todos os contêineres dentro da tarefa deve ser menor que o valor da tarefa memory, se estiver especificado. Esse parâmetro é mapeado para Memory na seção Criar um Contêiner da API remota do Docker e a opção --memory para docker run.

Se estiver usando o tipo de inicialização Fargate, esse parâmetro será opcional.

Se estiver usando o tipo de inicialização do EC2, será necessário especificar um valor de memória em nível de tarefa ou um valor de memória em nível do contêiner. Se você especificar um nível de contêiner memory e um valor de memoryReservation, o valor de memory deverá ser maior que o valor de memoryReservation. Caso você especifique memoryReservation, o valor é subtraído dos recursos de memória disponíveis para a instância de contêiner na qual o contêiner está colocado. Caso contrário, o valor de memory é usado.

O daemon para Docker 20.10.0 ou versão posterior reserva no mínimo 6 MiB de memória para um contêiner. Por isso, não especifique menos de 6 MiB de memória para os seus contêineres.

O daemon para Docker 19.03.13-ce ou versão anterior reserva no mínimo 4 MiB de memória para um contêiner. Por isso, não especifique menos de 4 MiB de memória para os seus contêineres.

nota

Se você deseja maximizar a utilização de recursos fornecendo às tarefas o máximo de memória possível para um determinado tipo de instância, consulte Gerenciamento de memória de instâncias de contêiner.

memoryReservation

Tipo: inteiro

Obrigatório: não

O limite flexível (em MiB) de memória a ser reservado para o contêiner. Quando a memória do sistema estiver em contenção, o Docker tentará manter a memória do contêiner dentro desse limite flexível. Entrentanto, seu contêiner pode usar mais memória quando necessário. O contêiner pode consumir até o limite rígido especificado pelo parâmetro memory (se aplicável), ou toda a memória disponível na instância de contêiner, o que ocorrer primeiro. Esse parâmetro é mapeado para MemoryReservation na seção Criar um Contêiner da API remota do Docker e a opção --memory-reservation para docker run.

Se um valor de memória no nível de tarefa não for especificado, será necessário especificar um número inteiro diferente de zero para um ou ambos memory ou memoryReservation em uma definição de contêiner. Caso você especifique ambos, memory deve ser maior que memoryReservation. Caso você especifique memoryReservation, o valor é subtraído dos recursos de memória disponíveis para a instância de contêiner na qual o contêiner está colocado. Caso contrário, o valor de memory é usado.

Por exemplo, suponha que seu contêiner normalmente use 128 MiB de memória, mas às vezes chegue a 256 MiB de memória por períodos curtos. É possível definir um memoryReservation de 128 MiB e um limite rígido de memory de 300 MiB. Essa configuração permite que contêiner reservasse apenas 128 MiB de memória dos recursos restantes na instância de contêiner. Ao mesmo tempo, essa configuração também possibilita que o contêiner utilize mais recursos de memória quando necessário.

nota

Este parâmetro não é compatível com contêineres do Windows.

O daemon para Docker 20.10.0 ou versão posterior reserva no mínimo 6 MiB de memória para um contêiner. Por isso, não especifique menos de 6 MiB de memória para os seus contêineres.

O daemon para Docker 19.03.13-ce ou versão anterior reserva no mínimo 4 MiB de memória para um contêiner. Por isso, não especifique menos de 4 MiB de memória para os seus contêineres.

nota

Mapeamentos de porta

portMappings

Tipo: Matriz de objeto

Obrigatório: Não

Os mapeamentos de porta permitem que os contêineres acessem portas na instância de contêiner host para enviar ou receber tráfego.

Para definições de tarefa que usam o modo de rede awsvpc, apenas especifique containerPort. A hostPort pode ser deixada em branco ou ser do mesmo valor de containerPort.

Os mapeamentos de porta no Windows usam o endereço de gateway NetNAT, e não o localhost. Não há loopback para mapeamentos de porta no Windows, de modo que você não pode acessar a porta mapeada de um contêiner no próprio host.

A maioria dos campos desse parâmetro (incluindo containerPort, hostPort, protocol) é mapeada para PortBindings na seção Criar um contêiner da API remota do Docker e a opção --publish para docker run. Caso o modo de rede de uma definição de tarefa seja definido como host, as portas host devem ser indefinidas ou corresponder à porta de contêiner no mapeamento de porta.

nota

Quando a tarefa obter o status RUNNING, as atribuições automáticas e manuais da porta do contêiner e do host estarão visíveis nos seguintes locais:

Console: a seção Network Bindings (Associações de rede) de uma descrição de contêiner para uma tarefa selecionada.
AWS CLI: a seção networkBindings do resultado do comando describe-tasks.
API: a resposta DescribeTasks.
Metadados: o endpoint de metadados da tarefa.

appProtocol

Tipo: string

Obrigatório: não

O protocolo da aplicação usado no mapeamento da porta. Esse parâmetro só se aplica ao Service Connect. Recomendamos que você defina esse parâmetro para que seja consistente com o protocolo usado por sua aplicação. Se você definir esse parâmetro, o Amazon ECS adicionará o tratamento de conexão específico do protocolo ao proxy do Service Connect. Se você definir esse parâmetro, o Amazon ECS adicionará telemetria específica de protocolo no console do Amazon ECS e. CloudWatch

Se você não definir um valor para esse parâmetro, o TCP será usado. No entanto, o Amazon ECS não adiciona telemetria específica de protocolo para TCP.

Para ter mais informações, consulte Service Connect.

Valores de protocolo válidos: "HTTP" | "HTTP2" | "GRPC"

containerPort

Tipo: inteiro

Exigido: Sim, quando portMappings são usados

O número da porta no contêiner vinculado à porta host atribuída automaticamente ou especificada pelo usuário.

Se você estiver usando contêineres em uma tarefa com o tipo de inicialização do Fargate, as portas expostas deverão ser especificadas usando containerPort.

Para contêineres Windows no Fargate, não é possível usar a porta 3150 para containerPort. Isso acontece porque ela está reservada.

Suponha que você esteja usando contêineres em uma tarefa com o tipo de inicialização do EC2 e especifique uma porta de contêiner, e não uma porta de host. Em seguida, seu contêiner receberá automaticamente uma porta de host no intervalo de portas temporárias. Para ter mais informações, consulte hostPort. Os mapeamentos de porta atribuídos automaticamente dessa maneira não contam para a cota de 100 portas reservadas de uma instância de contêiner.

containerPortRange

Tipo: string

Obrigatório: não

O intervalo de números de porta no contêiner vinculado ao intervalo de portas host mapeado dinamicamente.

Você só pode definir esse parâmetro usando a API register-task-definition. A opção está disponível no parâmetro portMappings. Para obter mais informações, consulte register-task-definition na AWS Command Line Interface Referência.

As regras a seguir se aplicam quando você especifica um containerPortRange:

Você deve usar o modo de rede bridge ou o modo de rede awsvpc.
Esse parâmetro está disponível para os tipos de execução do EC2 e do AWS Fargate.
Esse parâmetro está disponível para os sistemas operacionais Windows e Linux.
A instância de contêiner deve ter pelo menos a versão 1.67.0 do agente do contêiner e pelo menos a versão 1.67.0-1 do pacote ecs-init
É possível especificar no máximo 100 intervalos de portas para cada contêiner.
Você não especifica um hostPortRange. O valor do hostPortRange é definido da seguinte forma:
- Para contêineres em uma tarefa com o modo de rede awsvpc, o hostPort é definido com o mesmo valor que containerPort. Essa é uma estratégia de mapeamento estático.
- Para contêineres em uma tarefa com o modo de rede bridge, o agente do Amazon ECS encontra portas de host abertas no intervalo temporário padrão e as passa ao Docker para vinculá-las às portas do contêiner.
Os valores válidos de containerPortRange estão entre 1 e 65535.
Uma porta só pode ser incluída em um mapeamento de portas para cada contêiner.
Não é possível especificar intervalos de portas sobrepostos.
A primeira porta no intervalo deve ser menor que a última porta no intervalo.
O Docker recomenda que você desative o docker-proxy no arquivo de configuração do daemon do Docker quando tiver um grande número de portas.

Para obter mais informações, consulte a edição #11185 em GitHub.

Para obter informações sobre como desativar o docker-proxy no arquivo de configuração do daemon do Docker, consulte Daemon do Docker no Guia do desenvolvedor do Amazon ECS.

É possível chamar DescribeTasks para ver o hostPortRange, que são as portas do host vinculadas às portas do contêiner.

Os intervalos de portas não estão incluídos nos eventos de tarefas do Amazon ECS, que são enviados para o. EventBridge Para ter mais informações, consulte Automatize as respostas aos erros do Amazon ECS usando EventBridge.

hostPortRange

Tipo: Sequência

Obrigatório: não

O intervalo de números de portas no host que é usado com a vinculação de rede. Isso é atribuído pelo Docker e fornecido pelo agente do Amazon ECS.

hostPort

Tipo: inteiro

Obrigatório: não

O número da porta na instância de contêiner a ser reservado para o contêiner.

Se você estiver usando contêineres em uma tarefa com o tipo de inicialização do Fargate o hostPort poderá ser deixado em branco ou ter o mesmo valor de containerPort.

Suponha que você esteja usando contêineres em uma tarefa com o tipo de inicialização do EC2. É possível especificar uma porta de host não reservada para o mapeamento da porta do contêiner. Isso é conhecido como mapeamento estático da porta do host. Ou é possível omitir a hostPort (ou configurá-la como 0) ao especificar uma containerPort. Seu contêiner recebe automaticamente uma porta no intervalo de portas temporárias para o sistema operacional e a versão Docker da instância de contêiner. Isso é conhecido como mapeamento dinâmico da porta do host.

O intervalo de portas temporárias padrão para a versão 1.6.0 e posterior do Docker é listado na instância em /proc/sys/net/ipv4/ip_local_port_range. Se esse parâmetro do kernel não estiver disponível, será usado o intervalo de portas temporárias padrão de 49153–65535. Não tente especificar uma porta de host no intervalo de portas transitório. Isso ocorre porque essas portas são reservadas para atribuição automática. Em geral, as portas abaixo de 32768 estão fora do intervalo de portas temporárias.

As portas reservadas padrão são 22 para SSH, as portas do Docker 2375 e2376 e as portas do agente de contêiner do Amazon ECS 51678-51680. Qualquer porta de host que tenha sido especificada pelo usuário anteriormente para uma tarefa em execução também é reservada enquanto a tarefa está em execução. Depois que uma tarefa é interrompida, a porta do host é liberada. As portas reservadas atuais são exibidas nos remainingResources de describe-container-instances de saída. Uma instância de contêiner pode ter até 100 portas reservadas por vez, incluindo as portas reservadas padrão. As portas atribuídas automaticamente não contam em relação à cota de 100 portas reservadas.

name

Tipo: sequência

Obrigatório: não, obrigatório para que o Service Connect seja configurado em um serviço

Nome que é usado para o mapeamento da porta. Esse parâmetro só se aplica ao Service Connect. Esse parâmetro é o nome que você usa na configuração do Service Connect de um serviço.

Para ter mais informações, consulte Service Connect.

No exemplo a seguir, os dois campos obrigatórios para o Service Connect são usados.



"portMappings": [
    {
        "name": string,
        "containerPort": integer
    }
]

protocol

Tipo: string

Obrigatório: não

O protocolo usado no mapeamento da porta. Os valores válidos são tcp e udp. O padrão é tcp.

Importante

Só tcp é compatível com o Service Connect. Lembre-se de que tcp estará implícito se esse campo não estiver definido.

Importante

O suporte a UDP só está disponível em instâncias de contêiner que foram iniciadas com a versão 1.2.0 ou posterior do agente de contêiner do Amazon ECS (como a AMI amzn-ami-2015.03.c-amazon-ecs-optimized) ou com agentes de contêiner que tenham sido atualizados para a versão 1.3.0 ou posterior. Para atualizar o agente de contêiner para a versão mais recente, consulte Atualizar o agente de contêiner do Amazon ECS.

Caso você esteja especificando uma porta host, use a seguinte sintaxe:


"portMappings": [
    {
        "containerPort": integer,
        "hostPort": integer
    }
    ...
]

Caso você queira uma porta host atribuída automaticamente, use a seguinte sintaxe:


"portMappings": [
    {
        "containerPort": integer
    }
    ...
]

Credenciais de repositório privado

repositoryCredentials

Tipo: objeto RepositoryCredentials

Obrigatório: Não

As credenciais do repositório para autenticação de registro privado.

Para ter mais informações, consulte Autenticação de registro privado para tarefas.

credentialsParameter

Tipo: sequência

Exigido: Sim, quando repositoryCredentials são usados

O nome de recurso da Amazon (ARN) do segredo que contém as credenciais do repositório privado.

Para ter mais informações, consulte Autenticação de registro privado para tarefas.

nota

Ao usar a API ou AWS SDKs do Amazon ECS, se o segredo existir na mesma região da tarefa que você está iniciando, você poderá usar o ARN completo ou o nome do segredo. AWS CLI Ao usar o AWS Management Console, você deve especificar o ARN completo do segredo.

Veja a seguir um trecho de uma definição de tarefa que mostra os parâmetros necessários.



"containerDefinitions": [
    {
        "image": "private-repo/private-image",
        "repositoryCredentials": {
            "credentialsParameter": "arn:aws:secretsmanager:region:aws_account_id:secret:secret_name"
        }
    }
]

Parâmetros avançados de definição de contêiner

Os parâmetros avançados de definição de contêiner a seguir fornecem recursos estendidos ao comando docker run usado para iniciar contêineres nas instâncias de contêiner do Amazon ECS.

Tópicos

Verificação de integridade
Ambiente
Configurações de rede
Armazenamento e registro
Segurança
Limites de recurso
Rótulos do Docker

Verificação de integridade

healthCheck

O comando da verificação de integridade de contêiner e os parâmetros de configuração associados para o contêiner. Para ter mais informações, consulte Determine a integridade das tarefas do Amazon ECS usando verificações de integridade de contêineres.

command

Uma matriz de strings que representa o comando executado pelo contêiner para determinar se ela está íntegra. A matriz de strings pode começar com CMD para executar os argumentos de comando diretamente ou CMD-SHELL para executar o comando com o shell padrão do contêiner. Se nenhuma for especificado, CMD será usada.

Ao registrar uma definição de tarefa no AWS Management Console, use uma lista de comandos separados por vírgulas. Esses comandos serão convertidos em uma string após a criação da definição de tarefa. Veja a seguir um exemplo de entrada para uma verificação de integridade.


CMD-SHELL, curl -f http://localhost/ || exit 1

Ao registrar uma definição de tarefa usando o painel AWS Management Console JSON, o, ou as APIs AWS CLI, coloque a lista de comandos entre colchetes. Veja a seguir um exemplo de entrada para uma verificação de integridade.


[ "CMD-SHELL", "curl -f http://localhost/ || exit 1" ]

Um código de saída 0, sem saída de stderr, indica sucesso, e um código de saída diferente de zero indica falha. Para obter mais informações, consulte HealthCheck na seção Criar um contêiner da the API remota do Docker.

interval

O período em segundos entre cada verificação de integridade. É possível especificar entre 5 e 300 segundos. O valor padrão de é 30 segundos.

timeout

O período de espera (em segundos) para que uma verificação de integridade seja bem-sucedida antes de ser considerada uma falha. É possível especificar entre 2 e 60 segundos. O valor de padrão é de 5 segundos.

retries

O número de novas tentativas de uma verificação de integridade com falha até o contêiner ser considerado não íntegro. É possível especificar entre 1 e 10 novas tentativas. O valor padrão é três novas tentativas.

startPeriod

O período de carência opcional para que os contêineres possam inicializar antes de as verificações de integridade com falha serem contabilizadas no número máximo de novas tentativas. É possível especificar entre 0 e 300 segundos. Por padrão, o startPeriod está desabilitado.

Ambiente

cpu

Tipo: inteiro

Obrigatório: não

O número de unidades de cpu que o agente de contêiner do Amazon ECS reservará para o contêiner. No Linux, esse parâmetro é mapeado para CpuShares na seção Criar um contêiner da API remota do Docker e a opção --cpu-shares para docker run.

Este campo é opcional para tarefas que usam o tipo de inicialização do Fargate. A quantidade total de CPU reservada para todos os contêineres dentro da tarefa deve ser menor que o valor cpu de nível da tarefa.

nota

É possível determinar o número de unidades de CPU disponíveis para cada tipo de instância do Amazon EC2. Para fazer isso, multiplique o número de vCPUs listadas para esse tipo de instância na página de detalhes Instâncias do Amazon EC2 por 1.024.

Os contêineres de Linux compartilham unidades de CPU não alocadas com outros contêineres na instância de contêiner que tem a mesma proporção que a respectiva quantidade alocada. Por exemplo, suponha que você execute uma tarefa de contêiner único em um tipo de instância de núcleo único com 512 unidades de CPU especificadas para esse contêiner. Além disso, essa tarefa é a única em execução na instância de contêiner. Nesse exemplo, o contêiner pode utilizar o compartilhamento total de 1.024 unidades de CPU a qualquer momento. Porém, suponha que você tenha iniciado outra cópia da mesma tarefa nessa instância de contêiner. Cada tarefa tem garantido um mínimo de 512 unidades de CPU quando necessário. Da mesma forma, se o outro contêiner não estiver usando a CPU restante, cada contêiner poderá flutuar para o uso maior da CPU. Porém, se ambas as tarefas estiverem 100% ativas o tempo todo, elas ficarão limitadas a 512 unidades de CPU.

Nas instâncias de contêiner de Linux, o daemon do Docker na instância de contêiner usa o valor de CPU para calcular as proporções de compartilhamento de CPU para contêineres em execução. Para obter mais informações, consulte CPU share constraint na documentação do Docker. O valor mínimo válido de compartilhamento da CPU permitido pelo kernel do Linux é 2. No entanto, o parâmetro de CPU não é necessário, e é possível usar valores de CPU abaixo de dois em suas definições de contêiner. Para valores de CPU abaixo de 2 (inclusive nulo), o comportamento varia com base na versão do agente de contêiner do Amazon ECS:

Versões de agente <= 1.1.0: os valores de CPU nulo e zero são passados para o Docker como 0. O Docker, em seguida, converte esse valor para 1.024 compartilhamentos de CPU. Os valores de CPU de um são passados para o Docker como um, que o kernel do Linux converte para dois compartilhamentos de CPU.
Versões de agente >= 1.2.0: os valores nulo, zero e de CPU de 1 são passados para o Docker como dois compartilhamentos de CPU.

Nas instâncias de contêiner de Windows, a cota de CPU é imposta como uma cota absoluta. Os contêineres de Windows só têm acesso à quantidade de CPU especificada na definição de tarefa. Um valor de CPU nulo ou zero é transmitido para Docker como 0. Em seguida, Windows interpreta esse valor como 1% de uma CPU.

Para obter exemplos adicionais, consulte Como o Amazon ECS gerencia recursos de CPU e memória.

gpu

Tipo: objeto ResourceRequirement

Obrigatório: Não

O número de GPUs físicas que o agente de contêiner do Amazon ECS reservará para o contêiner. O número de GPUs reservadas para todos os contêineres em uma tarefa não deve exceder o número de GPUs disponíveis na instância de contêiner na qual a tarefa é executada. Para ter mais informações, consulte Trabalhar com GPUs no Amazon ECS.

nota

Esse parâmetro não tem suporte para contêineres do Windows ou contêineres hospedados no Fargate.

Elastic Inference accelerator

Tipo: objeto ResourceRequirement

Obrigatório: Não

Para o tipo InferenceAccelerator, o value corresponde ao deviceName para um InferenceAccelerator especificado em uma definição de tarefa. Para ter mais informações, consulte Nome do acelerador de inferência elástica.

nota

A partir de 15 de abril de 2023, não AWS incorporará novos clientes ao Amazon Elastic Inference (EI) e ajudará os clientes atuais a migrar suas cargas de trabalho para opções que ofereçam melhor preço e desempenho. Depois de 15 de abril de 2023, novos clientes não poderão lançar instâncias com aceleradores Amazon EI na Amazon SageMaker, Amazon ECS ou Amazon EC2. No entanto, os clientes que tenham usado o Amazon EI pelo menos uma vez durante os últimos 30 dias serão considerados clientes atuais e poderão continuar usando o serviço.

nota

Esse parâmetro não tem suporte para contêineres do Windows ou contêineres hospedados no Fargate.

essential

Tipo: booliano

Obrigatório: não

Suponha que o parâmetro essential de um contêiner esteja marcado como true, e que esse contêiner falhe ou seja interrompido por algum motivo. Em seguida, todos os outros contêineres que fazem parte da tarefa são interrompidos. Caso o parâmetro essential de um contêiner esteja marcado como false, a falha não afeta o restante dos contêineres em uma tarefa. Caso esse parâmetro seja omitido, um contêiner pressupõe-se que um contêiner seja essencial.

Todas as tarefas devem ter pelo menos um contêiner essencial. Suponha que você tenha uma aplicação composta por vários contêineres. Em seguida, agrupe os contêineres usados para uma finalidade em comum em componentes e separe os componentes diferentes em várias definições de tarefa. Para ter mais informações, consulte Arquitetando seu aplicativo.


"essential": true|false

entryPoint

Importante

As versões anteriores do agente de contêiner do Amazon ECS não lidam corretamente com parâmetros entryPoint. Caso você enfrente problemas para usar entryPoint, atualize o agente de contêiner ou informe os comandos e os argumentos como itens de matriz command em vez disso.

Tipo: Matriz de strings

Obrigatório: Não

O ponto de entrada passado para o contêiner. Esse parâmetro é mapeado para Entrypoint na seção Criar um Contêiner da API remota do Docker e a opção --entrypoint para docker run. Para obter mais informações sobre o parâmetro ENTRYPOINT do Docker, consulte https://docs.docker.com/engine/reference/builder/#entrypoint.


"entryPoint": ["string", ...]

command

Tipo: Matriz de strings

Obrigatório: Não

O comando que é passado para o contêiner. Esse parâmetro é mapeado para Cmd na seção Criar um contêiner da Docker Remote API e o parâmetro COMMAND de docker run. Para obter mais informações sobre o parâmetro CMD do Docker, consulte https://docs.docker.com/engine/reference/builder/#cmd. Se houver vários argumentos, certifique-se de que cada um seja uma string separada na matriz.


"command": ["string", ...]

workingDirectory

Tipo: string

Obrigatório: não

O diretório de trabalho no qual executar comandos no contêiner. Esse parâmetro é mapeado para WorkingDir na seção Criar um contêiner da Docker Remote API e a opção --workdir para docker run.


"workingDirectory": "string"

environmentFiles

Tipo: Matriz de objeto

Obrigatório: Não

Uma lista de arquivos que contêm as variáveis de ambiente a serem passadas para um contêiner. Esse parâmetro é mapeado para a opção --env-file para o docker run.

Isso não está disponível para contêineres Windows.

É possível especificar até 10 arquivos de ambiente. O arquivo deve ter uma extensão .env. Cada linha em um arquivo de ambiente contém uma variável de ambiente no formato VARIABLE=VALUE. As linhas que começam com # são tratadas como comentários e são ignoradas. Para obter mais informações sobre a sintaxe de arquivos de variáveis de ambiente apropriadas, consulte Declarar variáveis de ambiente padrão em arquivo.

Se houver variáveis de ambiente individuais especificadas na definição de contêiner, elas terão precedência sobre as variáveis contidas em um arquivo de ambiente. Se forem especificados vários arquivos de ambiente que contenham a mesma variável, elas serão processadas de cima para baixo. Recomendamos usar nomes de variáveis exclusivos. Para ter mais informações, consulte Use parâmetros de definição de tarefas para passar variáveis de ambiente para um contêiner.

value

Tipo: sequência

Obrigatório: Sim

O nome de recurso da Amazon (ARN) do objeto do Amazon S3 que contém o arquivo de variáveis de ambiente.

type

Tipo: sequência

Obrigatório: Sim

Tipo de arquivo a ser usado O único valor aceito é s3.

environment

Tipo: Matriz de objeto

Obrigatório: Não

As variáveis de ambiente a serem passadas para um contêiner. Esse parâmetro é mapeado para Env na seção Criar um contêiner da Docker Remote API e a opção --env para docker run.

Importante

Não recomendamos o uso de variáveis de ambiente de texto simples para informações confidenciais, tais como dados de credenciais.

name

Tipo: sequência

Exigido: sim, quando environment for usado

O nome da variável de ambiente.

value

Tipo: sequência

Exigido: sim, quando environment for usado

O valor da variável de ambiente.


"environment" : [
    { "name" : "string", "value" : "string" },
    { "name" : "string", "value" : "string" }
]

secrets

Tipo: Matriz de objeto

Obrigatório: Não

Um objeto que representa o segredo a ser exposto ao seu contêiner. Para ter mais informações, consulte Passar dados confidenciais para um contêiner.

name

Tipo: sequência

Obrigatório: Sim

O valor a ser definido como a variável de ambiente no contêiner.

valueFrom

Tipo: sequência

Obrigatório: Sim

O segredo a ser exposto ao contêiner. Os valores suportados são o Amazon Resource Name (ARN) completo do AWS Secrets Manager segredo ou o ARN completo do parâmetro no Parameter Store. AWS Systems Manager

nota

Se o parâmetro Systems Manager Parameter Store existir na Região da AWS mesma tarefa que você está iniciando, você poderá usar o ARN completo ou o nome do segredo. Se o parâmetro existir em uma Região diferente, o ARN completo deverá ser especificado.


"secrets": [
    {
        "name": "environment_variable_name",
        "valueFrom": "arn:aws:ssm:region:aws_account_id:parameter/parameter_name"
    }
]

Configurações de rede

disableNetworking

Tipo: booliano

Obrigatório: não

Quando esse parâmetro é verdadeiro, a rede é desativada dentro do contêiner. Este parâmetro é mapeado para NetworkDisabled na seção Create a container da Docker Remote API.

nota

Não há suporte para esse parâmetro em contêineres do Windows ou tarefas que usem o modo de rede awsvpc.

O padrão é false.


"disableNetworking": true|false

links

Tipo: Matriz de strings

Obrigatório: Não

O parâmetro link permite que os contêineres se comuniquem entre si sem a necessidade de mapeamentos de porta. Só há suporte para esse parâmetro se o modo de rede de uma definição de tarefa estiver definido como bridge. O construto name:internalName é igual ao name:alias em links do Docker. São permitidos até 255 letras (caixa alta e baixa), números, hífens e sublinhados. Para obter mais informações sobre como vincular contêineres do Docker, consulte https://docs.docker.com/engine/userguide/networking/default_network/dockerlinks/. Esse parâmetro é mapeado para Links na seção Criar um Contêiner da API remota do Docker e a opção --link para docker run.

nota

Não há suporte para esse parâmetro em contêineres do Windows ou tarefas que usem o modo de rede awsvpc.

Importante

Os contêineres colocados na mesma instância de contêiner podem se comunicar entre si sem exigir links ou mapeamentos de porta de host. O isolamento de rede em uma instância de contêiner é controlado por grupos de segurança e configurações de VPC.


"links": ["name:internalName", ...]

hostname

Tipo: string

Obrigatório: não

O nome de host a ser usado para o contêiner. Esse parâmetro é mapeado para Hostname na seção Criar um Contêiner da API remota do Docker e a opção --hostname para docker run.

nota

Se você estiver usando o modo de rede awsvpc, o parâmetro hostname não terá suporte.


"hostname": "string"

dnsServers

Tipo: Matriz de strings

Obrigatório: Não

Uma lista de servidores DNS apresentados ao contêiner. Esse parâmetro é mapeado para Dns na seção Criar um Contêiner da API remota do Docker e a opção --dns para docker run.

nota

Não há suporte para esse parâmetro em contêineres do Windows ou tarefas que usem o modo de rede awsvpc.


"dnsServers": ["string", ...]

dnsSearchDomains

Tipo: Matriz de strings

Obrigatório: Não

Padrão: ^[a-zA-Z0-9-.]{0,253}[a-zA-Z0-9]$

Uma lista de domínios de pesquisa DNS apresentados ao contêiner. Esse parâmetro é mapeado para DnsSearch na seção Criar um Contêiner da API remota do Docker e a opção --dns-search para docker run.

nota

Esse parâmetro não tem suporte para contêineres do Windows ou tarefas que usam o modo de rede awsvpc.


"dnsSearchDomains": ["string", ...]

extraHosts

Tipo: Matriz de objeto

Obrigatório: Não

Uma lista de nomes de host e mapeamentos de endereço IP a ser acrescentada ao arquivo /etc/hosts no contêiner.

Esse parâmetro é mapeado para ExtraHosts na seção Criar um Contêiner da API remota do Docker e a opção --add-host para docker run.

nota

Esse parâmetro não tem suporte para contêineres do Windows ou tarefas que usam o modo de rede awsvpc.


"extraHosts": [
      {
        "hostname": "string",
        "ipAddress": "string"
      }
      ...
    ]

hostname

Tipo: sequência

Exigido: Sim, quando extraHosts são usados

O nome do host a ser usado na entrada /etc/hosts.

ipAddress

Tipo: sequência

Exigido: Sim, quando extraHosts são usados

O endereço IP a ser usado na entrada /etc/hosts.

Armazenamento e registro

readonlyRootFilesystem

Tipo: booliano

Obrigatório: Não

Quando esse parâmetro é verdadeiro, o contêiner recebe acesso somente leitura ao sistema de arquivos raiz. Esse parâmetro é mapeado para ReadonlyRootfs na seção Criar um contêiner da Docker Remote API e a opção --read-only para docker run.

nota

Este parâmetro não é compatível com contêineres do Windows.

O padrão é false.


"readonlyRootFilesystem": true|false

mountPoints

Tipo: Matriz de objeto

Obrigatório: Não

Os pontos de montagem dos volumes de dados em seu contêiner. Esse parâmetro é mapeado para Volumes na seção Criar um Contêiner da API remota do Docker e a opção --volume para docker run.

Os contêineres do Windows podem montar diretórios inteiros na mesma unidade como $env:ProgramData. Os contêineres do Windows não podem montar diretórios em uma unidade diferente e os pontos de montagem não podem ser usados entre unidades.

sourceVolume

Tipo: sequência

Exigido: Sim, quando mountPoints são usados

O nome do volume a ser montado.

containerPath

Tipo: sequência

Exigido: Sim, quando mountPoints são usados

O caminho no contêiner em que o volume será montado.

readOnly

Tipo: booliano

Obrigatório: não

Caso o valor seja true, o contêiner tem acesso somente leitura ao volume. Caso esse valor seja false, o contêiner pode gravar no volume. O valor padrão é false.

volumesFrom

Tipo: Matriz de objeto

Obrigatório: Não

Volumes de dados a serem montados de outro contêiner. Esse parâmetro é mapeado para VolumesFrom na seção Criar um contêiner da Docker Remote API e a opção --volumes-from para docker run.

sourceContainer

Tipo: sequência

Exigido: sim, quando volumesFrom for usado

O nome do contêiner com base no qual montar volumes.

readOnly

Tipo: booliano

Obrigatório: não

Caso o valor seja true, o contêiner tem acesso somente leitura ao volume. Caso esse valor seja false, o contêiner pode gravar no volume. O valor padrão é false.


"volumesFrom": [
                {
                  "sourceContainer": "string",
                  "readOnly": true|false
                }
              ]

logConfiguration

Tipo: LogConfigurationObjeto

Obrigatório: Não

A especificação de configuração do log para o contêiner.

Para obter definições de tarefa de exemplo que usam uma configuração de log, consulte Exemplos de definições de tarefa.

Esse parâmetro é mapeado para LogConfig na seção Criar um Contêiner da API remota do Docker e a opção --log-driver para docker run. Por padrão, os contêineres usam o mesmo driver de registro em log que o daemon do Docker usa. No entanto, o contêiner pode usar um driver de registro em log diferente do daemon do Docker especificando um driver de log com esse parâmetro na definição de contêiner. Para usar um driver de registro em log diferente para um contêiner, o sistema de log deve ser configurado corretamente na instância de contêiner (ou em um servidor de log diferente para opções de registro em log remotas). Para obter mais informações sobre as opções para drivers de log diferentes com suporte, consulte Configurar drivers de registro em log na documentação do Docker.

Considere o seguinte ao especificar uma configuração de log para seus contêineres:

O Amazon ECS oferece suporte a um subconjunto dos drivers de registro em log disponíveis para o daemon Docker. Os drivers de log adicionais podem estar disponíveis em versões futuras do agente de contêiner do Amazon ECS.
Esse parâmetro exige a versão 1.18 ou posterior da API remota do Docker na sua instância de contêiner.
Para tarefas que usam o tipo de inicialização do EC2, o agente de contêiner do Amazon ECS em execução em uma instância de contêiner deve registrar em log os drivers de registro em log disponíveis nesta instância com a variável de ambiente ECS_AVAILABLE_LOGGING_DRIVERS antes que os contêineres colocados nesta instância possam usar essas opções de configuração de log. Para ter mais informações, consulte Configuração do agente de contêiner do Amazon ECS.
Para tarefas que usam o tipo de inicialização do Fargate, como você não tem acesso à infraestrutura subjacente na qual suas tarefas estão hospedadas, qualquer software adicional necessário terá que ser instalado fora da tarefa. Por exemplo, os agregadores de saída Fluentd ou um host remoto executando o Logstash para o qual enviar logs Gelf.


"logConfiguration": {
      "logDriver": "awslogs","fluentd","gelf","json-file","journald","logentries","splunk","syslog","awsfirelens",
      "options": {"string": "string"
        ...},
	"secretOptions": [{
		"name": "string",
		"valueFrom": "string"
	}]
}

logDriver

Tipo: String

Valores válidos: "awslogs","fluentd","gelf","json-file","journald","logentries","splunk","syslog","awsfirelens"

Exigido: sim, quando logConfiguration for usado

O driver de log a ser usado para o contêiner. Por padrão, os valores válidos listados anteriormente são drivers de log com os quais o agente de contêiner do Amazon ECS pode se comunicar.

Para tarefas que usam o tipo de inicialização do Fargate, os drivers de log compatíveis são awslogs, splunk e awsfirelens.

Para tarefas que usam o tipo de inicialização do EC2, os drivers de log compatíveis são awslogs, fluentd, gelf, json-file, journald, logentries, syslog, splunk e awsfirelens.

Para obter mais informações sobre como usar o driver de awslogs log nas definições de tarefas para enviar seus registros de contêiner para o CloudWatch Logs, consulteUsar o driver de log awslogs.

Para obter mais informações sobre como usar o driver de log awsfirelens, consulte Roteamento de logs personalizados.

nota

Se você tiver um driver personalizado que não esteja listado, você pode bifurcar o projeto de agente de contêiner do Amazon ECS que está disponível GitHub e personalizá-lo para funcionar com esse driver. Incentivamos você a enviar solicitações pull para alterações que você gostaria de ter incluído. Porém, no momento, não oferecemos suporte à execução de cópias modificadas desse software.

Este parâmetro requer a versão 1.18 da Docker Remote API ou posterior em sua instância de contêiner.

options

Tipo: mapa de string para string

Obrigatório: Não

O mapa chave/valor de opções de configuração a serem enviadas para o driver de log.

Ao FireLens rotear registros para um AWS Partner Network destino AWS service (Serviço da AWS) OR para armazenamento e análise de registros, você pode definir a log-driver-buffer-limit opção de limitar o número de eventos que são armazenados em buffer na memória, antes de serem enviados para o contêiner do roteador de registros. Isso pode ajudar a resolver possíveis problemas de perda de logs, pois o alto throughput pode resultar na falta de memória para o buffer dentro do Docker. Para ter mais informações, consulte Limite do buffer do Fluentd.

Este parâmetro requer que a versão 1.19 da Docker Remote API ou posterior em sua instância de contêiner.

secretOptions

Tipo: Matriz de objeto

Obrigatório: Não

Um objeto que representa o segredo a ser passado para a configuração de log. Os segredos usados na configuração de log podem incluir tokens de autenticação, certificados ou chaves de criptografia. Para ter mais informações, consulte Passar dados confidenciais para um contêiner.

name

Tipo: sequência

Obrigatório: Sim

O valor a ser definido como a variável de ambiente no contêiner.

valueFrom

Tipo: sequência

Obrigatório: Sim

O segredo a ser exposto à configuração de log do contêiner.


"logConfiguration": {
	"logDriver": "splunk",
	"options": {
		"splunk-url": "https://cloud.splunk.com:8080",
		"splunk-token": "...",
		"tag": "...",
		...
	},
	"secretOptions": [{
		"name": "splunk-token",
		"valueFrom": "/ecs/logconfig/splunkcred"
	}]
}

firelensConfiguration

Tipo: FirelensConfigurationObjeto

Obrigatório: Não

A FireLens configuração do contêiner. Isso é usado para especificar e configurar um roteador de log para logs de contêiner. Para ter mais informações, consulte Usando o roteamento de registros personalizado.


{
    "firelensConfiguration": {
        "type": "fluentd",
        "options": {
            "KeyName": ""
        }
    }
}

options

Tipo: Mapa de string para string

Obrigatório: Não

O mapa chave/valor de opções a serem usadas ao configurar o roteador de log. Esse campo é opcional e pode ser usado para especificar um arquivo de configuração personalizado ou para adicionar outros metadados, como a tarefa, a definição de tarefa, o cluster e detalhes da instância de contêiner ao evento de log. Se especificado, a sintaxe a ser usada é "options":{"enable-ecs-log-metadata":"true|false","config-file-type:"s3|file","config-file-value":"arn:aws:s3:::mybucket/fluent.conf|filepath"}. Para ter mais informações, consulte Especificando uma FireLens configuração em uma definição de tarefa.

type

Tipo: sequência

Obrigatório: Sim

O roteador de log a ser usado. Os valores válidos são fluentd ou fluentbit.

Segurança

Para obter mais informações sobre a segurança de contêiner, consulte Task and container security (Segurança de tarefas e contêineres) no Guia de práticas recomendadas do Amazon ECS.

credentialSpecs

Tipo: Matriz de strings

Obrigatório: Não

Uma lista de ARNs no SSM ou no Amazon S3 para um arquivo de especificação de credencial (CredSpec) que configura o contêiner para autenticação do Active Directory. Recomendamos o uso deste parâmetro, em vez de dockerSecurityOptions. O número máximo de ARNs é 1.

Há dois formatos para cada ARN.

credentialspecdomainless:MyARN

Você usa credentialspecdomainless:MyARN para fornecer uma CredSpec com uma seção adicional para um segredo no Secrets Manager. Você fornece as credenciais de login para o domínio no segredo.

Cada tarefa executada em qualquer instância de contêiner pode se associar a domínios diferentes.

É possível usar esse formato sem associar a instância de contêiner a um domínio.

credentialspec:MyARN

Você usa credentialspec:MyARN para fornecer um CredSpec para um único domínio.

Você deve associar a instância de contêiner ao domínio antes de iniciar qualquer tarefa que use essa definição de tarefa.

Em ambos os formatos, substitua MyARN pelo ARN no SSM ou no Amazon S3.

A credspec deve fornecer um ARN no Secrets Manager para um segredo contendo o nome de usuário, a senha e o domínio ao qual se conectar. Para maior segurança, a instância não é associada ao domínio para autenticação sem domínio. Outras aplicações na instância não podem usar as credenciais sem domínio. É possível usar esse parâmetro para executar tarefas na mesma instância, mesmo que as tarefas precisem ser associadas a domínios diferentes. Para obter mais informações, consulte Uso de gMSAs para contêineres de Windows e Uso de gMSAs para contêineres de Linux.

privileged

Tipo: booliano

Obrigatório: não

Quando esse parâmetro é verdadeiro, o contêiner recebe privilégios elevados na instância de contêiner host (semelhante ao usuário root). Não recomendamos operar contêineres com privileged. Na maioria dos casos, é possível especificar os privilégios exatos necessários usando os parâmetros específicos em vez de privileged.

Esse parâmetro é mapeado para Privileged na seção Criar um Contêiner da API remota do Docker e a opção --privileged para docker run.

nota

Esse parâmetro não é compatível com os contêineres do Windows ou tarefas que usam o tipo de inicialização Fargate.

O padrão é false.


"privileged": true|false

user

Tipo: string

Obrigatório: não

O usuário a ser utilizado dentro do contêiner. Esse parâmetro é mapeado para User na seção Criar um Contêiner da API remota do Docker e a opção --user para docker run.

Importante

Ao executar tarefas que usam o modo de rede host, não execute contêineres usando o usuário raiz (UID 0). Como uma prática recomendada de segurança, sempre utilize um usuário não raiz.

É possível especificar o user usando os formatos a seguir. Se especificar um UID ou um GID, você deverá especificá-lo como um número inteiro positivo.

user
user:group
uid
uid:gid
user:gid
uid:group

nota

Este parâmetro não é compatível com contêineres do Windows.


"user": "string"

dockerSecurityOptions

Tipo: matriz de strings

Valores válidos: "no-new-privileges" | “AppArmor: profile” | “label: value" | “credentialspec:” CredentialSpecFilePath

Obrigatório: Não

Uma lista de strings para fornecer configuração personalizada para vários sistemas de segurança. Para obter mais informações sobre valores válidos, consulte Configuração de segurança na execução do Docker. Esse campo não é válido para contêineres em tarefas usando o tipo de inicialização Fargate.

Para tarefas de Linux no EC2, esse parâmetro pode ser usado para referenciar rótulos personalizados para sistemas de segurança de vários níveis SELinux e AppArmor .

Para quaisquer tarefas no EC2, este parâmetro pode ser usado para fazer referência a um arquivo de especificação de credenciais que configura um contêiner para autenticação do Active Directory. Para ter mais informações, consulte Usando GMSAs para contêineres Windows no Amazon EC2 e Uso gMSA para Linux contêineres no Amazon EC2.

Esse parâmetro é mapeado para SecurityOpt na seção Criar um Contêiner da API remota do Docker e a opção --security-opt para docker.


"dockerSecurityOptions": ["string", ...]

nota

O agente de contêiner do Amazon ECS em execução em uma instância de contêiner deve se registrar com as variáveis de ambiente ECS_SELINUX_CAPABLE=true ou ECS_APPARMOR_CAPABLE=true para contêineres colocados nessa instância possam usar essas opções de segurança. Para ter mais informações, consulte Configuração do agente de contêiner do Amazon ECS.

Limites de recurso

ulimits

Tipo: Matriz de objeto

Obrigatório: Não

Lista de valores ulimit a serem definidos para um contêiner. Esse valor substitui a configuração de cota de recursos padrão do sistema operacional. Esse parâmetro é mapeado para Ulimits na seção Criar um Contêiner da API remota do Docker e a opção --ulimit para docker run.

As tarefas do Amazon ECS hospedadas no Fargate usam os valores de limite de recursos padrão limitados pelo sistema operacional, com exceção do parâmetro de limite de recursos nofile. O limite de recursos nofile define uma restrição sobre o número de arquivos abertos que um contêiner pode usar. No Fargate, o limite flexível padrão de nofile é 1024, e o limite rígido é 65535. É possível definir os valores de ambos os limites até 1048576. Para obter mais informações, consulte Limites de recursos de tarefa.

Este parâmetro requer a versão 1.18 da Docker Remote API ou posterior em sua instância de contêiner.

nota

Este parâmetro não é compatível com contêineres do Windows.


"ulimits": [
      {
        "name": "core"|"cpu"|"data"|"fsize"|"locks"|"memlock"|"msgqueue"|"nice"|"nofile"|"nproc"|"rss"|"rtprio"|"rttime"|"sigpending"|"stack",
        "softLimit": integer,
        "hardLimit": integer
      }
      ...
    ]

name

Tipo: String

Exigido: Sim, quando ulimits são usados

O type do ulimit.

hardLimit

Tipo: inteiro

Exigido: Sim, quando ulimits são usados

O limite rígido do tipo ulimit.

softLimit

Tipo: inteiro

Exigido: Sim, quando ulimits são usados

O limite flexível do tipo ulimit.

Rótulos do Docker

dockerLabels

Tipo: mapa de string para string

Obrigatório: Não

Um mapa de chave/valor de rótulos a ser adicionado ao contêiner. Esse parâmetro é mapeado para Labels na seção Criar um Contêiner da API remota do Docker e a opção --label para docker run.

Este parâmetro requer a versão 1.18 da Docker Remote API ou posterior em sua instância de contêiner.


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

Outros parâmetros de definição de contêiner

Os parâmetros de definição de contêiner a seguir podem ser usados durante o registro das definições de tarefa no console do Amazon ECS usando a opção Configure via JSON (Configurar via JSON). Para ter mais informações, consulte Criação de uma definição de tarefa usando o console.

Tópicos

Parâmetros do Linux
Dependência de contêiner
Tempos limite de contêiner
Controles do sistema
Interativo
Pseudoterminal

Parâmetros do Linux

linuxParameters

Tipo: objeto LinuxParameters

Obrigatório: Não

Linux-opções específicas que são aplicadas ao contêiner, como KernelCapabilities.

nota

Não há suporte para este parâmetro em contêineres do Windows.


"linuxParameters": {
      "capabilities": {
        "add": ["string", ...],
        "drop": ["string", ...]
        }
      }

capabilities

Tipo: objeto KernelCapabilities

Obrigatório: Não

Os recursos do Linux para o contêiner que são adicionados ou descartados da configuração padrão fornecida pelo Docker. Para obter mais informações sobre os recursos padrão e outros recursos disponíveis, consulte Privilégio de runtime e recursos do Linux na DockerReferência de execução do . Para obter mais informações sobre esses recursos do Linux, consulte a página do manual do Linux recursos(7).

add

Tipo: matriz de strings

Obrigatório: Não

Os recursos do Linux para o contêiner que são adicionados à configuração padrão fornecida pelo Docker. Esse parâmetro é mapeado para CapAdd na seção Criar um contêiner da Docker Remote API e a opção --cap-add para execução do docker.

nota

As tarefas executadas no Fargate são compatíveis apenas com a adição do recurso kernel do SYS_PTRACE.

add

Tipo: matriz de strings

Valores válidos: "SYS_PTRACE"

Obrigatório: Não

Os recursos do Linux para o contêiner que são adicionados à configuração padrão que é fornecida pelo Docker. Esse parâmetro é mapeado para CapAdd na seção Criar um contêiner da Docker Remote API e a opção --cap-add para execução do docker.

drop

Tipo: matriz de strings

Obrigatório: Não

Os recursos do Linux para o contêiner que são removidos da configuração padrão fornecida pelo Docker. Esse parâmetro é mapeado para CapDrop na seção Criar um contêiner da Docker Remote API e a opção --cap-drop para execução do docker.

devices

Todos os dispositivos do host a serem expostos ao contêiner. Esse parâmetro é mapeado para Devices na seção Criar um contêiner da Docker Remote API e a opção --device para execução do docker.

nota

Não há suporte para o parâmetro devices quando você usa o tipo de inicialização do Fargate ou contêineres do Windows.

Tipo: Matriz de objetos Device

Obrigatório: Não

hostPath

O caminho para o dispositivo na instância de contêiner host.

Tipo: sequência

Obrigatório: Sim

containerPath

O caminho dentro do contêiner no qual expor o dispositivo do host.

Tipo: string

Obrigatório: não

permissions

As permissões explícitas a serem fornecidas ao contêiner para o dispositivo. Por padrão, o contêiner tem permissões para read, write e mknod no dispositivo.

Tipo: matriz de strings

Valores válidos: read | write | mknod

initProcessEnabled

Execute um processo init dentro do contêiner que encaminha sinais e colhe processos. Esse parâmetro mapeia para a opção --init para execução do docker.

Este parâmetro requer a versão 1.25 ou posterior da Docker Remote API em sua instância de contêiner.

maxSwap

A quantidade total de memória de troca (em MiB) que um contêiner pode usar. Esse parâmetro será convertido na opção --memory-swap para execução do docker em que o valor é a soma da memória do contêiner mais o valor de maxSwap.

Se um valor maxSwap de 0 for especificado, o contêiner não usará a troca. Os valores aceitos são 0 ou qualquer número inteiro positivo. Se o parâmetro maxSwap for omitido, o contêiner usará a configuração de troca para a instância de contêiner na qual ele está sendo executado. Um valor maxSwap deve ser definido para que o parâmetro swappiness seja usado.

nota

Se você estiver usando tarefas que utilizem o tipo de inicialização Fargate, maxSwap não haverá suporte para o parâmetro .

sharedMemorySize

O valor do tamanho (em MiB) do volume /dev/shm. Esse parâmetro mapeia para a opção --shm-size para execução do docker.

nota

Se você estiver usando tarefas que utilizem o tipo de inicialização Fargate, sharedMemorySize não haverá suporte para o parâmetro .

Tipo: inteiro

swappiness

É possível usar este parâmetro para ajustar o comportamento de troca de memória de um contêiner. Um valor de swappiness igual a 0 evita a troca, a menos que ela seja necessária. Um valor de swappiness igual a 100 resulta na troca frequente das páginas. Os valores aceitos são números inteiros entre 0 e 100. Se você não especificar um valor, será usado o valor padrão de 60. Além disso, se você não especificar um valor para maxSwap, esse parâmetro será ignorado. Esse parâmetro mapeia para a opção --memory-swappiness para execução do docker.

nota

Se você estiver usando tarefas que utilizem o tipo de inicialização Fargate, swappiness não haverá suporte para o parâmetro .

Se você estiver usando tarefas no Amazon Linux 2023, não haverá suporte para o parâmetro swappiness.

tmpfs

O caminho do contêiner, as opções de montagem e o tamanho (em MiB) da montagem do tmpfs. Esse parâmetro mapeia para a opção --tmpfs para execução do docker.

nota

Se você estiver usando tarefas que utilizem o tipo de inicialização Fargate, tmpfs não haverá suporte para o parâmetro .

Tipo: Matriz de objetos Tmpfs

Obrigatório: Não

containerPath

O caminho absoluto do arquivo no qual o volume tmpfs deve ser montado.

Tipo: sequência

Obrigatório: Sim

mountOptions

A lista de opções de montagem do volume tmpfs.

Tipo: matriz de strings

Obrigatório: Não

size

O tamanho máximo (em MiB) do volume tmpfs.

Tipo: inteiro

Obrigatório: Sim

Dependência de contêiner

dependsOn

Tipo: matriz de objetos ContainerDependency

Obrigatório: Não

As dependências definidas para inicialização e desligamento do contêiner. Um contêiner pode conter várias dependências. Quando uma dependência é definida para a inicialização do contêiner, ela é revertida para o desligamento do contêiner. Para ver um exemplo, consulte Dependência de contêiner.

nota

Se um contêiner não atender a uma restrição de dependência ou expirar antes de cumprir a restrição, o Amazon ECS não evoluirá contêineres dependentes para seu próximo estado.

Para tarefas do Amazon ECS hospedadas em instâncias do Amazon EC2, as instâncias exigem pelo menos a versão 1.26.0 do agente do contêiner para habilitar dependências de contêiner. Recomendamos usar a versão mais recente do atendente de contêiner. Para obter informações sobre como verificar a versão do agente e atualizar para a versão mais recente, consulte Atualizar o agente de contêiner do Amazon ECS. Se você estiver usando uma AMI do Amazon Linux otimizada para o Amazon ECS, sua instância precisará pelo menos da versão 1.26.0-1 do pacote ecs-init. Se as instâncias de contêiner são executadas na versão 20190301 ou posterior, então elas contêm as versões necessárias do agente de contêiner e do ecs-init. Para ter mais informações, consulte AMIs otimizadas para Amazon ECS.

Para tarefas do Amazon ECS hospedadas no Fargate, este parâmetro exige que a tarefa ou o serviço use a versão da plataforma 1.3.0 ou posterior (Linux), ou 1.0.0 (Windows).


"dependsOn": [
    {
        "containerName": "string",
        "condition": "string"
    }
]

containerName

Tipo: sequência

Obrigatório: Sim

O nome do contêiner que deve atender à condição especificada.

condition

Tipo: sequência

Obrigatório: Sim

A condição de dependência do contêiner. A seguir estão as condições disponíveis e seus comportamentos.

START: essa condição emula o comportamento de links e volumes atuais. A condição valida que um contêiner dependente seja iniciado antes de permitir que outros contêineres sejam iniciados.
COMPLETE: essa condição valida que um contêiner dependente seja executado até a conclusão (encerramento) antes de permitir que outros contêineres sejam iniciados. Isso pode ser útil para os contêineres não essenciais que executam um script e depois são encerrados. Não é possível definir essa condição em um contêiner essencial.
SUCCESS: essa condição é igual a COMPLETE, mas também exige que o contêiner seja encerrado com um status zero. Não é possível definir essa condição em um contêiner essencial.
HEALTHY: essa condição valida que o contêiner dependente foi aprovado na verificação de integridade do Docker antes de permitir que outros contêineres sejam iniciados. Isso requer que o contêiner dependente tenha verificações de integridade configuradas na definição de tarefa. Essa condição é confirmada apenas na inicialização da tarefa.

Tempos limite de contêiner

startTimeout

Tipo: inteiro

Obrigatório: não

Valores de exemplo: 120

Tempo a ser aguardado (em segundos) antes de desistir de resolver dependências para um contêiner.

Por exemplo, você especifica dois contêineres em uma definição de tarefa com o containerA tendo uma dependência do containerB atingir um status COMPLETE, SUCCESS ou HEALTHY. Se um valor de startTimeout for especificado para o containerB e ele não atingir o status desejado nesse tempo, o containerA não será iniciado.

nota

Se um contêiner não atender a uma restrição de dependência ou expirar antes de cumprir a restrição, o Amazon ECS não evoluirá contêineres dependentes para seu próximo estado.

Para tarefas do Amazon ECS hospedadas no Fargate, esse parâmetro exige que a tarefa ou o serviço use a versão da plataforma 1.3.0 ou posterior (Linux). O valor máximo é 120 segundos.

stopTimeout

Tipo: inteiro

Obrigatório: não

Valores de exemplo: 120

Período (em segundos) a ser aguardado antes de o contêiner ser eliminado de maneira forçada se não for encerrado normalmente por conta própria.

Para tarefas do Amazon ECS hospedadas no Fargate, esse parâmetro exige que a tarefa ou o serviço use a versão da plataforma 1.3.0 ou posterior (Linux). Se o parâmetro não for especificado, então o valor padrão de 30 segundos será usado. O valor máximo é 120 segundos.

Para tarefas que usam o tipo de execução do EC2, se o parâmetro stopTimeout não for especificado, o valor definido para a variável de configuração do agente do contêiner do Amazon ECS ECS_CONTAINER_STOP_TIMEOUT será usado. Se nem o parâmetro stopTimeout nem a variável de configuração do agente ECS_CONTAINER_STOP_TIMEOUT forem definidos, serão usados os valores padrão de 30 segundos para contêineres de Linux e 30 segundos para contêineres de Windows. As instâncias de contêiner exigem pelo menos a versão 1.26.0 do agente de contêiner para habilitar um valor de tempo limite de interrupção de contêiner. Recomendamos usar a versão mais recente do atendente de contêiner. Para obter informações sobre como verificar a versão do agente e atualizar para a versão mais recente, consulte Atualizar o agente de contêiner do Amazon ECS. Se você estiver usando a AMI do Amazon Linux otimizada para o Amazon ECS, sua instância precisará pelo menos da versão 1.26.0-1 do pacote ecs-init. Se as instâncias de contêiner são executadas na versão 20190301 ou posterior, então elas contêm as versões necessárias do agente de contêiner e do ecs-init. Para ter mais informações, consulte AMIs otimizadas para Amazon ECS.

Controles do sistema

systemControls

Tipo: objeto SystemControl

Obrigatório: Não

Uma lista de parâmetros do kernel do namespace a serem definidos no contêiner. Esse parâmetro é mapeado para Sysctls na seção Criar um Contêiner da API remota do Docker e a opção --sysctl para docker run. Por exemplo, é possível definir a configuração net.ipv4.tcp_keepalive_time para manter conexões de longa duração.

Não recomendamos que você especifique parâmetros systemControls relacionados à rede para vários contêineres em uma única tarefa que também use o modo de rede awsvpc ou host. Fazer isso apresenta as desvantagens a seguir:

Para tarefas que usam o modo de rede awsvpc incluindo o Fargate, se você definir systemControls para qualquer contêiner, ele será aplicado a todos os contêineres na tarefa. Se você definir um systemControls diferente para vários contêineres em uma única tarefa, o contêiner iniciado por último determinará qual systemControls entra em vigor.
Para tarefas que usam o modo de rede host, o namespace de rede systemControls não é compatível.

Se você estiver configurando um namespace de recurso IPC para usar nos contêineres da tarefa, as condições a seguir serão aplicadas aos controles do sistema. Para ter mais informações, consulte Modo IPC.

Para tarefas que usam o modo IPC host, o namespace IPC systemControls não é compatível.
Para tarefas que usam o modo IPC de task, os valores de systemControls do namespace IPC serão aplicados a todos os contêineres em uma tarefa.

nota

Este parâmetro não é compatível com contêineres do Windows.

nota

Só há suporte para o parâmetro para tarefas hospedadas no AWS Fargate que usem a versão da plataforma 1.4.0 ou posterior (Linux). Não há suporte para isso nos contêineres do Windows no Fargate.


"systemControls": [
    {
         "namespace":"string",
         "value":"string"
    }
]

namespace

Tipo: string

Obrigatório: não

O parâmetro do kernel do namespace para definir um for. value

Valores de namespace de rede válidos: Sysctls, que comece com "net.*"

Há suporte para todos esses valores no Fargate.

value

Tipo: string

Obrigatório: não

O valor do parâmetro do kernel do namespace especificado em. namespace

Interativo

interactive

Tipo: booliano

Obrigatório: não

Quando esse parâmetro é true, você pode implantar aplicações em contêineres que exigem a alocação de stdin ou tty. Esse parâmetro é mapeado para OpenStdin na seção Criar um Contêiner da API remota do Docker e a opção --interactive para docker run.

O padrão é false.

Pseudoterminal

pseudoTerminal

Tipo: booliano

Obrigatório: não

Quando esse parâmetro é true, um TTY é alocado. Esse parâmetro é mapeado para Tty na seção Criar um Contêiner da API remota do Docker e a opção --tty para docker run.

O padrão é false.

Nome do acelerador de inferência elástica

nota

Requisito do recurso acelerador Elastic Inference para a definição de tarefa. Para obter mais informações, consulte O que é o Amazon Elastic Inference? no Amazon Elastic Inference Developer Guide.

Os seguintes parâmetros são permitidos em uma definição de tarefa:

deviceName

Tipo: sequência

Obrigatório: Sim

O nome do dispositivo do acelerador de inferência elástica. O deviceName também deve ser referenciado em uma definição de contêiner, consulte Elastic Inference accelerator.

deviceType

Tipo: sequência

Obrigatório: Sim

O acelerador de inferência elástica a ser usado.

Limitações de posicionamento de tarefa

Ao registrar uma definição de tarefa, você pode fornecer restrições de posicionamento de tarefa que personalizam como o Amazon ECS posiciona tarefas.

Se você estiver usando o tipo de inicialização do Fargate, não haverá suporte para restrições de posicionamento de tarefas. Por padrão, as tarefas do Fargate são distribuídas entre as zonas de disponibilidade.

Para tarefas que usam o tipo de inicialização do EC2, você pode usar restrições para inserir tarefas com base na zona de disponibilidade, no tipo de instância ou nos atributos personalizados. Para ter mais informações, consulte Defina quais instâncias de contêiner o Amazon ECS usa para tarefas.

Os parâmetros a seguir são permitidos em uma definição de contêiner.

expression

Tipo: string

Obrigatório: não

Uma expressão de idioma de consulta de cluster a ser aplicada à restrição. Para ter mais informações, consulte Crie expressões para definir instâncias de contêiner para tarefas do Amazon ECS.

type

Tipo: sequência

Obrigatório: Sim

O tipo de restrição. Use memberOf para restringir a seleção a um grupo de candidatos válidos.

Configuração do proxy

proxyConfiguration

Tipo: objeto ProxyConfiguration

Obrigatório: Não

Os detalhes de configuração do proxy do App Mesh.

Para as tarefas que usam o tipo de execução do EC2, as instâncias de contêiner exigem pelo menos a versão 1.26.0 do agente de contêiner e pelo menos a versão 1.26.0-1 do pacote ecs-init para habilitar uma configuração de proxy. Se as instâncias de contêiner forem executadas na AMI otimizada para o Amazon ECS versão 20190301 ou posterior, elas conterão as versões necessárias do agente de contêiner e do ecs-init. Para ter mais informações, consulte AMIs otimizadas para Amazon ECS.

Para tarefas que usam o tipo de inicialização do Fargate, esse recurso exige que a tarefa ou o serviço use a versão 1.3.0 ou posterior da plataforma.

nota

Este parâmetro não é compatível com contêineres do Windows.


"proxyConfiguration": {
    "type": "APPMESH",
    "containerName": "string",
    "properties": [
        {
           "name": "string",
           "value": "string"
        }
    ]
}

type

Tipo: sequência

Valor: APPMESH

Obrigatório: Não

O tipo de proxy. O único valor aceito é APPMESH.

containerName

Tipo: sequência

Obrigatório: Sim

O nome do contêiner que serve como proxy do App Mesh.

properties

Tipo: matriz de objetos KeyValuePair

Obrigatório: Não

O conjunto de parâmetros de configuração de rede para fornecer o plugin Container Network Interface (CNI), especificado como pares de chave/valor.

IgnoredUID: (obrigatório) o ID de usuário (UID) do contêiner de proxy conforme definido pelo parâmetro user em uma definição de contêiner. Isso é usado para garantir que o proxy ignore seu próprio tráfego. Se IgnoredGID for especificado, esse campo poderá estar vazio.
IgnoredGID: (obrigatório) o ID de grupo (GID) do contêiner de proxy conforme definido pelo parâmetro user em uma definição de contêiner. Isso é usado para garantir que o proxy ignore seu próprio tráfego. Se IgnoredUID for especificado, esse campo poderá estar vazio.
AppPorts: (obrigatório) a lista de portas usadas pelo aplicativo. O tráfego de rede para essas portas é encaminhado para ProxyIngressPort e ProxyEgressPort.
ProxyIngressPort: (obrigatório) especifica a porta para a qual o tráfego de entrada para AppPorts é direcionado.
ProxyEgressPort: (obrigatório) especifica a porta para a qual o tráfego de saída de AppPorts é direcionado.
EgressIgnoredPorts: (obrigatório) o tráfego de saída para essas portas especificadas é ignorado e não é redirecionado para ProxyEgressPort. Ele pode ser uma lista vazia.
EgressIgnoredIPs: (obrigatório) o tráfego de saída para esses endereços IP especificados é ignorado e não é redirecionado para ProxyEgressPort. Ele pode ser uma lista vazia.

name

Tipo: string

Obrigatório: não

O nome do par de chave/valor.

value

Tipo: string

Obrigatório: não

O valor do par de chave/valor.

Volumes

Ao registrar uma definição de tarefa, você pode especificar opcionalmente uma lista de volumes a serem passados para o Docker daemon em uma instância de contêiner, que então fica disponível para acesso por outros contêineres na mesma instância de contêiner.

A seguir estão os tipos de volumes de dados que podem ser usados.

Volumes do Amazon EBS — Fornece armazenamento em blocos econômico, durável e de alto desempenho para cargas de trabalho em contêineres com uso intenso de dados. Você pode anexar 1 volume do Amazon EBS por tarefa do Amazon ECS ao executar uma tarefa independente ou ao criar ou atualizar um serviço. Os volumes do Amazon EBS são compatíveis com tarefas Linux hospedadas em instâncias Fargate ou Amazon EC2. Para ter mais informações, consulte Volumes do Amazon EBS.
Volumes do Amazon EFS: oferece armazenamento de arquivos simples, escalável e persistente para uso com tarefas do Amazon ECS. Com o Amazon EFS, a capacidade de armazenamento é elástica. Ela aumenta e diminui automaticamente à medida que arquivos são adicionados e removidos. As aplicações podem ter o armazenamento de que precisam, quando precisam. Os volumes do Amazon EFS são compatíveis com tarefas hospedadas em instâncias do Fargate ou do Amazon EC2. Para ter mais informações, consulte Volumes do Amazon EFS.
Volumes do FSx para Windows File Server: fornece servidores de arquivos Microsoft Windows totalmente gerenciados. Esses servidores têm o suporte de um sistema de arquivos do Windows. Ao usar o FSx for Windows File Server junto com o Amazon ECS, você pode provisionar tarefas do Windows com armazenamento de arquivos persistente, distribuído, compartilhado e estático. Para ter mais informações, consulte Volumes do FSx for Windows File Server.

Não há suporte para essa opção nos contêineres do Windows no Fargate.
Volumes Docker — Um volume gerenciado pelo Docker que é criado na instância hospedeira do /var/lib/docker/volumes Amazon EC2. Drivers de volume do Docker (também conhecidos como plug-ins) são usados para integrar os volumes com sistemas de armazenamento externos, como o Amazon EBS. O driver de volume local integrado ou um driver de volume de terceiros podem ser usados. Os volumes do Docker são suportados somente ao executar tarefas em instâncias do Amazon EC2. Os contêineres do Windows oferecem suporte somente ao uso do local driver. Para usar os volumes do Docker, especifique uma dockerVolumeConfiguration em sua definição de tarefa. Para obter mais informações, consulte Usar volumes.
Montagens de vinculação — Um arquivo ou diretório na máquina host que está montado em um contêiner. Os volumes de host Bind Mount são suportados ao executar tarefas em instâncias do AWS Fargate ou do Amazon EC2. Para usar os volumes de host de montagens bind, especifique um host e um valor sourcePath opcional em sua definição de tarefa. Para obter mais informações, consulte Usar montagens bind.

Para ter mais informações, consulte Usar volumes de dados em tarefas.

Os parâmetros a seguir são permitidos em uma definição de contêiner.

name

Tipo: string

Obrigatório: não

O nome do volume. São permitidas até 255 letras (maiúsculas e minúsculas), números, hífens () e sublinhados (-). _ Esse nome é referenciado no sourceVolume parâmetro do mountPoints objeto de definição do contêiner.

host

Obrigatório: Não

O parâmetro host é usado para vincular o ciclo de vida da montagem bind à instância host do Amazon EC2, em vez da tarefa, e onde ela está armazenada. Caso o parâmetro host esteja vazio, o daemon do Docker atribui um caminho host para o volume de dados, mas os dados não têm garantia de persistir depois que os contêineres associados deixarem de ser executados.

Os contêineres do Windows podem montar diretórios inteiros na mesma unidade como $env:ProgramData.

nota

O sourcePath parâmetro é suportado somente ao usar tarefas hospedadas em instâncias do Amazon EC2.

sourcePath

Tipo: string

Obrigatório: não

Quando o parâmetro host é usado, especifique um sourcePath para declarar o caminho na instância host do Amazon EC2 que é apresentada ao contêiner. Caso esse parâmetro esteja vazio, o daemon do Docker atribui um caminho host para você. Caso o parâmetro host contenha um local de arquivo sourcePath, o volume de dados persistirá no local especificado na instância host do Amazon EC2 até você excluí-lo manualmente. Caso o valor sourcePath não exista na instância host do Amazon EC2, o daemon do Docker o criará. Caso o local exista, o conteúdo da pasta do caminho de origem é exportado.

configuredAtLaunch

Tipo: booliano

Obrigatório: não

Especifica se um volume é configurável na inicialização. Quando definido comotrue, você pode configurar o volume ao executar uma tarefa autônoma ou ao criar ou atualizar um serviço. Quando definido comotrue, você não poderá fornecer outra configuração de volume na definição da tarefa. Esse parâmetro deve ser definido true para configurar um volume do Amazon EBS para anexação a uma tarefa. configuredAtLaunchDefinir true e adiar a configuração do volume para a fase de inicialização permite criar definições de tarefas que não estão restritas a um tipo de volume ou a configurações de volume específicas. Isso torna sua definição de tarefa reutilizável em diferentes ambientes de execução. Para obter mais informações, consulte Volumes do Amazon EBS.

dockerVolumeConfiguration

Tipo: DockerVolumeConfigurationObjeto

Obrigatório: Não

Esse parâmetro é especificado ao usar volumes do Docker. Os volumes do Docker são suportados somente ao executar tarefas em instâncias do EC2. Os contêineres do Windows oferecem suporte somente ao uso do local driver. Para usar montagens bind, em vez disso, especifique um host.

scope

Tipo: sequência

Valores válidos: task | shared

Obrigatório: Não

O escopo para o volume do Docker, que determina o ciclo de vida. Os volumes do Docker que são delimitados para uma task são provisionados automaticamente quando a tarefa é iniciada e destruídos quando a tarefa é interrompida. Volumes do Docker delimitados como shared são mantidos após a interrupção da tarefa.

autoprovision

Tipo: booliano

Valor padrão: false

Obrigatório: Não

Se o valor for true, o volume de Docker será criado se ele ainda não existir. Esse campo é usado somente se scope forshared. Se scope fortask, esse parâmetro deverá ser omitido ou definido como. false

driver

Tipo: string

Obrigatório: não

O driver do volume do Docker a ser usado. O valor do driver deve corresponder ao nome do driver fornecido pelo Docker porque esse nome é usado para posicionamento de tarefas. Se o driver foi instalado usando a CLI do plug-in Docker, docker plugin ls use para recuperar o nome do driver da sua instância de contêiner. Se o driver foi instalado usando outro método, use a descoberta do plug-in Docker para recuperar o nome do driver. Para obter mais informações, consulte Descoberta de plugin do Docker. Esse parâmetro é mapeado para Driver na seção Criar um volume da API remota do Docker e a opção --driver para docker volume create.

driverOpts

Tipo: string

Obrigatório: não

Um mapa das opções específicas do driver Docker a serem percorridas. Esse parâmetro é mapeado para DriverOpts na seção Criar um volume da API remota do Docker e a opção --opt para docker volume create.

labels

Tipo: string

Obrigatório: não

Metadados personalizados para adicionar ao volume do Docker. Esse parâmetro é mapeado para Labels na seção Criar um volume da API remota do Docker e a opção --label para docker volume create.

efsVolumeConfiguration

Tipo: VolumeConfiguration Objeto EFS

Obrigatório: Não

Esse parâmetro é especificado quando volumes Amazon EFS são usados.

fileSystemId

Tipo: sequência

Obrigatório: Sim

A ID do sistema de arquivamento Amazon EFS a ser usada.

rootDirectory

Tipo: string

Obrigatório: Não

O diretório dentro do sistema de arquivamento Amazon EFS a ser montado como diretório raiz dentro do host. Se esse parâmetro for omitido, a raiz do volume do Amazon EFS será usada. Especificar / tem o mesmo efeito que omitir esse parâmetro.

Importante

Se um ponto de acesso do EFS for especificado noauthorizationConfig, o parâmetro do diretório raiz deverá ser omitido ou definido como/, o que imporá o caminho definido no ponto de acesso do EFS.

transitEncryption

Tipo: sequência

Valores válidos: ENABLED | DISABLED

Obrigatório: Não

Especifica se a criptografia deve ou não ser habilitada para dados do Amazon EFS em trânsito entre o host do Amazon ECS e o servidor do Amazon EFS. A criptografia de trânsito deverá ser habilitada se a autorização do IAM do Amazon EFS for usada. Se o parâmetro for omitido, o valor padrão DISABLED será usado. Para obter mais informações, consulte Criptografar dados em trânsito no Guia do usuário do Amazon Elastic File System.

transitEncryptionPort

Tipo: inteiro

Obrigatório: não

A porta a ser usada ao enviar dados criptografados entre o host do Amazon ECS e o servidor do Amazon EFS. Se você não especificar uma porta de criptografia de trânsito, a tarefa usará a estratégia de seleção de portas usada pelo auxiliar de montagem do Amazon EFS. Para mais informações, consulte Auxiliar de Montagem EFS no Guia de Usuário Amazon Elastic File System.

authorizationConfig

Tipo: AuthorizationConfiguration Objeto EFS

Obrigatório: Não

Detalhes de configuração de autorização do sistema de arquivamento Amazon EFS.

accessPointId

Tipo: Sequência

Obrigatório: não

ID do ponto de acesso a ser usado. Se um ponto de acesso for especificado, o valor do diretório raiz no efsVolumeConfiguration deverá ser omitido ou definido como/, o que imporá o caminho definido no ponto de acesso EFS. Se um ponto de acesso for usado, a criptografia em trânsito deverá ser habilitada em EFSVolumeConfiguration. Para mais informações, consulte Trabalhando com Pontos de Acesso Amazon EFS no Guia de Usuário Amazon Elastic File System.

iam

Tipo: sequência

Valores válidos: ENABLED | DISABLED

Obrigatório: Não

Especifica se a função IAM de tarefa do Amazon ECS deve ser usada que está definida em uma definição de tarefa ao montar o sistema de arquivos do Amazon EFS. Em caso positivo, a criptografia de trânsito deve estar habilitada em EFSVolumeConfiguration. Se o parâmetro for omitido, o valor padrão DISABLED será usado. Para obter mais informações, consulte Funções do IAM para tarefas.

FSxWindowsFileServerVolumeConfiguration

Tipo: SxWindowsFileServerVolumeConfiguration Objeto F

Obrigatório: Sim

Esse parâmetro é especificado quando você está usando um sistema de arquivos Amazon FSx for Windows File Server para armazenamento de tarefas.

fileSystemId

Tipo: sequência

Obrigatório: Sim

O ID do sistema de arquivos do FSx for Windows File Server a ser usado.

rootDirectory

Tipo: sequência

Obrigatório: Sim

O diretório no sistema de arquivos do FSx for Windows File Server que deve ser montado como o diretório raiz dentro do host.

authorizationConfig

credentialsParameter

Tipo: sequência

Obrigatório: Sim

As opções de credencial de autorização.

opções:

Nome de recurso da Amazon (ARN) de um AWS Secrets Managersegredo.
ARN de um AWS Systems Managerparâmetro.

domain

Tipo: sequência

Obrigatório: Sim

Um nome de domínio totalmente qualificado hospedado por um diretório AWS Directory Service for Microsoft Active Directory(AWS Managed Microsoft AD) ou por um EC2 Active Directory auto-hospedado.

Outros parâmetros de definição de tarefa

Os parâmetros de definição de tarefa a seguir podem ser usados durante o registro das definições de tarefa no console do Amazon ECS usando a opção Configure via JSON (Configurar via JSON). Para ter mais informações, consulte Criação de uma definição de tarefa usando o console.

Tópicos

Armazenamento temporário
Modo IPC
Modo PID

Armazenamento temporário

ephemeralStorage

Tipo: objeto EphemeralStorage

Obrigatório: Não

A quantidade de armazenamento temporário (em GB) a ser alocado para a tarefa. Esse parâmetro é usado para expandir a quantidade total de armazenamento temporário, além da quantidade padrão, para tarefas hospedadas no AWS Fargate. Para ter mais informações, consulte Montagens bind.

nota

Só há suporte para este parâmetro em tarefas hospedadas no AWS Fargate que usem a versão da plataforma 1.4.0 ou posterior (Linux), ou 1.0.0 ou posterior (Windows).

Modo IPC

ipcMode

Tipo: string

Obrigatório: não

O namespace de recurso IPC a ser usado para os contêineres na tarefa. Os valores válidos são host, task ou none. Se o host for especificado, todos os contêineres dentro das tarefas que especificaram o modo IPC host na mesma instância de contêiner compartilham os mesmos recursos IPC com a instância do Amazon EC2 do host. Se task for especificado, todos os contêineres dentro da tarefa especificada compartilharão os mesmos recursos IPC. Se none for especificado, os recursos IPC nos contêineres de uma tarefa serão privados e não serão compartilhados com outros contêineres em uma tarefa ou na instância de contêiner. Se nenhum valor for especificado, o compartilhamento do namespace de recurso IPC dependerá da configuração do daemon do Docker na instância de contêiner. Para obter mais informações, consulte Configurações IPC na Referência de execução do Docker.

Se o modo IPC host for usado, haverá um risco elevado de exposição indesejada do namespace IPC. Para obter mais informações, consulte Segurança do Docker.

Se você estiver definindo parâmetros de kernel com namespace que usa systemControls para os contêineres na tarefa, os itens a seguir serão aplicados ao seu namespace de recurso IPC. Para ter mais informações, consulte Controles do sistema.

Para tarefas que usam o modo IPC host, o namespace IPC relacionado systemControls não é compatível.
Para tarefas que usam o modo IPC task, systemControls relacionados ao namespace IPC serão aplicados a todos os contêineres em uma tarefa.

nota

Esse parâmetro não é compatível com os contêineres do Windows ou tarefas que usam o tipo de inicialização Fargate.

Modo PID

pidMode

Tipo: sequência

Valores válidos: host | task

Obrigatório: Não

O namespace do processo a ser usado para os contêineres na tarefa. Os valores válidos são host ou task. Nos contêineres Fargate para Linux, o único valor válido é task. Por exemplo, o monitoramento de arquivos associados pode precisar que pidMode acesse informações sobre outros contêineres em execução na mesma tarefa.

Se o host for especificado, todos os contêineres das tarefas que especificaram o modo PID host na mesma instância de contêiner compartilharão namespace de processo com a instância do Amazon EC2 do host.

Se a task for especificada, todos os contêineres da tarefa especificada compartilharão o mesmo namespace de processo.

Se nenhum valor for especificado, o padrão será um namespace privado para cada contêiner. Para obter mais informações, consulte Configurações PID na Referência de execução do Docker.

Se o modo PID host for usado, haverá um risco elevado de exposição indesejada do namespace de processo. Para obter mais informações, consulte Segurança do Docker.

nota

Este parâmetro não é compatível com contêineres do Windows.

nota

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Referências de parâmetros e modelos de recursos

Modelo de definição de tarefa