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á. # Trabalhar com aplicativos no CodeDeploy Depois de configurar instâncias, mas antes de poder implantar uma revisão, você deve criar um aplicativo no CodeDeploy. Um *aplicativo* é simplesmente um nome ou contêiner usado pelo CodeDeploy para garantir que a revisão, a configuração da implantação e o grupo de implantação corretos sejam referenciados durante uma implantação. Use as informações da tabela a seguir nas próximas etapas: | Plataforma de computação | Cenário | Informações para a próxima etapa | | --- | --- | --- | | **EC2/On-Premises** | Ainda não criei instâncias. | Consulte [Trabalhando com instâncias para CodeDeploy](instances.md) e depois retorne a esta página. | | **EC2/On-Premises** | Eu criei instâncias, mas não terminei de marcá-las. | Consulte [Marcar instâncias para grupos de implantação em CodeDeploy](instances-tagging.md) e depois retorne a esta página. | | **EC2/On-Premises**, **AWSLambda** e **Amazon ECS** | Ainda não criei um aplicativo. | Consulte [Crie um aplicativo com CodeDeploy](applications-create.md) | | **EC2/On-Premises**, **AWSLambda** e **Amazon ECS** | Já criei um aplicativo, mas não criei um grupo de implantação. | Consulte [Crie um grupo de implantação com CodeDeploy](deployment-groups-create.md). | | **EC2/On-Premises**, **AWSLambda** e **Amazon ECS** | Já criei um aplicativo e um grupo de implantação, mas não criei uma revisão de aplicativo. | Consulte [Trabalhando com revisões de aplicativos para CodeDeploy](application-revisions.md). | | **EC2/On-Premises**, **AWSLambda** e **Amazon ECS** | Já criei um aplicativo e um grupo de implantação e já carreguei minha revisão de aplicativo. Estou pronto para implantar. | Consulte [Crie uma implantação com CodeDeploy](deployments-create.md). | **Topics** + [Criar uma aplicação do](applications-create.md) + [Visualizar detalhes de aplicativos](applications-view-details.md) + [Criar uma regra de notificação](notification-rule-create.md) + [Renomear um aplicativo](applications-rename.md) + [Deleta a aplicação](applications-delete.md) # Crie um aplicativo com CodeDeploy Um *aplicativo* é simplesmente um nome ou contêiner usado CodeDeploy para garantir que a revisão, a configuração de implantação e o grupo de implantação corretos sejam referenciados durante uma implantação. Você pode usar o CodeDeploy console, o AWS CLI CodeDeploy APIs, o ou um CloudFormation modelo para criar aplicativos. Seu código, ou revisão do aplicativo, é instalado nas instâncias por meio de um processo chamado implantação. CodeDeploy oferece suporte a dois tipos de implantações: + **Implantação no local**: o aplicativo em cada instância no grupo de implantação é interrompido, a última revisão de aplicativo é instalada, e a nova versão do aplicativo é iniciada e validada. Você pode usar um balanceador de carga de forma que cada registro de instância é cancelado durante sua implantação e, em seguida, restaurado para o serviço após a conclusão da implantação. Somente implantações que usam a plataforma de computação EC2/On-Premises podem usar implantações no local. Para obter mais informações sobre implantações no local, consulte [Visão geral de uma implantação no local](welcome.md#welcome-deployment-overview-in-place). + **Implantação azul/verde**: o comportamento da sua implantação depende de qual plataforma você usa: + **Blue/green on an EC2/On-Plataforma de computação local**: as instâncias em um grupo de implantação (o ambiente original) são substituídas por um conjunto diferente de instâncias (o ambiente substituto) usando estas etapas: + As instâncias são provisionadas para o ambiente de substituição. + A revisão de aplicativo mais recente será instalada nas instâncias de substituição. + Um tempo de espera opcional ocorre para atividades como teste de aplicativos e verificação do sistema. + As instâncias no ambiente de substituição são registradas com um ou mais balanceadores de carga do Elastic Load Balancing, fazendo com que o tráfego seja redirecionado para elas. O registro das instâncias no ambiente original é cancelado e pode ser encerrado ou mantido em execução para outros usos. **nota** Se você usa uma plataforma computacional EC2/local, esteja ciente de que as blue/green implantações funcionam somente com instâncias do Amazon EC2. + **Azul/verde em uma plataforma computacional ou AWS Lambda Amazon ECS****: o tráfego é deslocado em incrementos de acordo com uma configuração **canária**, linear ou de implantação. **all-at-once**** + **Implantações em azul/verde por meio** de CloudFormation: O tráfego é transferido de seus recursos atuais para seus recursos atualizados como parte de uma atualização de pilha. CloudFormation Atualmente, somente blue/green implantações do ECS são suportadas. Para obter mais informações sobre blue/green implantações, consulte[Visão geral de uma blue/green implantação](welcome.md#welcome-deployment-overview-blue-green). Ao usar o CodeDeploy console para criar um aplicativo, você configura seu primeiro grupo de implantação ao mesmo tempo. Ao usar o AWS CLI para criar um aplicativo, você cria seu primeiro grupo de implantação em uma etapa separada. Para ver uma lista de aplicativos já registrados em sua AWS conta, consulte[Veja os detalhes do aplicativo com CodeDeploy](applications-view-details.md). Para obter informações sobre como usar um CloudFormation modelo para criar um aplicativo, consulte[CloudFormation modelos para CodeDeploy referência](reference-cloudformation-templates.md). Os dois tipos de implantação não se aplicam a todos os destinos. A tabela a seguir relaciona quais tipos de implantação funcionam com implantações nos três tipos de destinos de implantação. **** | Destino da implantação | No local | Azul/verde | | --- | --- | --- | | Amazon EC2 | Sim | Sim | | Infraestrutura | Sim | Não | | Funções Lambda sem servidor AWS | Não | Sim | | Aplicativos do Amazon ECS | Não | Sim | **Topics** + [Criar um aplicativo para uma implantação no local (console)](applications-create-in-place.md) + [Criar um aplicativo para uma blue/green implantação (console)](applications-create-blue-green.md) + [Criar um aplicativo para uma implantação do serviço do Amazon ECS (console)](applications-create-ecs.md) + [Crie um aplicativo para a implantação de uma AWS Lambda função (console)](applications-create-lambda.md) + [Criar um aplicativo (CLI)](applications-create-cli.md) # Criar um aplicativo para uma implantação no local (console) Para usar o CodeDeploy console para criar um aplicativo para uma implantação local: **Atenção** Não siga essas etapas se: Você não preparou suas instâncias para serem usadas em CodeDeploy implantações. Para configurar suas instâncias, siga as instruções em [Trabalhando com instâncias para CodeDeploy](instances.md) e depois siga as etapas neste tópico. Você deseja criar um aplicativo que usa uma configuração de implantação personalizada, mas ainda não criou essa configuração de implantação. Siga as instruções em [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md) e depois siga as etapas neste tópico. Você não tem uma função de serviço que CodeDeploy confie na confiança e nas permissões mínimas necessárias. Para criar e configurar uma função de serviço com as permissões necessárias, siga as instruções em [Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md) e depois volte para as etapas deste tópico. Você deseja selecionar um Classic Load Balancer, Application Load Balancer ou Network Load Balancer no Elastic Load Balancing para a implantação no local, mas ainda não o criou. Para criar um aplicativo para uma implantação local 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. No painel de navegação, expanda **Implantar** e escolha **Introdução**. 1. Selecione **Criar aplicativo**. 1. Em **Nome da aplicação**, digite o nome do aplicativo. 1. Em **Plataforma de computação**, selecione **EC2/On-Premises**. 1. Escolha **Criar aplicação**. 1. Na página do aplicativo, na guia **Grupos de implantação**, selecione **Criar grupo de implantação**. 1. Em **Nome do grupo de implantação** digite um nome que descreva o grupo de implantação. **nota** Se quiser usar as mesmas configurações usadas em outro grupo de implantação (incluindo o nome do grupo de implantação, tags e/ou nomes de grupos do Amazon EC2 Auto Scaling, bem como a configuração de implantação), especifique essas configurações nessa página. Embora esse novo grupo de implantação e o grupo de implantação existente tenham o mesmo nome, eles CodeDeploy são tratados como grupos de implantação separados, pois cada um deles está associado a aplicativos separados. 1. Em **Service role (Função de serviço)**, escolha uma função de serviço que conceda acesso do CodeDeploy à sua instância de destino. 1. Em **Tipo de implantação**, selecione **No local**. 1. Em **Configuração do ambiente**, selecione uma das opções a seguir: 1. **Grupos do Amazon EC2 Auto Scaling**: insira ou escolha o nome de um grupo do Amazon EC2 Auto Scaling no qual implantar a revisão do aplicativo. Quando novas instâncias do Amazon EC2 são lançadas como parte de um grupo do Amazon EC2 Auto Scaling CodeDeploy , você pode implantar suas revisões nas novas instâncias automaticamente. É possível adicionar até 10 grupos do Amazon EC2 Auto Scaling a um grupo de implantação. 1. **Instâncias do Amazon EC2** ou **Instâncias on-premises**: nos campos **Chave** e **Valor**, digite os valores do par de chaves/valores usados para marcar as instâncias. É possível marcar até 10 pares de chave/valor em um único grupo de tags. 1. Você pode usar caracteres curinga no campo **Valor** para identificar todas as instâncias marcadas em determinados padrões, como instâncias do Amazon EC2, centros de custo e nomes de grupos semelhantes e assim por diante. Por exemplo, se você escolher **Nome** no campo **Chave** e inserir **GRP-\$1a** no campo **Valor**, CodeDeploy identificará todas as instâncias que se encaixam nesse padrão**GRP-1a**, como**GRP-2a**, e. **GRP-XYZ-a** 1. O campo **Valor** diferencia maiúsculas de minúsculas. 1. Para remover um par de chave/valor da lista, escolha o ícone **Remove tag (Remover tag)**. Quando CodeDeploy encontra instâncias que correspondem a cada par de valores-chave especificado ou ao nome do grupo Amazon EC2 Auto Scaling, ele exibe o número de instâncias correspondentes. Escolha o número para ver mais informações sobre as instâncias. Se você deseja refinar os critérios para a implantação de instâncias, escolha **Adicionar grupo de tags** para criar um grupo de tags. É possível criar até três grupos de tags com até dez pares chave/valor de cada. Quando você usa grupos de várias tags em um grupo de implantação, apenas as instâncias que são identificadas por todos os grupos de tags são incluídas no grupo de implantação. Isso significa que uma instância deve corresponder pelo menos a uma das tags em cada um dos grupos a serem incluídos no grupo de implantação. Para obter mais informações sobre como usar grupos de tags para refinar o grupo de implantação, consulte [Marcar instâncias para grupos de implantação em CodeDeploy](instances-tagging.md). 1. Em **Deployment settings (Configurações da implantação)**, escolha uma configuração de implantação para controlar a taxa em que os aplicativos são implantados nas instâncias, por exemplo, uma de cada vez ou todas ao mesmo tempo. Para obter mais informações sobre configurações de implantação, consulte [Trabalhando com configurações de implantação em CodeDeploy](deployment-configurations.md). 1. (Opcional) No **Load Balancer**, selecione **Ativar balanceamento de carga** e, nas listas, selecione os grupos-alvo Classic Load Balancers, Application Load Balancer e Network Load Balancer para gerenciar o tráfego para as instâncias durante a implantação. CodeDeploy Você pode selecionar até 10 Classic Load Balancers e 10 grupos de destino, totalizando 20 itens. Verifique se as instâncias do Amazon EC2 nas quais você deseja implantar estão registradas nos balanceadores de carga (Classic Load Balancers) ou nos grupos de destino (Application Load Balancers e Network Load Balancers) selecionados. Durante uma implantação, o registro das instâncias originais dos balanceadores de carga e dos grupos de destino selecionados é cancelado para evitar que o tráfego seja roteado para essas instâncias durante a implantação. Quando a implantação for concluída, cada instância será registrada novamente com *todos* os Classic Load Balancers e grupos de destino selecionados. Para obter mais informações sobre balanceadores de carga para CodeDeploy implantações, consulte. [Integração CodeDeploy com o Elastic Load Balancing](integrations-aws-elastic-load-balancing.md) 1. (Opcional) Expanda **Avançado** e configure todas as opções que você deseja incluir na implantação, como acionadores de notificação do Amazon SNS, alarmes da CloudWatch Amazon ou reversões automáticas. Para obter mais informações, consulte [Configurar opções avançadas para um grupo de implantação](deployment-groups-configure-advanced-options.md). 1. Selecione **Criar grupo de implantação**. A próxima etapa é preparar uma revisão a ser implantada no aplicativo e grupo de implantação. Para instruções, consulte [Trabalhando com revisões de aplicativos para CodeDeploy](application-revisions.md). # Criar um aplicativo para uma blue/green implantação (console) Para usar o CodeDeploy console para criar um aplicativo para uma blue/green implantação: **nota** Uma implantação na plataforma de computação AWS Lambda é sempre uma implantação. blue/green Não especifique uma opção de tipo de implantação. **Atenção** Não siga essas etapas se: Você não tem instâncias com o CodeDeploy agente instalado que queira substituir durante o processo blue/green de implantação. Para configurar suas instâncias, siga as instruções em [Trabalhando com instâncias para CodeDeploy](instances.md) e depois siga as etapas neste tópico. Você deseja criar um aplicativo que usa uma configuração de implantação personalizada, mas ainda não criou essa configuração de implantação. Siga as instruções em [Crie uma configuração de implantação com CodeDeploy](deployment-configurations-create.md) e depois siga as etapas neste tópico. Você não tem uma função de serviço que CodeDeploy confie, no mínimo, na confiança e nas permissões descritas em[Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md). Para criar e configurar um perfil de serviço, siga as instruções em [Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md) e depois siga as etapas neste tópico. Você não criou um Classic Load Balancer, Application Load Balancer ou Network Load Balancer no Elastic Load Balancing para o registro das instâncias em seu ambiente substituto. Para obter mais informações, consulte [Configure um balanceador de carga no Elastic Load Balancing para implantações do Amazon CodeDeploy EC2](deployment-groups-create-load-balancer.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. No painel de navegação, expanda **Implantar** e escolha **Introdução**. 1. Em **Nome da aplicação**, digite o nome do aplicativo. 1. Em **Plataforma de computação**, selecione **EC2/On-Premises**. 1. Escolha **Criar aplicação**. 1. Na página do aplicativo, na guia **Grupos de implantação**, selecione **Criar grupo de implantação**. 1. Em **Nome do grupo de implantação** digite um nome que descreva o grupo de implantação. **nota** Se quiser usar as mesmas configurações usadas em outro grupo de implantação (incluindo as tags do nome do grupo de implantação, os nomes de grupos do Amazon EC2 Auto Scaling e a configuração de implantação), escolha essas configurações nessa página. Embora esse novo grupo de implantação e o grupo de implantação existente tenham o mesmo nome, o CodeDeploy os tratará como grupos de implantação separados, porque cada um deles está associado a um aplicativo separado. 1. Em **Service role (Função de serviço)**, escolha uma função de serviço que conceda acesso do CodeDeploy à sua instância de destino. 1. Em **Tipo de implantação** escolha **Azul/verde**. 1. Em **Configuração do ambiente**, escolha o método que você deseja usar para fornecer instâncias ao seu ambiente de substituição: 1. **Copiar automaticamente o grupo Amazon EC2 Auto** Scaling: cria um CodeDeploy grupo Amazon EC2 Auto Scaling copiando um que você especificar. 1. **Fornecer instâncias manualmente**: você apenas especificará as instâncias para o seu ambiente de substituição depois de criar uma implantação. Você deve criar as instâncias antes de iniciar a implantação. Em vez disso, aqui, você especifica as instâncias que deseja substituir. 1. Dependendo da sua escolha na etapa 10, siga um destes procedimentos: + Se tiver escolhido **Cópia automática do grupo do Amazon EC2 Auto Scaling**: em **Grupo do Amazon EC2 Auto Scaling**, escolha ou insira o nome do grupo do Amazon EC2 Auto Scaling que você deseja usar como modelo para o grupo do Amazon EC2 Auto Scaling para as instâncias no seu ambiente de substituição. O número de instâncias atualmente íntegras no grupo do Amazon EC2 Auto Scaling que você selecionar é criado no seu ambiente de substituição. + Se você optar por **Fornecer instâncias manualmente**: habilite **Grupos do Amazon EC2 Auto Scaling**, **Instâncias do Amazon EC2** ou ambos para especificar instâncias a serem adicionadas nesse grupo de implantação. Insira valores de tags do Amazon EC2 ou nomes de grupo do Amazon EC2 Auto Scaling para identificar as instâncias no ambiente original (ou seja, as instâncias que você deseja substituir ou que estão executando a revisão de aplicativo atual). 1. Em **Balanceador de carga**, selecione **Habilitar balanceamento de carga** e, nas listas, selecione os grupos de destino Classic Load Balancers, Application Load Balancer e Network Load Balancer com os quais você deseja registrar suas instâncias substitutas do Amazon EC2. Cada instância substituta será registrada em *todos* os Classic Load Balancers e grupos de destino selecionados. Você pode selecionar até 10 Classic Load Balancers e 10 grupos de destino, totalizando 20 itens. O tráfego será redirecionado das instâncias originais para as instâncias substitutas de acordo com as definições de **Redirecionamento de tráfego** e **Configuração de implantação** escolhidas. Para obter mais informações sobre balanceadores de carga para CodeDeploy implantações, consulte. [Integração CodeDeploy com o Elastic Load Balancing](integrations-aws-elastic-load-balancing.md) 1. Em **Configurações de implantação**, reveja as opções padrão para o redirecionamento do tráfego ao ambiente de substituição, qual configuração de implantação usar para a implantação e como as instâncias no ambiente original serão tratadas após a implantação. Se quiser alterar as configurações, continue na próxima etapa. Caso contrário, vá para a etapa 15. 1. Para alterar as configurações de implantação da blue/green implantação, altere qualquer uma das configurações a seguir. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/applications-create-blue-green.html) 1. (Opcional) Em **Avançado**, configure as opções que você deseja incluir na implantação, como acionadores de notificação do Amazon SNS, alarmes da CloudWatch Amazon ou reversões automáticas. Para obter informações sobre como especificar opções avançadas em grupos de implantação, consulte [Configurar opções avançadas para um grupo de implantação](deployment-groups-configure-advanced-options.md). 1. Selecione **Criar grupo de implantação**. A próxima etapa é preparar uma revisão a ser implantada no aplicativo e grupo de implantação. Para instruções, consulte [Trabalhando com revisões de aplicativos para CodeDeploy](application-revisions.md). # Criar um aplicativo para uma implantação do serviço do Amazon ECS (console) Você pode usar o CodeDeploy console para criar um aplicativo para a implantação de um serviço Amazon ECS. 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. No painel de navegação, expanda a opção **Implantar** e selecione **Conceitos básicos**. 1. Na página **Criar aplicativo**, escolha **Usar CodeDeploy**. 1. Em **Nome da aplicação**, digite o nome do aplicativo. 1. Em **Plataforma de computação**, selecione **Amazon ECS**. 1. Escolha **Criar aplicativo**. 1. Na página do aplicativo, na guia **Grupos de implantação**, selecione **Criar grupo de implantação**. Para obter mais informações sobre o que você precisa para criar um grupo de implantação para uma implantação do Amazon ECS, consulte [Antes de começar uma implantação do](deployment-steps-ecs.md#deployment-steps-prerequisites-ecs). 1. Em **Nome do grupo de implantação** digite um nome que descreva o grupo de implantação. **nota** Se quiser usar as mesmas configurações usadas em outro grupo de implantação (incluindo o nome do grupo de implantação e a configuração de implantação), escolha essas configurações nessa página. Embora esse novo grupo e o grupo existente possam ter o mesmo nome, CodeDeploy trate-os como grupos de implantação separados, pois cada um está associado a um aplicativo separado. 1. Em **Função de serviço**, escolha uma função de serviço que conceda CodeDeploy acesso ao Amazon ECS. Para obter mais informações, consulte [Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md). 1. Em **Nome do balanceador de carga**, escolha o nome do balanceador de carga que distribui o tráfego para seu serviço do Amazon ECS. 1. Em **Porta do receptor de produção**, escolha a porta e o protocolo para o receptor que fornece o tráfego de produção para seu serviço do Amazon ECS. 1. (Opcional) Em **Porta do receptor de teste**, escolha a porta e o protocolo de um receptor de teste que fornece tráfego para o conjunto de tarefas de substituição em seu serviço do Amazon ECS durante a implantação. Você pode especificar uma ou mais funções Lambda no AppSpec arquivo que são executadas durante o hook. `AfterAllowTestTraffic` As funções podem executar testes de validação. Se houver falha em um teste de validação, uma reversão da implantação será acionada. Se o teste de validação for bem-sucedido, o próximo gancho no ciclo de vida da implantação, `BeforeAllowTraffic`, será acionado. Se a porta do receptor de teste não for especificada, nada acontecerá durante o hook `AfterAllowTestTraffic`. Para obter mais informações, consulte [AppSpec seção 'hooks' para uma implantação do Amazon ECS](reference-appspec-file-structure-hooks.md#appspec-hooks-ecs). 1. Em Nome do **grupo-alvo 1 e Nome** **do grupo-alvo 2**, escolha os grupos-alvo usados para rotear o tráfego durante sua implantação. CodeDeploy vincula um grupo-alvo ao conjunto de tarefas original do seu serviço Amazon ECS e o outro ao conjunto de tarefas de substituição. Para obter mais informações, consulte [Grupos de destino para seus Application Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html). 1. Escolha **Redirecionar tráfego imediatamente** ou **Especificar quando redirecionar o tráfego** para determinar quando redirecionar o tráfego para seu serviço do Amazon ECS atualizado. Se você escolher **Redirecionar tráfego imediatamente**, a implantação redirecionará automaticamente o tráfego após o provisionamento do conjunto de tarefas de substituição. Se você escolher **Especificar quando redirecionar o tráfego**, escolha o número de dias, horas e minutos a serem aguardados após o provisionamento bem-sucedido do conjunto de tarefas de substituição. Durante esse tempo de espera, os testes de validação nas funções Lambda especificadas no AppSpec arquivo são executados. Se o tempo de espera expirar antes que o tráfego seja redirecionado, o status de implantação mudará para `Stopped`. 1. Em **Encerramento da revisão original**, escolha o número de dias, horas e minutos a serem aguardados após uma implantação bem-sucedida antes que a tarefa original definida em seu serviço do Amazon ECS seja encerrada. 1. (Opcional) Em **Avançado**, configure todas as opções que você deseja incluir na implantação, como acionadores de notificação do Amazon SNS, alarmes da CloudWatch Amazon ou reversões automáticas. Para obter mais informações, consulte [Configurar opções avançadas para um grupo de implantação](deployment-groups-configure-advanced-options.md). # Crie um aplicativo para a implantação de uma AWS Lambda função (console) Você pode usar o CodeDeploy console para criar um aplicativo para a implantação de uma AWS Lambda função. 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. No painel de navegação, expanda a opção **Implantar** e selecione **Conceitos básicos**. 1. Na página **Criar aplicativo**, escolha **Usar CodeDeploy**. 1. Insira o nome do aplicativo em **Application name (Nome do aplicativo)**. 1. Em **Compute platform (Plataforma de computação)**, selecione **AWS Lambda**. 1. Escolha **Criar aplicação**. 1. Na página do aplicativo, na guia **Grupos de implantação**, selecione **Criar grupo de implantação**. 1. Em **Nome do grupo de implantação** digite um nome que descreva o grupo de implantação. **nota** Se quiser usar as mesmas configurações usadas em outro grupo de implantação (incluindo o nome do grupo de implantação e a configuração de implantação), escolha essas configurações nessa página. Embora esse novo grupo de implantação e o grupo de implantação existente possam ter o mesmo nome, CodeDeploy trate-os como grupos de implantação separados, pois cada um está associado a um aplicativo separado. 1. Em **Função de serviço**, escolha uma função de serviço que conceda CodeDeploy acesso AWS Lambda a. Para obter mais informações, consulte [Etapa 2: criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md). 1. Se você deseja usar uma configuração de implantação predefinida, selecione uma opção em **Deployment configuration (Configuração de implantação)** e vá para a etapa 12. Para criar uma configuração personalizada, vá para a próxima etapa. Para obter mais informações sobre configurações de implantação, consulte [Configurações de implantação em uma plataforma de AWS Lambda computação](deployment-configurations.md#deployment-configuration-lambda). 1. Para criar uma configuração personalizada, escolha **Create deployment configuration (Criar uma configuração de implantação)** e faça o seguinte: 1. Em **Deployment configuration name (Nome da configuração de implantação)**, digite um nome para a configuração. 1. Em **Type (Tipo)**, escolha um tipo de configuração. Se você escolher **Canário**, o tráfego será deslocado em dois incrementos. Se você escolher **Linear**, o tráfego será deslocado em incrementos iguais com um número igual de minutos entre cada incremento. 1. Em **Etapa**, digite uma porcentagem do tráfego, entre 1 e 99, que será deslocada. Se o seu tipo de configuração é **Canário**, essa é a porcentagem do tráfego que será deslocada no primeiro incremento. O tráfego restante é deslocado após o intervalo selecionado no segundo incremento. Se o seu tipo de configuração é **Linear**, essa é a porcentagem do tráfego que será deslocada no início de cada intervalo. 1. Em **Interval (lntervalo)**, digite um valor em minutos. Se o seu tipo de configuração é **Canário**, esse é o número de minutos entre o primeiro e o segundo deslocamento de tráfego. Se o seu tipo de configuração é **Linear**, esse é o número de minutos entre cada deslocamento incremental. **nota** A duração máxima de uma AWS Lambda implantação é de dois dias ou 2.880 minutos. Portanto, o valor máximo especificado por **Intervalo** para uma configuração canário é 2.800 minutos. O valor máximo de uma configuração linear depende do valor de **Etapa**. Por exemplo, se a porcentagem de etapa de um deslocamento de tráfego linear for 25%, haverá quatro deslocamentos de tráfego. O valor máximo do intervalo é 2.880 dividido por quatro, ou 720 minutos. 1. Escolha **Criar configuração de implantação**. 1. (Opcional) Em **Avançado**, configure todas as opções que você deseja incluir na implantação, como acionadores de notificação do Amazon SNS, alarmes da CloudWatch Amazon ou reversões automáticas. Para obter mais informações, consulte [Configurar opções avançadas para um grupo de implantação](deployment-groups-configure-advanced-options.md). 1. Selecione **Criar grupo de implantação**. # Criar um aplicativo (CLI) Para usar o AWS CLI para criar um aplicativo, chame o comando [create-application](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-application.html), especificando um nome que represente exclusivamente o aplicativo. (Em uma AWS conta, o nome do CodeDeploy aplicativo só pode ser usado uma vez por região. Você pode reutilizar o nome de um aplicativo em diferentes regiões.) Depois de usar o AWS CLI para criar um aplicativo, a próxima etapa é criar um grupo de implantação que especifique as instâncias nas quais implantar as revisões. Para instruções, consulte [Crie um grupo de implantação com CodeDeploy](deployment-groups-create.md). Depois de criar o grupo de implantação, a próxima etapa é preparar uma revisão a ser implantada no aplicativo e grupo de implantação. Para instruções, consulte [Trabalhando com revisões de aplicativos para CodeDeploy](application-revisions.md). # Veja os detalhes do aplicativo com CodeDeploy Você pode usar o CodeDeploy console AWS CLI, o ou o CodeDeploy APIs para ver detalhes sobre todos os aplicativos associados à sua AWS conta. **Topics** + [Visualizar detalhes de aplicativos (console)](#applications-view-details-console) + [Visualizar detalhes de aplicativos (CLI)](#applications-view-details-cli) ## Visualizar detalhes de aplicativos (console) Para usar o CodeDeploy console para visualizar os detalhes do aplicativo: 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. No painel de navegação, expanda a opção **Implantar** e selecione **Introdução**. 1. Para visualizar detalhes de aplicativos adicionais, escolha o nome do aplicativo na lista. ## Visualizar detalhes de aplicativos (CLI) Para usar o AWS CLI para visualizar os detalhes do aplicativo, chame o **get-application** **batch-get-application** comando, o comando ou o **list-applications** comando. Para visualizar detalhes sobre um único aplicativo, chame o comando [get-application](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-application.html), especificando o nome do aplicativo. Para visualizar detalhes sobre vários aplicativos, chame o comando [batch-get-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-applications.html), especificando vários nomes de aplicativos. 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). # Criar uma regra de notificação É possível usar regras de notificação para notificar os usuários quando houver alterações nos aplicativos de implantação, como êxitos e falhas de implantação. As regras de notificação especificam os eventos e o tópico do Amazon SNS que é usado para enviar notificações. Para obter mais informações, consulte [O que são notificações?](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/welcome.html) Você pode usar o console ou o AWS CLI para criar regras de notificação para AWS CodeDeploy. # Como criar uma regra de notificaçã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/). 1. Escolha **Application (Aplicativo)** e selecione um aplicativo em que você deseja adicionar notificações. 1. Na página do aplicativo, escolha **Notify (Notificar)** e **Create notification rule (Criar regra de notificação)**. Também é possível acessar a página **Settings (Configurações)** do aplicativo e escolher **Create notification rule (Criar regra de notificação)**. 1. Em **Notification name (Nome da notificação)**, insira um nome para a regra. 1. Em **Tipo de detalhe**, escolha **Básico** se quiser que somente as informações fornecidas à Amazon sejam EventBridge incluídas na notificação. Escolha **Completo** se quiser incluir informações fornecidas à Amazon EventBridge e informações que possam ser fornecidas pelo gerenciador de notificações CodeDeploy ou pelo gerenciador de notificações. Para obter mais informações, consulte [Noções básicas sobre o conteúdo e a segurança de notificações](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications). 1. Em **Events that trigger notifications (Eventos que acionam notificações)**, selecione os eventos para os quais você deseja enviar notificações. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/notification-rule-create.html) 1. Em **Targets (Destinos)**, escolha **Create SNS topic (Criar tópico do SNS)**. **nota** Quando você cria o tópico, a política que CodeDeploy permite publicar eventos no tópico é aplicada a você. Usar um tópico criado especificamente para CodeDeploy notificações também ajuda a garantir que você adicione somente usuários à lista de assinaturas desse tópico para os quais deseja ver notificações sobre esse aplicativo de implantação. Após o prefixo **codestar-notifications-**, insira um nome para o tópico e escolha **Submit (Enviar)**. **nota** Se desejar usar um tópico do Amazon SNS existente em vez de criar um novo, em **Targets** (Destinos), escolha o ARN. Certifique-se de que o tópico tenha a política de acesso apropriada e que a lista de assinantes contenha somente os usuários que têm permissão para ver informações sobre o aplicativo de implantação. Para obter mais informações, consulte [Configurar tópicos do Amazon SNS existentes para notificações](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/set-up-sns.html) e [Noções básicas sobre conteúdos de notificações e segurança](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications). 1. Para concluir a criação da regra, escolha **Submit (Enviar)**. 1. Você precisa inscrever os usuários no tópico do Amazon SNS para a regra antes que eles possam receber notificações. Para obter mais informações, consulte [Inscrever usuários em tópicos do Amazon SNS que são destinos](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/subscribe-users-sns.html). Você também pode configurar a integração entre as notificações e o Amazon Q Developer em aplicações de chat a fim de enviar notificações para salas de chat do Amazon Chime ou canais do Slack. Para acessar mais informações, consulte [Configure integration between notifications and Amazon Q Developer in chat applications](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html). # Criar uma regra de notificação (AWS CLI) 1. Em um terminal ou prompt de comando, execute o comando **create-notification rule** para gerar o esqueleto JSON: ``` aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json ``` É possível nomear o arquivo como você quiser. Neste exemplo, o nome do arquivo é *rule.json*. 1. Abra o arquivo JSON em um editor de texto simples e edite-o para incluir o recurso, os tipos de evento e o destino do Amazon SNS que você deseja para a regra. O exemplo a seguir mostra uma regra de notificação com **MyNotificationRule** o nome de um aplicativo nomeado *MyDeploymentApplication* em uma AWS conta com o ID*123456789012*. As notificações são enviadas com o tipo de detalhe completo para um tópico do Amazon SNS chamado *codestar-notifications-MyNotificationTopic* quando as implantações são bem-sucedidas: ``` { "Name": "MyNotificationRule", "EventTypeIds": [ "codedeploy-application-deployment-succeeded" ], "Resource": "arn:aws:codebuild:us-east-2:123456789012:MyDeploymentApplication", "Targets": [ { "TargetType": "SNS", "TargetAddress": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyNotificationTopic" } ], "Status": "ENABLED", "DetailType": "FULL" } ``` Salve o arquivo. 1. Usando o arquivo que você acabou de editar, no terminal ou na linha de comando, execute o comando **create-notification-rule** novamente para criar a regra de notificação: ``` aws codestar-notifications create-notification-rule --cli-input-json file://rule.json ``` 1. Se for bem-sucedido, o comando retornará o ARN da regra de notificação, semelhante ao seguinte: ``` { "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE" } ``` # Renomear um aplicativo do CodeDeploy É possível usar a AWS CLI ou as APIs do CodeDeploy para alterar o nome de um aplicativo. Para visualizar uma lista de nomes de aplicativos, use a AWS CLI para chamar o comando [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html). Para obter informações sobre como usar a AWS CLI para alterar um nome de aplicativo, consulte [update-application](https://docs.aws.amazon.com/cli/latest/reference/deploy/update-application.html). Para obter informações sobre como usar as APIs do CodeDeploy para alterar um nome de aplicativo, consulte [API\$1UpdateApplication](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_UpdateApplication.html). # Excluir um aplicativo no CodeDeploy É possível usar o console do CodeDeploy, a AWS CLI ou uma ação de API do CodeDeploy para excluir aplicativos. Para obter informações sobre como usar a ação de API do CodeDeploy, consulte [DeleteApplication](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteApplication.html). **Atenção** A exclusão de um aplicativo remove informações sobre ele do sistema do CodeDeploy, incluindo todas as informações relacionadas ao grupo de implantação e os detalhes da implantação. A exclusão de um aplicativo criado para uma implantação do EC2/On-Premises não remove qualquer revisão de aplicativo de instâncias nem revisões dos buckets do Amazon S3. A exclusão de um aplicativo criado para uma implantação do EC2/On-Premises não encerra nenhuma instância do Amazon EC2 ou cancela o registro de qualquer instância no local. Esta ação não pode ser desfeita. **Topics** + [Excluir um aplicativo (console)](#applications-delete-console) + [Excluir um aplicativo (AWS CLI)](#applications-delete-cli) ## Excluir um aplicativo (console) Para usar o console do CodeDeploy para excluir um aplicativo: 1. Faça login no Console de gerenciamento da AWS e abra o console do CodeDeploy 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. No painel de navegação, expanda a opção **Implantar** e escolha **Aplicações**. 1. Na lista de aplicações, escolha aquela que você deseja excluir. Uma página contendo detalhes sobre o aplicativo é exibida. 1. Escolha **Excluir aplicativo** no canto superior direito. 1. Quando solicitado, digite **delete** para confirmar que você deseja excluí-lo e, em seguida, escolha **Excluir**. ## Excluir um aplicativo (AWS CLI) Para usar a AWS CLI para excluir um aplicativo, chame o comando [delete-application](https://docs.aws.amazon.com/cli/latest/reference/deploy/delete-application.html), especificando o nome do 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).