Amazon Elastic Container Service - AWS CodePipeline

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Amazon Elastic Container Service

Você pode usar uma ação do Amazon ECS para implantar um serviço e um conjunto de tarefas do Amazon ECS. Um serviço do Amazon ECS é um aplicativo de contêiner implantado em um cluster do Amazon ECS. Um cluster do Amazon ECS é um conjunto de instâncias que hospedam seu aplicativo de contêiner na nuvem. A implantação requer uma definição de tarefa criada no Amazon ECS e um arquivo de definições de imagem que o CodePipeline usa para implantar a imagem.

Antes de criar seu pipeline, você já deve ter criado os recursos do Amazon ECS, marcado e armazenado a imagem em seu repositório de imagens e carregado o arquivo BuildSpec no repositório de arquivos.

nota

Este tópico de referência descreve a ação de implantação padrão do Amazon ECS para CodePipeline. Para obter informações de referência sobre ações de implantação azul/verde do Amazon ECS para CodeDeploy no CodePipeline, consulteAmazon Elastic Container Service e CodeDeploy azul-verde.

Tipo de ação

  • Categoria: Deploy

  • Proprietário: AWS

  • Fornecedor:ECS

  • Versão:1

Parâmetros de configuração

ClusterName

: obrigatório Sim

O cluster do Amazon ECS no Amazon ECS.

ServiceName

: obrigatório Sim

O serviço do Amazon ECS que você criou no Amazon ECS.

FileName

: obrigatório Não

O nome do contêiner e a imagem e tag do serviço do. Use esse arquivo para implantações padrão do ECS. Para obter mais informações, consulte Artefatos de entrada e Arquivo imagedefinitions.json para ações de implantação padrão do Amazon ECS.

DeploymentTimeout

: obrigatório Não

O tempo limite da ação de implantação do Amazon ECS em minutos. O tempo limite é configurável até o tempo limite padrão máximo para essa ação. Por exemplo:

"DeploymentTimeout": "15"

Artefatos de entrada

  • Número de artefatos: 1

  • Descrição: A ação procura umimagedefinitions.jsonno repositório de arquivos de origem do pipeline. Um documento de definições de imagem é um arquivo JSON que descreve o nome do contêiner e a imagem e tag do Amazon ECS. O CodePipeline usa o arquivo para recuperar a imagem do repositório de imagens, como o Docker Hub ou o Amazon ECR. Você pode adicionar manualmente umimagedefinitions.jsonpara um pipeline onde a ação não é automatizada. Para mais informações sobre o arquivo imagedefinitions.json, consulte Arquivo imagedefinitions.json para ações de implantação padrão do Amazon ECS.

    A ação requer uma imagem existente que já tenha sido enviada para o repositório de imagens. Como o mapeamento de imagem é fornecido pelo métodoimagedefinitions.json, a ação não exige que a origem do Amazon ECR seja incluída como uma ação de origem no pipeline.

Artefatos de saída

  • Número de artefatos: 0

  • Descrição: Os artefatos de saída não se aplicam a esse tipo de ação.

Declaração de ação

YAML
Name: DeployECS ActionTypeId: Category: Deploy Owner: AWS Provider: ECS Version: '1' RunOrder: 2 Configuration: ClusterName: my-ecs-cluster ServiceName: sample-app-service FileName: imagedefinitions.json DeploymentTimeout: '15' OutputArtifacts: [] InputArtifacts: - Name: my-image
JSON
{ "Name": "DeployECS", "ActionTypeId": { "Category": "Deploy", "Owner": "AWS", "Provider": "ECS", "Version": "1" }, "RunOrder": 2, "Configuration": { "ClusterName": "my-ecs-cluster", "ServiceName": "sample-app-service", "FileName": "imagedefinitions.json", "DeploymentTimeout": "15" }, "OutputArtifacts": [], "InputArtifacts": [ { "Name": "my-image" } ] },

Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.

  • Tutorial: implantação contínua com CodePipeline— Este tutorial mostra como criar um Dockerfile que você armazena em um repositório de arquivos de origem, como CodeCommit. Em seguida, o tutorial mostra como incorporar um arquivo CodeBuild BuildSpec que cria e envia sua imagem do Docker para o Amazon ECR e cria seu arquivo.json imagedefinitions.json. Finalmente, você cria um serviço e definição de tarefa do Amazon ECS e, em seguida, cria seu pipeline com uma ação de implantação do Amazon ECS.

    nota

    Este tópico e tutorial descrevem a ação de implantação padrão do Amazon ECS para CodePipeline. Para obter informações sobre ações de implantação azul/verde do Amazon ECS to CodeDeploy no CodePipeline, consulteTutorial: Criar um pipeline com a origem do Amazon ECR e a implantação do ECS para CodeDeploy.

  • Amazon Elastic Container Service Develer— Para obter informações sobre como trabalhar com imagens e contêineres do Docker, serviços e clusters do Amazon ECS e conjuntos de tarefas do Amazon ECS, consulteO que é Amazon ECS?