Criação de uma definição de tarefa usando o console clássico - Amazon ECS

Criação de uma definição de tarefa usando o console clássico

O console clássico do Amazon ECS está chegando ao fim da vida útil e não estará mais disponível após 4 de dezembro de 2023. Recomendamos que você mude imediatamente para o novo console do Amazon ECS para uma melhor experiência. É possível revisar e seguir o novo roteiro do console do Amazon ECS no GitHub.
Importante

O Amazon ECS forneceu uma nova experiência de console para a criação de definições de tarefa. Para obter mais informações, consulte Criação de uma definição de tarefa usando o console.

Você deve usar o novo console para criar uma definição de tarefa para contêineres do Windows no Fargate com o sistema operacional WINDOWS_SERVER_2022_FULL ou WINDOWS_SERVER_2022_CORE.

Antes de executar contêineres do Docker no Amazon ECS, você precisa criar uma definição de tarefa. Ao criar uma definição de tarefa, você pode usá-la para definir vários contêineres e volumes de dados. Para obter mais informações sobre os parâmetros disponíveis para definições de tarefa, consulte Parâmetros de definição de tarefa.

Para criar uma nova definição de tarefa (console clássico do Amazon ECS)

  1. Abra o console clássico do Amazon ECS em https://console.aws.amazon.com/ecs/.

  2. No painel de navegação, escolha task definitions (definições de tarefa), Create new task definition (Criar nova definição de tarefa).

  3. Na página Selecionar compatibilidades do tipo de inicialização, escolha FARGATE e, em seguida, Next step (Próxima etapa).

  4. (Opcional) Se você tem uma representação JSON da sua definição de tarefa, conclua as seguintes etapas:

    1. Na página Configure task and container definitions (Configurar tarefa e definições de contêiner), vá até o final da página e escolha Configure via JSON (Configurar via JSON).

    2. Cole o JSON de definição de tarefa na área de texto e escolha Save (Salvar).

    3. Verifique suas informações e escolha Create (Criar).

    Role para o final da página e escolha Configure via JSON (Configurar via JSON).

  5. Em Task Definition Name (Nome de definição de tarefa), digite um nome para a sua definição de tarefa. São permitidos até 255 letras (caixa alta e baixa), números, hífens e sublinhados.

  6. Em Operating system family (Família do sistema operacional), escolha o sistema operacional do contêiner.

  7. Em Task execution IAM role (Função do IAM de execução da tarefa), selecione a função de execução da tarefa ou escolha Create new role (Criar nova função) para que o console possa criar uma para você. Para obter mais informações, consulte Função do IAM de execução de tarefas do Amazon ECS.

  8. Em Task size, escolha um valor para Task memory (GB) e Task CPU (vCPU). A tabela a seguir mostra as combinações válidas.

    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

  9. Para cada contêiner da sua definição de tarefa, conclua as seguintes etapas:

    1. Escolha Add container.

    2. Preencha todos os campos obrigatórios e os campos opcionais a serem usados nas suas definições de contêiner. Mais parâmetros de definição de contêiner estão disponíveis no menu Advanced container configuration (Configuração avançada de contêineres). Para obter mais informações, consulte Parâmetros de definição de tarefa.

    3. Escolha Add para adicionar o contêiner à definição de tarefa.

  10. (Opcional) Em Service Integration (Integração de serviços), para configurar os parâmetros para integração com o App Mesh, escolha Enable App Mesh integration (Habilitar integração com o App Mesh) e faça o seguinte:

    1. Em Mesh name (Nome da malha), escolha a malha de serviço do App Mesh a ser usada. Se não houver malhas listadas, você precisará criar uma, primeiramente. Para obter mais informações, consulte Malhas de serviços no Guia do usuário do AWS App Mesh.

      nota

      Essa opção não está disponível para contêineres de Windows no Fargate.

    2. Em App Mesh endpoints (Endpoints do App Mesh), digite uma das seguintes opções.

      • Virtual node (Nó virtual): insira ou selecione as seguintes informações.

        • Em Application container name (Nome do contêiner da aplicação), escolha o nome do contêiner a ser usado para a integração do App Mesh. Esse contêiner já deve estar definido na definição da tarefa.

        • Em Virtual node name (Nome do nó virtual), escolha o nó virtual existente do App Mesh a ser usado. Se não houver nós virtuais listados, você precisará criar um, primeiramente. Para obter mais informações, consulte Nós virtuais no Guia do usuário do AWS App Mesh.

        • Em Virtual node port (Porta do nó virtual): preenchido com a porta do listener definida no nó virtual do App Mesh.

      • Virtual gateway (Gateway virtual): insira ou selecione as seguintes informações.

        • Em Virtual gateway name (Nome do gateway virtual), escolha o gateway virtual existente do App Mesh a ser usado. Se não houver gateways virtuais listados, você precisará criar um, primeiramente. Para obter mais informações, consulte Gateways virtuais no Guia do usuário do AWS App Mesh.

        • Em Virtual gateway port (Porta do gateway virtual): preenchido com a porta do listener definida no gateway virtual do App Mesh.

    3. Em Envoy image (Imagem do Envoy), insira 840364872350.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy:v1.15.1.0-prod para todas as regiões, exceto me-south-1 e ap-east-1. É possível substituir us-west-2 por qualquer região, exceto me-south-1 e ap-east-1. Se sua aplicação estiver em uma dessas regiões, você também precisará substituir 840364872350 pelo valor apropriado para sua região. Para obter mais informações, consulte Envoy image (Imagem do Envoy) no Guia do usuário do AWS App Mesh.

    4. Escolha Apply (Aplicar) e, em seguida, Confirm (Confirmar). Isso adicionará um contêiner do proxy do Envoy à definição de tarefa, assim como as configurações para oferecer suporte a ela. Se você tiver selecionado Virtual node (Nó virtual), ele também preencherá automaticamente as definições da Proxy Configuration (Configuração do proxy) do App Mesh para a próxima etapa. Se você tiver selecionado Virtual gateway (Gateway virtual), a Proxy Configuration (Configuração do proxy) estará desativada, pois não é usada para um gateway virtual.

  11. (Opcional) Se você tiver selecionado Virtual node (Nó virtual) em Service Integration (Integração de serviços), em Proxy Configuration (Configuração do proxy) verifique todos os valores pré-preenchidos. Para obter mais informações sobre esses campos, consulte a guia JSON em Update services (Serviços de atualização).

  12. (Opcional) Em Log Router Integration (Integração do roteador de log), você pode adicionar uma configuração de roteamento de log personalizada. Escolha Enable FireLens integration (Habilitar a integração do FireLens) e faça o seguinte:

    nota

    Essa opção não está disponível para contêineres de Windows no Fargate.

    1. Em Type (Tipo), escolha o tipo de roteador de log a ser usado.

    2. Em Image (Imagem), digite o URI da imagem do contêiner do roteador de log. Se você tiver escolhido o tipo de roteador de log,fluentbit o campo Image (Imagem) será pré-preenchido com a imagem da AWS for Fluent Bit. Para obter mais informações, consulte Uso da imagem do AWS for Fluent Bit.

    3. Escolha Apply (Aplicar). Isso cria um novo contêiner de roteador de log para a definição de tarefa denominado log_router e aplica as configurações para dar suporte a ele. Se você fizer alterações nos campos de integração do roteador de log, escolha novamente Aply (Aplicar) para atualizar o contêiner do FireLens.

  13. (Opcional) Para definir volumes de dados para sua tarefa, escolha Add volume (Adicionar volume). Para obter mais informações, consulte Usar volumes de dados em tarefas.

    1. Em Name (Nome), digite um nome para o volume. São permitidos até 255 letras (caixa alta e baixa), números, hífens e sublinhados.

  14. Na seção Etiquetas, especifique a chave e o valor de cada etiqueta a ser associada à definição de tarefa. Para obter mais informações, consulte Marcação dos recursos do Amazon ECS.

  15. Escolha Create (Criar).

Para criar uma nova definição de tarefa (AWS CLI)

  • Use o comando register-task-definition. Para obter mais informações, consulte register-task-definition, na Referência da AWS Command Line Interface.