Etapa 4: implantar seu aplicativo WordPress

A implantação precisa de um grupo de implantação. No entanto, antes de criar o grupo de implantação, você precisa de um ARN de um perfil de serviço. Um perfil de serviço é um perfil do IAM que dá a um serviço permissão para agir em seu nome. Nesse caso, o perfil de serviço concede ao CodeDeploy permissão para acessar as instâncias do Amazon EC2 e expandir (ler) as tags da instância do Amazon EC2.

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 o ARN do perfil de serviço, consulte Obter o ARN do perfil de serviço (CLI) .

Agora que você tem o ARN do perfil de serviço, chame o comando create-deployment-group para criar um grupo de implantação chamado WordPress_DepGroup, associado ao aplicativo chamado WordPress_App, usando a tag do Amazon EC2 chamada CodeDeployDemo e a configuração de implantação chamada CodeDeployDefault.OneAtATime:

aws deploy create-deployment-group \
  --application-name WordPress_App \
  --deployment-group-name WordPress_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 agente do CodeDeploy 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 *)" 

Este comando cria uma associação no gerenciador de estados do Systems Manager que instalará o agente do CodeDeploy e, depois, tentará atualizá-lo todo domingo às 2h. Para obter mais informações sobre o agente do CodeDeploy, consulte Trabalhar com o agente do CodeDeploy. 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 WordPress_App, a configuração de implantação CodeDeployDefault.OneAtATime e o grupo de implantação WordPress_DepGroup, usando a revisão de aplicativo WordPressApp.zip no bucket amzn-s3-demo-bucket:

aws deploy create-deployment \
  --application-name WordPress_App \
  --deployment-config-name CodeDeployDefault.OneAtATime \
  --deployment-group-name WordPress_DepGroup \
  --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,key=WordPressApp.zip

Antes de usar o console do CodeDeploy para implantar a revisão do aplicativo, você precisa de um ARN de perfil de serviço. Um perfil de serviço é um perfil do IAM que dá a um serviço permissão para agir em seu nome. Nesse caso, o perfil de serviço concede ao CodeDeploy permissão para acessar as instâncias do Amazon EC2 e expandir (ler) as tags da instância do Amazon EC2.

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 o ARN do perfil de serviço, consulte Obter o ARN do perfil de serviço (console) .

Agora que você tem o ARN, use o console do CodeDeploy para implantar a revisão do aplicativo:

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

No painel de navegação, expanda a opção Implantar e escolha Aplicativos.

Na lista de aplicações, escolha WordPress_App.

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

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

Em Deployment type, escolha In-place deployment.

Em Configuração do ambiente, selecione Instâncias do Amazon EC2.

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

Em Chave, insira Name.

Em Valor, informe CodeDeployDemo.

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

Em Service role ARN (ARN da função de serviço), selecione o ARN da função de serviço e, em seguida, escolha Create deployment group (Criar grupo de implantação).

Escolha Criar implantação.

Em Deployment group (Grupo de implantação), selecione WordPress_DepGroup.

Ao lado de Tipo de repositório, selecione Meu aplicativo está armazenado no Amazon S3. Em Local de revisão, insira a localização da amostra de revisão do aplicativo WordPress cujo upload você fez anteriormente para o Amazon S3. Para obter a localização:

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

2. Na lista de buckets, selecione amzn-s3-demo-bucket (ou o nome do bucket no qual você fez upload da sua revisão de aplicação).

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

4. Na guia Visão geral, copie o valor do campo Link na área de transferência.

   A aparência pode ser semelhante a esta:

   https://s3.amazonaws.com/amzn-s3-demo-bucket/WordPressApp.zip

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

Se uma mensagem aparecer na lista File type (Tipo de arquivo), indicando que o tipo de arquivo não pôde ser detectado, escolha .zip.

(Opcional) Digite um comentário na caixa Deployment description.

Expanda Substituições de grupos de implantação e em Configuração de implantação, selecione CodeDeployDefault.OneAtATime.

Selecione Iniciar 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 WordPress_App e o grupo de implantação chamado WordPress_DepGroup:

aws deploy list-deployments --application-name WordPress_App --deployment-group-name WordPress_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 for Failed, você poderá chamar comandos como list-deployment-instances e get-deployment-instance para 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 nome da implantação. Depois que uma implantação falhar, uma mensagem descrevendo o motivo da falha será exibida.

Na Instance activity (Atividade da instância), mais informações sobre a implantação são exibidas. Depois que uma implantação apresentar falha, você possivelmente conseguirá determinar em quais instâncias do Amazon EC2 e em qual etapa ocorreu a falha.

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