Tutorial: Implantar em instâncias do Amazon EC2 com o CodePipeline

Como criar uma função de instância

1. Abra o console do IAM em https://console.aws.amazon.com/iam/.

2. No painel do console, escolha Roles (Funções).

3. Selecione Criar perfil.

4. Em Selecionar tipo de entidade confiável, selecione AWS service (Serviço da AWS). Em Escolha um caso de uso, selecione EC2. Em Select your use case (Selecione seu caso de uso), escolha EC2. Escolha Próximo.

5. Procure e selecione a política chamada AmazonSSMManagedEC2InstanceDefaultPolicy.

6. Procure e selecione a política chamada AmazonSSMManagedInstanceCore. Escolha Próximo: etiquetas.

7. Selecione Próximo: revisar. Forneça um nome para a função (por exemplo, EC2InstanceRole).

   nota

   Anote o nome da função para a próxima etapa. Escolha essa função ao criar a instância.

   nota

   Você adicionará permissões a essa função para permitir o acesso ao bucket de artefato do S3 para o pipeline depois da criação do pipeline.

   Selecione Criar perfil.

Para executar instâncias

1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

2. Na navegação lateral, escolha Instâncias e selecione Executar instâncias na parte superior da página.

3. Em Nome, insira MyInstances. Isso atribui à instância uma tag Chave de Name e uma tag Valor de MyInstances.

4. Em Imagens da aplicação e do sistema operacional (imagem de máquina do Amazon), localize a opção AMI do Amazon Linux com o logotipo da AWS e verifique se ela está selecionada. (Essa AMI é descrita como AMI do Amazon Linux 2 (HVM) e é identificada como “Elegível para o nível gratuito”.)

5. Em Tipo de instância, selecione o tipo t2.micro elegível para o nível gratuito como configuração de hardware para a instância.

6. Na seção Par de chaves (login), selecione um par de chaves ou crie um.

7. Em Configurações de rede, verifique se o status é Habilitar.

8. Expanda Advanced details (Detalhes avançados). Em Perfil de instância do IAM, selecione o perfil do IAM criado no procedimento anterior (por exemplo, EC2InstanceRole).

   nota

   Não deixe a função da instância em branco, pois isso cria uma função padrão e não seleciona a função criada por você.

9. Em Resumo, em Número de instâncias, insira 2.

10. Escolha Iniciar instância.

11. É possível visualizar o status da ativação na página Instâncias. Ao executar uma instância, seu estado inicial é pending. Após o início da instância, seu estado muda para running e ela recebe um nome DNS público. (Se a coluna do Public DNS (DNS público) não for exibida, selecione o ícone Show/Hide (Exibir/Ocultar) e Public DNS (DNS público).)

1. Navegue até o pipeline no console do CodePipeline. Escolha Settings. Exiba o nome e o local do armazenamento de artefato de um pipeline existente. Anote o nome do recurso da Amazon (ARN) do bucket de artefato e o copie.

2. Navegue até o console do IAM e escolha Roles (Funções). Selecione a função de instância criada por você na etapa 1 deste tutorial.

3. Na guia Permissions (Permissões), escolha Add inline policy (Adicionar política em linha).

4. Adicione o JSON a seguir ao documento da política, substituindo o valor no campo Resource pelo ARN do bucket.

   {
       "Effect": "Allow",
       "Principal": "*",
       "Action": "s3:GetObject",
       "Resource": "arn:aws:s3:::BucketName"
   }

5. Selecione Atualizar.

Para adicionar um arquivo script.sh ao repositório de origem

1. Abra um editor de texto e, em seguida, copie e cole o arquivo acima em um novo arquivo.

2. Confirme e envie o arquivo script.sh para o repositório de origem.

   1. Adicione o arquivo.

      git add .

   2. Confirme a alteração.

      git commit -m "Adding script.sh."

   3. Envie a confirmação.

      git push

   Anote o caminho no repositório.

   /MyDemoRepo/test/script.sh

Para criar o pipeline

1. Abra o console do CodePipeline em https://console.aws.amazon.com/codesuite/codepipeline/.

2. Na página Welcome (Bem-vindo), Getting started (Conceitos básicos) ou Pipelines, selecione Create pipeline (Criar pipeline).

3. Na página Etapa 1: Escolher opção de criação, em Opções de criação, selecione a opção Criar pipeline personalizado. Escolha Próximo.

4. Em Etapa 2: Escolher as configurações do pipeline, em Nome do pipeline, insira MyPipeline.

5. O CodePipeline disponibiliza pipelines dos tipos V1 e V2, que apresentam características e custos diferentes. O tipo V2 é o único tipo que você pode escolher no console. Para ter mais informações, consulte Pipeline types. Para obter informações sobre preços do CodePipeline, consulte Preços.

6. Em Perfil de serviço, escolha Usar perfil de serviço existente e o perfil de serviço do CodePipeline que foi atualizado com as permissões necessárias para essa ação. Para configurar o perfil de serviço do CodePipeline dessa ação, consulte Permissões de política do perfil de serviço para a ação de implantação do EC2.

7. Deixe as configurações em Advanced settings (Configurações avançadas) como padrão e escolha Next (Próximo).

8. Na página Etapa 3: Adicionar etapa de origem, adicione uma etapa de origem:

   1. Em Provedor de origem, escolha GitHub (por meio do aplicativo do GitHub).

   2. Em Conexão, escolha uma conexão existente ou crie uma nova. Para criar ou gerenciar uma conexão para sua ação de origem do GitHub, consulte Conexões do GitHub.

   3. Em Nome do repositório, selecione o nome do seu repositório do GitHub.

   Escolha Próximo.

9. Na página Etapa 4: Adicionar etapa de compilação, escolha Ignorar.

10. Na página Etapa 5: Adicionar etapa de implantação, escolha EC2.

    

    1. Em Diretório de destino, insira o diretório na instância na qual você deseja implantar, como /home/ec2-user/testhelloworld.

       nota

       Especifique o diretório de implantação que você deseja que a ação use na instância. A ação automatizará a criação do diretório especificado na instância como parte da implantação.

    2. Para PostScript, insira o caminho e o nome do arquivo do script, comotest/script.sh.

    3. Escolha Próximo.

11. Na página Step 6: Review, revise a configuração do pipeline e escolha Create pipeline para criá-lo.

    

12. Depois que o pipeline for executado com êxito, escolha Visualizar detalhes para exibir os logs na ação a fim de exibir a saída da ação da computação gerenciada.

    
    

Para testar o pipeline

1. Faça uma alteração no código no repositório de origem configurado, confirme e envie a alteração.

2. Abra o console do CodePipeline em https://console.aws.amazon.com/codesuite/codepipeline/.

3. Escolha o pipeline na lista.

4. Observe a evolução do pipeline pelos respectivos estágios. O pipeline deve ser concluído, e a ação implanta o script nas instâncias.

5. Para obter mais informações sobre solução de problemas, consulte A ação Implantar do EC2 falha com uma mensagem de erro No such file.