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á. # Crie uma implantação com CodeDeploy Você pode usar o CodeDeploy console AWS CLI, o ou as CodeDeploy APIs para criar uma implantação que instale revisões de aplicativos que você já enviou para o Amazon S3 ou, se sua implantação for em uma plataforma computacional EC2/local, GitHub nas instâncias em um grupo de implantação. O processo para criar uma implantação depende da plataforma de computação usada para a sua implantação. **Topics** + [Pré-requisitos de implantação](deployments-create-prerequisites.md) + [Criar uma implantação da plataforma de computação do Amazon ECS (console)](deployments-create-console-ecs.md) + [Crie uma implantação da AWS Lambda Compute Platform (console)](deployments-create-console-lambda.md) + [Componentes de implantação em uma plataforma de computação EC2/On-Premises (console)](deployments-create-console.md) + [Crie uma implantação da Amazon ECS Compute Platform (CLI)](deployments-create-ecs-cli.md) + [Crie uma implantação da AWS Lambda Compute Platform (CLI)](deployments-create-lambda-cli.md) + [Criar uma implantação de plataforma de computação de EC2/On-Premises (CLI)](deployments-create-cli.md) + [Crie uma blue/green implantação do Amazon ECS por meio de CloudFormation](deployments-create-ecs-cfn.md) # Pré-requisitos de implantação Verifique se as etapas a seguir estão concluídas para iniciar uma implantação. ## Pré-requisitos de implantação em uma plataforma computacional AWS Lambda + Crie um aplicativo que inclua pelo menos um grupo de implantação. Para obter informações, consulte [Crie um aplicativo com CodeDeploy](applications-create.md) e [Crie um grupo de implantação com CodeDeploy](deployment-groups-create.md). + Prepare a revisão do aplicativo, também conhecida como AppSpec arquivo, que especifica a versão da função Lambda que você deseja implantar. O AppSpec arquivo também pode especificar funções do Lambda para validar sua implantação. Para obter mais informações, consulte [Trabalhando com revisões de aplicativos para CodeDeploy](application-revisions.md). + Para usar uma configuração de implantação personalizada para a sua implantação, crie-a antes de iniciar o processo de implantação. Para mais informações, consulte [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md). ## Pré-requisitos de implantação em uma plataforma de computação EC2/On-Premises + Para uma implantação no local, crie ou configure as instâncias nas quais você deseja implantar. Para mais informações, consulte [Trabalhando com instâncias para CodeDeploy](instances.md). Para uma blue/green implantação, você tem um grupo existente do Amazon EC2 Auto Scaling para usar como modelo para seu ambiente substituto, ou você tem uma ou mais instâncias ou grupos do Amazon EC2 Auto Scaling que você especifica como seu ambiente original. Para obter mais informações, consulte [Tutorial: Use CodeDeploy para implantar um aplicativo em um grupo do Auto Scaling](tutorials-auto-scaling-group.md) e [Integração CodeDeploy com o Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md). + Crie um aplicativo que inclua pelo menos um grupo de implantação. Para obter informações, consulte [Crie um aplicativo com CodeDeploy](applications-create.md) e [Crie um grupo de implantação com CodeDeploy](deployment-groups-create.md). + Prepare a revisão do aplicativo que deseja implantar nas instâncias do seu grupo de implantação. Para mais informações, consulte [Trabalhando com revisões de aplicativos para CodeDeploy](application-revisions.md). + Para usar uma configuração de implantação personalizada para a sua implantação, crie-a antes de iniciar o processo de implantação. Para mais informações, consulte [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md). + Se você estiver implantando a revisão do seu aplicativo a partir de um bucket do Amazon S3, o bucket estará na AWS mesma região das instâncias do seu grupo de implantação. + Se você estiver implantando sua revisão de aplicativo de um bucket do Amazon S3, uma política de bucket do Amazon S3 foi aplicada a ele. Essa política concede às suas instâncias as permissões necessárias para baixar a revisão de aplicativo. Por exemplo, a seguinte política de bucket do Amazon S3 permite que qualquer instância do Amazon EC2 com um perfil de instância anexado do IAM contendo o ARN `arn:aws:iam::444455556666:role/CodeDeployDemo` para fazer o download de qualquer lugar no bucket do Amazon S3 chamado de `amzn-s3-demo-bucket`. ``` { "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Effect": "Allow", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*", "Principal": { "AWS": [ "arn:aws:iam::444455556666:role/CodeDeployDemo" ] } } ] } ``` A seguinte política do bucket Amazon S3 permite que qualquer instância On-Premises com um usuário do IAM associado, contendo o ARN do `arn:aws:iam::444455556666:user/CodeDeployUser` para que seja feito o download de qualquer lugar no bucket do Amazon S3 chamado de `amzn-s3-demo-bucket`. ``` { "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Effect": "Allow", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*", "Principal": { "AWS": [ "arn:aws:iam::444455556666:user/CodeDeployUser" ] } } ] } ``` Para obter informações sobre como gerar e anexar uma política de bucket do Amazon S3, consulte [Exemplos de políticas de bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html). + Se você estiver criando uma blue/green implantação ou tiver especificado um Classic Load Balancer, Application Load Balancer ou Network Load Balancer opcional no grupo de implantação para uma implantação local, você criou uma VPC usando a Amazon VPC que contém pelo menos duas sub-redes. (CodeDeploy usa o Elastic Load Balancing, que exige que todas as instâncias em um grupo de balanceadores de carga estejam em uma única VPC.) Se você ainda não criou uma VPC, consulte o Guia de conceitos básicos da [Amazon VPC](https://docs.aws.amazon.com/AmazonVPC/latest/GettingStartedGuide/ExerciseOverview.html). + Se estiver criando uma blue/green implantação, você configurou pelo menos um Classic Load Balancer, Application Load Balancer ou Network Load Balancer no Elastic Load Balancing e o usou para registrar as instâncias que compõem seu ambiente original. **nota** As instâncias no seu ambiente de substituição serão registradas nesse balanceador de carga mais tarde. Para obter mais informações sobre as opções de configuração do balanceador de carga, consulte [Configure um balanceador de carga no Elastic Load Balancing para implantações do Amazon CodeDeploy EC2](deployment-groups-create-load-balancer.md) e [Configure um balanceador de carga, grupos-alvo e ouvintes para implantações do CodeDeploy Amazon ECS](deployment-groups-create-load-balancer-for-ecs.md). ## Pré-requisitos de implantação para uma implantação por meio de blue/green CloudFormation + Seu modelo não precisa modelar recursos para um CodeDeploy aplicativo ou grupo de implantação. + Seu modelo deve incluir recursos para uma VPC usando a Amazon VPC que contenha pelo menos duas sub-redes. + Seu modelo deve incluir recursos para um ou mais Classic Load Balancer, Application Load Balancer ou Network Load Balancer no Elastic Load Balancing que são usados para direcionar o tráfego para seus grupos-alvo. # Criar uma implantação da plataforma de computação do Amazon ECS (console) Este tópico mostra como implantar um Amazon ECS usando o console. Para obter mais informações, consulte [Tutorial: Implantar um aplicativo no Amazon ECS](tutorial-ecs-deployment.md) e [Tutorial: Implantar um serviço do Amazon ECS com um teste de validação](tutorial-ecs-deployment-with-hooks.md). 1. Faça login no Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy). **nota** Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md). 1. Execute um destes procedimentos: + Se você desejar implantar um aplicativo, no painel de navegação, expanda **Implantar** e escolha **Aplicativos**. Escolha o nome do aplicativo que você deseja implantar. Certifique-se de que a coluna **Plataforma de computação** para o seu aplicativo seja **Amazon ECS**. + Se você deseja reimplantar uma implantação, no painel de navegação, expanda **Implantar** e escolha **Implantações**. Escolha a implantação que você deseja reimplantar e, na coluna **Aplicação**, escolha o nome do aplicativo. Certifique-se de que a coluna **Plataforma de computação** para a sua implantação seja **Amazon ECS**. 1. Na guia **Implantações**, selecione **Criar implantação**. **nota** Seu aplicativo deve ter um grupo de implantação antes de poder ser implantado. Se seu aplicativo não tiver um grupo de implantação, na guia **Grupos de implantação**, escolha **Criar grupo de implantação**. Para obter mais informações, consulte [Crie um grupo de implantação com CodeDeploy](deployment-groups-create.md). 1. Em **Grupo de implantação**, escolha um grupo de implantação para usar nesta implantação. 1. Ao lado de **Local de revisão**, escolha onde a sua revisão está localizada: + **Meu aplicativo está armazenado no Amazon S3**: para obter informações, consulte [Especificar informações sobre uma revisão armazenada em um bucket do Amazon S3](deployments-create-console-s3.md) e em seguida retorne à etapa 6. + **Usar AppSpec editor** — Selecione JSON ou YAML e, em seguida, insira seu AppSpec arquivo no editor. Você pode salvar o AppSpec arquivo escolhendo **Salvar como arquivo de texto**. Ao escolher **Implantar** no final dessas etapas, você receberá um erro se o JSON ou o YAML não for válido. Para obter mais informações sobre a criação de um AppSpec arquivo, consulte[Adicionar um arquivo de especificação do aplicativo a uma revisão do CodeDeploy](application-revisions-appspec-file.md). 1. (Opcional) Em **Descrição da implantação**, digite uma descrição para esta implantação. 1. (Opcional) Em **Substituições de configurações de reversão**, você pode especificar opções de reversão automática para essa implantação diferentes daquelas que foram especificadas para o grupo de implantação, se houver. Para obter informações sobre reversões em CodeDeploy, consulte e. [Reimplantações e reversões de implantação](deployment-steps-lambda.md#deployment-rollback-lambda) [Reimplante e reverta uma implantação com CodeDeploy](deployments-rollback-and-redeploy.md) Escolha uma das seguintes opções: + **Reverta quando uma implantação falha** — CodeDeploy reimplanta a última revisão válida conhecida como uma nova implantação. + **Reverter quando os limites de alarme forem atingidos** — Se os alarmes foram adicionados ao grupo de implantação, CodeDeploy reimplanta a última revisão válida quando um ou mais dos alarmes especificados forem ativados. + **Desativar reversões**: não execute reversões para esta implantação. 1. Escolha **Criar implantação**. Para acompanhar o status da sua implantação, consulte [Exibir detalhes CodeDeploy da implantação](deployments-view-details.md). # Crie uma implantação da AWS Lambda Compute Platform (console) Este tópico mostra como implantar uma função do Lambda usando o console. 1. Faça login no Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy). **nota** Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md). 1. Execute um destes procedimentos: + Se você desejar implantar um aplicativo, no painel de navegação, expanda **Implantar** e escolha **Aplicativos**. Escolha o nome do aplicativo que você deseja implantar. Certifique-se de que a coluna **Plataforma de computação** para o seu aplicativo seja **AWS Lambda**. + Se você deseja reimplantar uma implantação, no painel de navegação, expanda **Implantar** e escolha **Implantações**. Escolha a implantação que você deseja reimplantar e, na coluna **Aplicação**, escolha o nome do aplicativo. Certifique-se de que a coluna da **plataforma de computação** para sua implantação seja **AWS Lambda**. 1. Na guia **Implantações**, selecione **Criar implantação**. **nota** Seu aplicativo deve ter um grupo de implantação antes de poder ser implantado. Se seu aplicativo não tiver um grupo de implantação, na guia **Grupos de implantação**, escolha **Criar grupo de implantação**. Para obter mais informações, consulte [Crie um grupo de implantação com CodeDeploy](deployment-groups-create.md). 1. Em **Grupo de implantação**, escolha um grupo de implantação para usar nesta implantação. 1. Ao lado de **Local de revisão**, escolha onde a sua revisão está localizada: + **Meu aplicativo está armazenado no Amazon S3**: para obter informações, consulte [Especificar informações sobre uma revisão armazenada em um bucket do Amazon S3](deployments-create-console-s3.md) e em seguida retorne à etapa 6. + **Usar AppSpec editor** — Selecione JSON ou YAML e, em seguida, insira seu AppSpec arquivo no editor. Você pode salvar o AppSpec arquivo escolhendo **Salvar como arquivo de texto**. Ao escolher **Implantar** no final dessas etapas, você receberá um erro se o JSON ou o YAML não for válido. Para obter mais informações sobre a criação de um AppSpec arquivo, consulte[Adicionar um arquivo de especificação do aplicativo a uma revisão do CodeDeploy](application-revisions-appspec-file.md). 1. (Opcional) Em **Descrição da implantação**, digite uma descrição para esta implantação. 1. (Opcional) Expanda **Substituições de grupos de implantação** para escolher uma configuração de implantação diferente para controlar como o tráfego é passado para a versão da função do Lambda diferente do que a especificada no grupo de implantação. Para obter mais informações, consulte [Configurações de implantação em uma plataforma de AWS Lambda computação](deployment-configurations.md#deployment-configuration-lambda). 1. (Opcional) Em **Substituições de configurações de reversão**, você pode especificar opções de reversão automática para essa implantação diferentes daquelas que foram especificadas para o grupo de implantação, se houver. Para obter informações sobre reversões em CodeDeploy, consulte e. [Reimplantações e reversões de implantação](deployment-steps-lambda.md#deployment-rollback-lambda) [Reimplante e reverta uma implantação com CodeDeploy](deployments-rollback-and-redeploy.md) Escolha uma das seguintes opções: + **Reverta quando uma implantação falha** — CodeDeploy reimplanta a última revisão válida conhecida como uma nova implantação. + **Reverter quando os limites de alarme forem atingidos** — Se os alarmes foram adicionados ao grupo de implantação, CodeDeploy reimplanta a última revisão válida quando um ou mais dos alarmes especificados forem ativados. + **Desativar reversões**: não execute reversões para esta implantação. 1. Escolha **Criar implantação**. Para acompanhar o status da sua implantação, consulte [Exibir detalhes CodeDeploy da implantação](deployments-view-details.md). # Componentes de implantação em uma plataforma de computação EC2/On-Premises (console) Este tópico mostra como implantar um aplicativo em um servidor do Amazon EC2 ou on-premises usando o console. 1. Faça login no Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy). **nota** Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md). 1. Execute um destes procedimentos: + Se você desejar implantar um aplicativo, no painel de navegação, expanda **Implantar** e escolha **Aplicativos**. Escolha o nome do aplicativo que você deseja implantar. Certifique-se de que a coluna **Plataforma de computação** para o seu aplicativo seja **EC2/On-Premises**. + Se você deseja reimplantar uma implantação, no painel de navegação, expanda **Implantar** e escolha **Implantações**. Localize a implantação que você deseja reimplantar e escolha o nome do aplicativo na coluna **Application (Aplicativos)**. Certifique-se de que a coluna **Plataforma de computação** para a sua implantação seja **EC2/On-Premises**. 1. Na guia **Implantações**, selecione **Criar implantação**. **nota** Seu aplicativo deve ter um grupo de implantação antes de poder ser implantado. Se seu aplicativo não tiver um grupo de implantação, na guia **Grupos de implantação**, escolha **Criar grupo de implantação**. Para obter mais informações, consulte [Crie um grupo de implantação com CodeDeploy](deployment-groups-create.md). 1. Em **Grupo de implantação**, escolha um grupo de implantação para usar nesta implantação. 1. Ao lado de **Repository type (Tipo de repositório)**, escolha o tipo de repositório no qual a sua revisão está armazenada: + **Meu aplicativo está armazenado no Amazon S3**: para obter informações, consulte [Especificar informações sobre uma revisão armazenada em um bucket do Amazon S3](deployments-create-console-s3.md) e em seguida retorne à etapa 6. + **Meu aplicativo está armazenado em GitHub** — Para obter informações, consulte e[Especificar informações sobre uma revisão armazenada em um GitHub repositório](deployments-create-console-github.md), em seguida, retorne à etapa 6. 1. (Opcional) Em **Descrição da implantação**, digite uma descrição para esta implantação. 1. (Opcional) Expanda **Substituir a configuração de implantação** para escolher uma configuração de para controlar a forma como o tráfego é deslocado para o servidor Amazon EC2 ou on-premises diferente daquele especificado no grupo de implantação. Para obter mais informações, consulte [Trabalhando com configurações de implantação em CodeDeploy](deployment-configurations.md). 1. 1. Selecione **Não falhe na implantação se o evento do ApplicationStop ciclo de vida falhar** se você quiser que a implantação em uma instância seja bem-sucedida se o evento do `ApplicationStop` ciclo de vida falhar. 1. Expanda **Configurações adicionais de comportamento de implantação** para especificar como CodeDeploy manipula arquivos em um local de destino de implantação que não faziam parte da implantação anterior bem-sucedida. Escolha uma das seguintes opções: + **Falha na implantação**: um erro é informado, e o status da implantação é alterado para `Failed`. + **Substituir o conteúdo**: se um arquivo com o mesmo nome existir na localização de destino, a versão da revisão do aplicativo o substituirá. + **Reter o conteúdo**: se um arquivo com o mesmo nome existir no local de destino, ele será mantido e a versão na revisão do aplicativo não será copiada para a instância. Para obter mais informações, consulte [Comportamento de reversão com conteúdo existente](deployments-rollback-and-redeploy.md#deployments-rollback-and-redeploy-content-options). 1. (Opcional) Em **Substituições de configurações de reversão**, você pode especificar opções de reversão automática para essa implantação diferentes daquelas que foram especificadas para o grupo de implantação, se houver. Para obter informações sobre reversões em CodeDeploy, consulte e. [Reimplantações e reversões de implantação](deployment-steps-server.md#deployment-rollback) [Reimplante e reverta uma implantação com CodeDeploy](deployments-rollback-and-redeploy.md) Escolha uma das seguintes opções: + **Reverta quando uma implantação falha** — CodeDeploy reimplanta a última revisão válida conhecida como uma nova implantação. + **Reverter quando os limites de alarme forem atingidos** — Se os alarmes foram adicionados ao grupo de CodeDeploy implantação, implanta a última revisão válida quando um ou mais dos alarmes especificados forem ativados. + **Desativar reversões**: não execute reversões para esta implantação. 1. Selecione **Iniciar implantação**. Para acompanhar o status da sua implantação, consulte [Exibir detalhes CodeDeploy da implantação](deployments-view-details.md). **Topics** + [Especificar informações sobre uma revisão armazenada em um bucket do Amazon S3](deployments-create-console-s3.md) + [Especificar informações sobre uma revisão armazenada em um GitHub repositório](deployments-create-console-github.md) # Especificar informações sobre uma revisão armazenada em um bucket do Amazon S3 Se você estiver seguindo as etapas em [Componentes de implantação em uma plataforma de computação EC2/On-Premises (console)](deployments-create-console.md), siga estas etapas para adicionar detalhes sobre uma revisão de aplicativo armazenada em um bucket do Amazon S3. 1. Copie o link para o Amazon S3 de sua revisão na caixa **Local de revisão**. Para encontrar o valor do link: 1. Em uma guia separada do navegador: Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) Navegue até a sua revisão e escolha-a. 1. Se o painel **Propriedades** não estiver visível, escolha o botão **Propriedades**. 1. No painel **Propriedades**, copie o valor do campo **Link** na caixa **Local da revisão** no CodeDeploy console. Para especificar uma ETag (uma soma de verificação de arquivo) como parte do local da revisão: + Se o valor do campo **Link** terminar em**?versionId=*versionId***, adicione **&etag=** e ETag ao final do valor do campo **Link**. + Se o valor do campo **Link** não especificar uma ID de versão, **?etag=** adicione-a ETag ao final do valor do campo **Link**. **nota** Embora não seja tão fácil quanto copiar o valor do campo **Link**, você também pode digitar a localização da revisão em um dos seguintes formatos: **s3://*bucket-name*/*folders*/*objectName*** **s3://*bucket-name*/*folders*/*objectName*?versionId=*versionId*** **s3://*bucket-name*/*folders*/*objectName*?etag=*etag*** **s3://*bucket-name*/*folders*/*objectName*?versionId=*versionId*&etag=*etag*** ***bucket-name*.s3.amazonaws.com/*folders*/*objectName*** 1. Se for exibida uma mensagem na lista **Tipo de arquivo** especificando que o tipo de arquivo não pôde ser detectado, escolha o tipo de arquivo da revisão. Caso contrário, aceite o tipo de arquivo detectado. # Especificar informações sobre uma revisão armazenada em um GitHub repositório Se você estiver seguindo as etapas em[Componentes de implantação em uma plataforma de computação EC2/On-Premises (console)](deployments-create-console.md), siga estas etapas para adicionar detalhes sobre uma revisão do aplicativo armazenada em um GitHub repositório. 1. Em **Connect to GitHub**, faça o seguinte: + Para criar uma conexão de CodeDeploy aplicativos com uma GitHub conta, em uma guia diferente do navegador da Web, saia GitHub. Em **GitHub Conta**, insira um nome para identificar essa conexão e escolha **Conectar GitHub** a. A página da web solicita que você autorize CodeDeploy a interação com GitHub seu aplicativo. Continue na etapa 2. + Para usar uma conexão que você já criou, na **GitHubconta**, selecione seu nome e escolha **Conectar GitHub** a. Continue na etapa 4. + Para criar uma conexão com uma GitHub conta diferente, em uma guia diferente do navegador, saia GitHub. Escolha **Conectar a uma GitHub conta diferente** e, em seguida, escolha **Conectar GitHub** a. Continue na etapa 2. 1. Se você for solicitado a fazer login GitHub, siga as instruções na página de **login**. Faça login com seu nome de GitHub usuário ou e-mail e senha. 1. Se uma página para **Autorizar aplicativo** for exibida, escolha **Autorizar aplicativo**. 1. Na página **Criar implantação**, na caixa **Nome do repositório**, insira o nome GitHub do usuário ou da organização que contém a revisão, seguido por uma barra (`/`), seguida pelo nome do repositório que contém a revisão. Caso não tenha certeza do valor que deve ser digitado: 1. Em uma guia diferente do navegador, acesse seu [GitHubpainel](https://github.com/dashboard). 1. Em **Seus repositórios**, passe o ponteiro do mouse sobre o nome do repositório de destino. Uma dica de ferramenta aparece, exibindo o nome GitHub do usuário ou da organização, seguido por uma barra (`/`), seguida pelo nome do repositório. Insira esse valor exibido na caixa **Repository name (Nome do repositório)**. **nota** Se o nome do repositório de destino não estiver visível em **Seus repositórios**, use a GitHub caixa **Pesquisar** para encontrar o nome do repositório de destino e o nome GitHub do usuário ou da organização. 1. Na caixa **Commit ID (ID de confirmação)**, insira o ID da confirmação que se refere à revisão no repositório. Caso não tenha certeza do valor que deve ser digitado: 1. Em uma guia diferente do navegador, acesse seu [GitHubpainel](https://github.com/dashboard). 1. Em **Seus repositórios**, escolha o nome do repositório que contém a confirmação de destino. 1. Na lista de confirmações, localize e copie o ID de confirmação que se refere à revisão no repositório. Em geral, esse ID tem 40 caracteres de comprimento e é formado por letras e números. (Não use a versão mais curta do ID de confirmação, que consiste normalmente nos 10 primeiros caracteres da versão mais longa desse ID de confirmação.) 1. Cole o ID de confirmação na caixa **ID de confirmação**. # Crie uma implantação da Amazon ECS Compute Platform (CLI) Depois de criar o aplicativo e a revisão (nas implantações do Amazon ECS, este é o AppSpec arquivo): Chame o comando [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html), especificando o ID da implantação, especificando: + Um nome de aplicativo. Para ver uma lista de nomes de aplicativos, chame o comando [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html). + O nome do grupo da implantação. Para ver uma lista de nomes de grupos de implantação, chame o comando [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html). + Informações sobre a revisão a ser implantada: Para revisões armazenadas no Amazon S3: + O nome do bucket do Amazon S3 que contém a revisão. + O nome da revisão carregada. + (Opcional) O identificador de versão do Amazon S3 da revisão. (Se o identificador da versão não for especificado, CodeDeploy usa a versão mais recente.) + (Opcional) O ETag para a revisão. (Se não ETag for especificado, CodeDeploy ignora a validação do objeto.) Para as revisões armazenadas em um arquivo que não está no Amazon S3, você precisa do nome do arquivo e o caminho. O seu arquivo de revisão está escrito usando JSON ou YAML, portanto, provavelmente possui uma extensão .json ou .yaml. + (Opcional) Uma descrição da implantação. O arquivo de revisão pode ser especificado como um arquivo carregado em um bucket do Amazon S3 ou como uma string. A sintaxe para cada um quando usado como parte do comando **create-deployment** é: + Bucket do Amazon S3: Os `version` e `eTag` são opcionais. ``` --s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string ``` + String: ``` --revision '{"revisionType": "String", "string": {"content":"revision-as-string"}}' ``` **nota** O comando **create-deployment** pode carregador uma revisão de um arquivo. Para obter mais informações, consulte [Carregar parâmetros de um arquivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file). Para modelos AWS Lambda de revisão de implantação, consulte[Adicionar um AppSpec arquivo para uma implantação do AWS Lambda](application-revisions-appspec-file.md#add-appspec-file-lambda). Para obter uma revisão de exemplo, consulte [AppSpec Exemplo de arquivo para uma implantação do AWS Lambda](reference-appspec-file-example.md#appspec-file-example-lambda). Para acompanhar o status da sua implantação, consulte [Exibir detalhes CodeDeploy da implantação](deployments-view-details.md). # Crie uma implantação da AWS Lambda Compute Platform (CLI) Depois de criar o aplicativo e a revisão (nas implantações do AWS Lambda, esse é o AppSpec arquivo): Chame o comando [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html), especificando o ID da implantação, especificando: + Um nome de aplicativo. Para ver uma lista de nomes de aplicativos, chame o comando [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html). + O nome do grupo da implantação. Para ver uma lista de nomes de grupos de implantação, chame o comando [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html). + Informações sobre a revisão a ser implantada: Para revisões armazenadas no Amazon S3: + O nome do bucket do Amazon S3 que contém a revisão. + O nome da revisão carregada. + (Opcional) O identificador de versão do Amazon S3 da revisão. (Se o identificador da versão não for especificado, CodeDeploy usa a versão mais recente.) + (Opcional) O ETag para a revisão. (Se não ETag for especificado, CodeDeploy ignora a validação do objeto.) Para as revisões armazenadas em um arquivo que não está no Amazon S3, você precisa do nome do arquivo e o caminho. O seu arquivo de revisão está escrito usando JSON ou YAML, portanto, provavelmente possui uma extensão .json ou .yaml. + (Opcional) O nome de uma configuração de implantação a ser usada. Para visualizar uma lista de configurações de implantação, chame o comando [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html). (Se não for especificado, CodeDeploy usa uma configuração de implantação padrão específica.) + (Opcional) Uma descrição da implantação. O arquivo de revisão pode ser especificado como um arquivo carregado em um bucket do Amazon S3 ou como uma string. A sintaxe para cada um quando usado como parte do comando **create-deployment** é: + Bucket do Amazon S3: Os `version` e `eTag` são opcionais. ``` --s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string ``` + String: ``` --revision '{"revisionType": "String", "string": {"content":"revision-as-string"}}' ``` **nota** O comando **create-deployment** pode carregador uma revisão de um arquivo. Para obter mais informações, consulte [Carregar parâmetros de um arquivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file). Para modelos AWS Lambda de revisão de implantação, consulte[Adicionar um AppSpec arquivo para uma implantação do AWS Lambda](application-revisions-appspec-file.md#add-appspec-file-lambda). Para obter uma revisão de exemplo, consulte [AppSpec Exemplo de arquivo para uma implantação do AWS Lambda](reference-appspec-file-example.md#appspec-file-example-lambda). Para acompanhar o status da sua implantação, consulte [Exibir detalhes CodeDeploy da implantação](deployments-view-details.md). # Criar uma implantação de plataforma de computação de EC2/On-Premises (CLI) Para usar o AWS CLI para implantar uma revisão na plataforma de computação EC2/local: 1. Depois de ter preparado as instâncias, criado o aplicativo e enviado a revisão, siga um destes procedimentos: + Se você deseja implantar uma revisão de um bucket do Amazon S3, continue na etapa 2 agora. + Se você quiser implantar uma revisão a partir de um GitHub repositório, primeiro conclua as etapas em e[Conectar um CodeDeploy aplicativo a um GitHub repositório](deployments-create-cli-github.md), em seguida, continue com a etapa 2. 1. Chame o comando [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html), especificando o ID da implantação, especificando: + `--application-name`: Um nome de aplicativo. Para ver uma lista de nomes de aplicativos, chame o comando [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html). + `--deployment-group-name`: Um nome de grupo de implantação do Amazon EC2. Para ver uma lista de nomes de grupos de implantação, chame o comando [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html). + `--revision`: Informações sobre a revisão a ser implantada: Para revisões armazenadas no Amazon S3: + `s3Location`: O nome do bucket do Amazon S3 que contém a revisão. + `s3Location --> key`: O nome da revisão carregada. + `s3Location --> bundleType`: O nome e o tipo de arquivo da revisão carregada. **nota** Os formatos de arquivo tar e tar compactado (.tar e .tar.gz) não são compatíveis com instâncias do Windows Server. + `s3Location --> version`: (Opcional) O identificador de versão do Amazon S3 da revisão. (Se o identificador da versão não for especificado, CodeDeploy usa a versão mais recente.) + `s3Location --> eTag`: (Opcional) O ETag para a revisão. (Se não ETag for especificado, CodeDeploy ignora a validação do objeto.) Para revisões armazenadas em: GitHub + `gitHubLocation --> repository`: o nome GitHub do usuário ou grupo atribuído ao repositório que contém a revisão, seguido por uma barra (`/`), seguida pelo nome do repositório. + `gitHubLocation --> commitId`: O ID de confirmação da revisão. + `--deployment-config-name`: (Opcional) O nome de uma configuração de implantação a ser usada. Para visualizar uma lista de configurações de implantação, chame o comando [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html). (Se não for especificado, CodeDeploy usa uma configuração de implantação padrão específica.) + `--ignore-application-stop-failures | --no-ignore-application-stop-failures`: (Opcional) Para que a implantação em uma instância continue para o evento de ciclo de vida da implantação `BeforeInstall` se o evento de ciclo de vida de implantação `ApplicationStop` falhar. + `--description`: (Opcional) Uma descrição da implantação. + `--file-exists-behavior`: (Opcional) Como parte do processo de implantação, o CodeDeploy agente remove de cada instância todos os arquivos instalados pela implantação mais recente. Escolha o que acontece quando arquivos que não faziam parte de uma implantação anterior aparecem nos locais de implantação de destino. + `--target-instances`: Para blue/green implantações, informações sobre as instâncias que pertencem ao ambiente substituto em uma blue/green implantação, incluindo os nomes de um ou mais grupos do Amazon EC2 Auto Scaling ou a chave, o tipo e o valor do filtro de tags usados para identificar instâncias do Amazon EC2. **nota** Use essa sintaxe como parte da chamada **create-deployment** para especificar informações sobre uma revisão no Amazon S3 diretamente na linha de comando. (`version` e `eTag` são opcionais.) ``` --s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string ``` Use essa sintaxe como parte da **create-deployment** chamada para especificar informações sobre uma revisão GitHub diretamente na linha de comando: ``` --github-location repository=string,commitId=string ``` Para obter informações sobre revisões que já foram enviadas, chame o comando [list-application-revisions](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-application-revisions.html). Para acompanhar o status da sua implantação, consulte [Exibir detalhes CodeDeploy da implantação](deployments-view-details.md). ## referência do comando create-deployment Abaixo está a estrutura do comando e as opções do `create-deployment` comando. *Para obter mais informações, consulte a referência [de criação e implantação](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) na Referência de comandos da AWS CLI *. ``` create-deployment --application-name [--deployment-group-name ] [--revision ] [--deployment-config-name ] [--description ] [--ignore-application-stop-failures | --no-ignore-application-stop-failures] [--target-instances ] [--auto-rollback-configuration ] [--update-outdated-instances-only | --no-update-outdated-instances-only] [--file-exists-behavior ] [--s3-location ] [--github-location ] [--cli-input-json ] [--generate-cli-skeleton ] ``` # Conectar um CodeDeploy aplicativo a um GitHub repositório Antes de implantar um aplicativo de um GitHub repositório pela primeira vez usando o AWS CLI, você deve primeiro dar CodeDeploy permissão para interagir com ele GitHub em nome da sua GitHub conta. Essa etapa deve ser concluída uma vez para cada aplicativo usando o CodeDeploy console. 1. Faça login no Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy). **nota** Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md). 1. Selecione **Aplicações**. 1. Em **Aplicativos**, escolha o aplicativo que você deseja vincular à sua conta de GitHub usuário e escolha **Implantar aplicativo**. **nota** Você não está criando uma implantação. Atualmente, essa é a única maneira de dar CodeDeploy permissão para interagir GitHub em nome de sua conta de GitHub usuário. 1. Ao lado de **Tipo de repositório**, escolha **Minha revisão do aplicativo está armazenada em GitHub**. 1. Escolha **Connect to GitHub**. **nota** Se você ver um link **Connect to a uma GitHub conta diferente**: Talvez você já tenha autorizado CodeDeploy a interagir GitHub em nome de uma GitHub conta diferente para o aplicativo. Você pode ter revogado a autorização CodeDeploy para interagir GitHub em nome da GitHub conta conectada para todos os aplicativos vinculados. CodeDeploy Para obter mais informações, consulte [GitHub autenticação com aplicativos em CodeDeploy](integrations-partners-github.md#behaviors-authentication). 1. Se você ainda não estiver conectado GitHub, siga as instruções na página de **login**. 1. Na página para **Autorizar aplicativo**, escolha **Autorizar aplicativo**. 1. Agora que CodeDeploy tem permissão, escolha **Cancelar** e continue com as etapas[Criar uma implantação de plataforma de computação de EC2/On-Premises (CLI)](deployments-create-cli.md). # Crie uma blue/green implantação do Amazon ECS por meio de CloudFormation Você pode usar AWS CloudFormation para gerenciar blue/green implantações do Amazon ECS por meio de. CodeDeploy Você gera a implantação definindo seus recursos verdes e azuis e especificando as configurações de roteamento e estabilização de tráfego a serem usadas no CloudFormation. Este tópico aborda as diferenças entre as blue/green implantações do Amazon ECS que são gerenciadas por CodeDeploy e as implantações que são gerenciadas por. CloudFormation *Para step-by-step obter instruções sobre como CloudFormation gerenciar suas implantações azul/verde do Amazon ECS, consulte [Automatizar implantações azul/verde do ECS usando o Guia do usuário](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html). CodeDeploy AWS CloudFormationAWS CloudFormation * **nota** O gerenciamento de blue/green implantações do Amazon ECS com não CloudFormation está disponível na região Ásia-Pacífico (Osaka). ## Diferenças entre as blue/green implantações do Amazon ECS por meio de e CodeDeploy CloudFormation O modelo de CloudFormation pilha modela os recursos e a infraestrutura relacionados às tarefas do Amazon ECS e também as opções de configuração para implantações. Portanto, há diferenças entre as implantações padrão do Amazon ECS e blue/green as blue/green implantações criadas por meio do. CloudFormation Ao contrário das blue/green implantações padrão do Amazon ECS, você não modela nem cria manualmente o seguinte: + Você não cria um AWS CodeDeploy aplicativo especificando um nome que represente de forma exclusiva o que você deseja implantar. + Você não cria um grupo AWS CodeDeploy de implantação. + Você não especifica um arquivo de *especificação do aplicativo* (AppSpec arquivo). As informações normalmente gerenciadas com o AppSpec arquivo, como as opções ponderadas de configuração ou os eventos do ciclo de vida, são gerenciadas pelo gancho. `AWS::CodeDeploy::BlueGreen` Esta tabela resume as diferenças no fluxo de trabalho de alto nível entre os tipos de implantação. **** | Função | blue/green Implantações padrão | Implantações azul/verdes por meio de CloudFormation | | --- | --- | --- | | Especifique o cluster do Amazon ECS, o serviço Amazon ECS, o Application Load Balancer ou o Network Load Balancer, o receptor de produção, o receptor de teste e dois grupos-alvo. | Crie um grupo CodeDeploy de implantação que especifique esses recursos. | Crie um CloudFormation modelo para modelar esses recursos. | | Especifique a alteração a ser implantada. | Crie um CodeDeploy aplicativo. | Crie um CloudFormation modelo que especifique a imagem do contêiner. | | Especifique a definição da tarefa do Amazon ECS, o nome do contêiner e a porta do contêiner. | Crie um AppSpec arquivo que especifique esses recursos. | Crie um CloudFormation modelo para modelar esses recursos. | | Especifique as opções de deslocamento de tráfego de implantação e os ganchos de eventos de ciclo de vida. | Crie um AppSpec arquivo que especifique essas opções. | Crie um CloudFormation modelo que use os parâmetros do AWS::CodeDeploy::BlueGreen gancho para especificar essas opções. | | CloudWatch alarmes. | Crie um CloudWatch alarme que acione uma reversão. | Configure um CloudWatch alarme no nível da CloudFormation pilha que acione uma reversão. | | Reversão/reimplantação. | Especifique as opções de reversão e reimplantação. | Cancele a atualização da pilha em CloudFormation. | ## Monitorando blue/green implantações do Amazon ECS por meio de CloudFormation Você pode monitorar blue/green as implantações por meio de CloudFormation e. CodeDeploy Para obter informações sobre o monitoramento por meio de CloudFormation, consulte [Monitoramento de blue/green eventos CloudFormation no](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html#blue-green-events) *Guia AWS CloudFormation do usuário*. **Para ver o status de implantação das blue/green implantações em CodeDeploy** 1. Faça login no Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy). **nota** Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md). 1. Em **Implantações**, a implantação que foi acionada pela atualização da CloudFormation pilha é exibida. Escolha a implantação para visualizar o **Histórico de implantação**. ![\[Captura de tela do console que mostra a seção Implantações e o histórico de implantação.\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/images/cfn-cd-bg-deplhist.png) 1. Escolha a implantação para visualizar o status do deslocamento do tráfego. Observe que o aplicativo e o grupo de implantação não são criados. ![\[Captura de tela do console que mostra os detalhes da implantação com o status da implantação concluído.\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/images/cfn-cd-bg-deplstatus.png) 1. Os itens a seguir se aplicam para reverter ou interromper a implantação: + A implantação bem-sucedida aparece em CodeDeploy e mostra que a implantação foi iniciada por CloudFormation. + Se quiser interromper e reverter a implantação, você deve cancelar a atualização da pilha em CloudFormation.