Etapa 4: implantar seu aplicativo Hello World

Primeiro, a implantação precisa de um grupo de implantação. No entanto, antes de criar o grupo de implantação, você precisa de uma função de serviçoARN. Uma função de serviço é uma IAM função que dá permissão ao serviço para agir em seu nome. Nesse caso, a função de serviço dá CodeDeploy permissão para acessar suas EC2 instâncias da Amazon para expandir (ler) suas tags de EC2 instância da Amazon.

Você já deve ter seguido as instruções em Criar um perfil de serviço (CLI) para criar um perfil de serviço. Para obter a função ARN de serviço, consulteObter o ARN do perfil de serviço (CLI) .

Agora que você tem oARN, chame o create-deployment-group comando para criar um grupo de implantação chamadoHelloWorld_DepGroup, associado ao aplicativo nomeadoHelloWorld_App, usando a tag de EC2 instância da Amazon nomeada CodeDeployDemo e a configuração de implantação nomeadaCodeDeployDefault.OneAtATime, com a função de serviçoARN:

aws deploy create-deployment-group --application-name HelloWorld_App --deployment-group-name HelloWorld_DepGroup --deployment-config-name CodeDeployDefault.OneAtATime --ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE --service-role-arn serviceRoleARN

Antes de criar uma implantação, as instâncias do seu grupo de implantação devem ter o CodeDeploy agente instalado. Você pode instalar o agente a partir da linha de comando do AWS Systems Manager , com o seguinte comando:

aws ssm create-association --name AWS-ConfigureAWSPackage --targets Key=tag:Name,Values=CodeDeployDemo --parameters action=Install,name=AWSCodeDeployAgent --schedule-expression "cron(0 2 ? * SUN *)" 

Esse comando cria uma associação no Systems Manager State Manager que instalará o CodeDeploy agente e tentará atualizá-lo às 2:00 de cada manhã de domingo. Para obter mais informações sobre o CodeDeploy agente, consulte Trabalhando com o CodeDeploy agente. Para obter mais informações sobre o Systems Manager, consulte O que é o AWS Systems Manager.

Agora, chame o comando create-deployment para criar uma implantação associada ao aplicativo HelloWorld_App, a configuração de implantação CodeDeployDefault.OneAtATime e o grupo de implantação HelloWorld_DepGroup, usando a revisão de aplicativo HelloWorld_App.zip no bucket amzn-s3-demo-bucket:

aws deploy create-deployment --application-name HelloWorld_App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name HelloWorld_DepGroup --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,key=HelloWorld_App.zip

Antes de usar o CodeDeploy console para implantar a revisão do aplicativo, você precisa de uma função de serviçoARN. Uma função de serviço é uma IAM função que dá permissão ao serviço para agir em seu nome. Nesse caso, a função de serviço dá CodeDeploy permissão para acessar suas EC2 instâncias da Amazon para expandir (ler) suas tags de EC2 instância da Amazon.

Você já deve ter seguido as instruções em Criar um perfil de serviço (console) para criar um perfil de serviço. Para obter a função ARN de serviço, consulteObter o ARN do perfil de serviço (console) .

Agora que você tem oARN, você pode usar o CodeDeploy console para implantar a revisão do seu aplicativo.

Faça login no AWS Management Console e abra o CodeDeploy console em https://console.aws.amazon.com/codedeploy.

No painel de navegação, expanda a opção Implantar e escolha Aplicações.

Escolha HelloWorld_App.

Na guia Grupos de implantação, selecione Criar um grupo de implantação.

Em Nome do grupo de implantação, insira HelloWorld_DepGroup.

Em Service Role (Função do serviço), selecione o nome da função do serviço.

Em Tipo de implantação, selecione No local.

Em Configuração do ambiente, selecione EC2instâncias da Amazon.

Em Configuração do agente com AWS Systems Manager, mantenha os padrões.

Em Chave, insira Name.

Em Valor, informe CodeDeployDemo.

Em Configuração de implantação, escolha CodeDeployDefault. OneAtATime.

Em Balanceador de carga, desmarque Habilitar balanceamento de carga.

Selecione Criar grupo de implantação.

Escolha Criar implantação.

No grupo de implantação, escolha HelloWorld_ DepGroup

Em Tipo de revisão, selecione Meu aplicativo está armazenado no Amazon S3 e, em seguida, em Local de revisão, digite o local da revisão do aplicativo de exemplo Hello World! que você fez upload no Amazon S3 anteriormente. Para obter a localização:

1. Abra o console do Amazon S3 em. https://console.aws.amazon.com/s3/

2. Na lista de buckets, escolha amzn-s3-demo-bucket (ou o nome do bucket em que você fez o upload da revisão do aplicativo).

3. Na lista de objetos, escolha HelloWorld_App.zip.

4. Na guia Overview (Visão geral), selecione Copy path (Copiar caminho).

5. Retorne ao CodeDeploy console e, em Local da revisão, cole o valor do campo Link.

Em Tipo de arquivo de revisão, selecione .zip.

(Opcional) Insira um comentário em Deployment description (Descrição da implantação).

Escolha Criar implantação. As informações sobre a implantação recém-criada aparecem na página Implantações.

Obtenha o ID de implantação chamando o comando list-deployments para o aplicativo chamado HelloWorld_App e o grupo de implantação chamado HelloWorld_DepGroup:

aws deploy list-deployments --application-name HelloWorld_App --deployment-group-name HelloWorld_DepGroup --query "deployments" --output text

Chame o comando get-deployment com o ID da implantação:

aws deploy get-deployment --deployment-id deploymentID --query "deploymentInfo.status" --output text

O comando retorna o status geral da implantação. Se a implantação for bem-sucedida, o valor será Succeeded.

Se o status geral forFailed, você poderá chamar comandos como list-deployment-instancese get-deployment-instancepara solucionar problemas. Para mais opções de solução de problemas, consulte Analisando arquivos de log para investigar falhas de implantação em instâncias.

Na tabela Deployments (Implantações), selecione o ID da implantação. Depois que uma implantação apresentar falha, uma mensagem descrevendo o motivo da falha será exibida na página de detalhes da implantação.

Serão exibidas mais informações sobre as instâncias de implantação. Depois que uma implantação falhar, você poderá determinar em quais EC2 instâncias da Amazon e em qual etapa a implantação falhou.

Se quiser realizar outros procedimentos de solução de problemas, use uma técnica como View Instance Details. Você também pode analisar os arquivos de log de implantação em uma EC2 instância da Amazon. Para obter mais informações, consulte Analisando arquivos de log para investigar falhas de implantação em instâncias.