Tutorial: implante em EC2 instâncias da Amazon com 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 Selecione seu caso de uso, escolha EC2. Escolha Próximo: Permissões.

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

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 artefatos do S3 para seu pipeline após a criação do pipeline.

   Selecione Criar perfil.

Para executar instâncias

1. Abra o EC2 console da Amazon 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 do aplicativo e do sistema operacional (Amazon Machine Image), localize a opção Amazon Linux AMI com o AWS logotipo 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 é Ativar.

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 que você criou.

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

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é seu pipeline no CodePipeline console. Escolha Configurações. Visualize o nome e a localização do armazenamento de artefatos de um pipeline existente. Anote o repositório de artefatos Amazon Resource Name (ARN) e copie-o.

2. Navegue até o console do IAM e escolha Roles (Funções). Escolha a função de instância que você criou na Etapa 1 deste tutorial.

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

4. Adicione o seguinte JSON ao documento de política, substituindo o valor no Resource campo 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 seu repositório.

   /MyDemoRepo/test/script.sh

Para criar o pipeline

1. Abra o CodePipeline console em https://console.aws.amazon.com/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. CodePipeline fornece tubulações do tipo V1 e V2, que diferem em características e preço. 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 de CodePipeline, consulte Preços.

6. Em Função de serviço, escolha Usar função de serviço existente e, em seguida, escolha a função de CodePipeline serviço que foi atualizada com as permissões necessárias para essa ação. Para configurar sua função CodePipeline de serviço para essa ação, consultePermissões da política de função de serviço para a ação de EC2 implantação.

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 (via GitHub aplicativo).

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

   3. Em Repository name (Nome do repositório), selecione o nome do seu repositório do GitHub .

   Escolha Próximo.

9. Na página Etapa 4: Adicionar estágio de construção, escolha Ignorar.

10. Na página Etapa 5: Adicionar estágio 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 para seu 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 Exibir detalhes para ver os registros da ação e ver a saída da ação de 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 CodePipeline console em https://console.aws.amazon.com/codepipeline/.

3. Escolha o pipeline na lista.

4. Observe a evolução do pipeline pelos respectivos estágios. Seu pipeline deve ser concluído e sua ação implanta o script em suas instâncias.

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