Execute compilações localmente com o agente AWS CodeBuild

Você pode usar o AWS CodeBuild agente para executar CodeBuild compilações em uma máquina local. Há agentes disponíveis para x86_64 e plataformas. ARM

Também é possível assinar para receber notificações quando novas versões do agente são publicadas.

Pré-requisitos

Antes de começar, será necessário fazer o seguinte:

• Instale o Git na sua máquina local.

• Instale e configure o Docker na máquina local.

Configurar a imagem de compilação

Basta configurar a imagem de compilação na primeira vez em que executar o agente ou quando a imagem for alterada.

Como configurar a imagem de compilação

1. Se quiser usar uma imagem curada do Amazon Linux 2, você pode extraí-la do ECR repositório CodeBuild público da Amazon em https://gallery.ecr.aws/codebuild/amazonlinux2-x86_64-standard com o seguinte comando:

   $ docker pull public.ecr.aws/codebuild/amazonlinux2-x86_64-standard:4.0

   Como alternativa, se você deseja usar outra imagem do Linux, execute as seguintes etapas:

   1. Clone o repositório CodeBuild de imagens:

      $ git clone https://github.com/aws/aws-codebuild-docker-images.git

   2. Mude para o diretório de imagens. Para este exemplo, use a imagem aws/codebuild/standard:5.0:

      $ cd aws-codebuild-docker-images/ubuntu/standard/5.0

   3. Crie a imagem. Isso levará vários minutos.

      $ docker build -t aws/codebuild/standard:5.0 .

2. Baixe o CodeBuild agente.

   Para baixar a versão x86_64 do agente, execute o seguinte comando:

   $ docker pull public.ecr.aws/codebuild/local-builds:latest

   Para baixar a ARM versão do agente, execute o seguinte comando:

   $ docker pull public.ecr.aws/codebuild/local-builds:aarch64

3. O CodeBuild agente está disponível em https://gallery.ecr.aws/codebuild/local-builds.

   A assinatura do Secure Hash Algorithm (SHA) para a versão x86_64 do agente é:

   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940

   A SHA assinatura da ARM versão do agente é:

   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192

   Você pode usar o SHA para identificar a versão do agente. Para ver a SHA assinatura do agente, execute o comando a seguir e procure o SHA seguinteRepoDigests:

   $ docker inspect public.ecr.aws/codebuild/local-builds:latest

Execute o CodeBuild agente

Para executar o CodeBuild agente

1. Mude para o diretório que contém a fonte do projeto de compilação.

2. Baixe o script codebuild_build.sh.

   $ curl -O  https://raw.githubusercontent.com/aws/aws-codebuild-docker-images/master/local_builds/codebuild_build.sh
   $ chmod +x codebuild_build.sh

3. Execute o script codebuild_build.sh e especifique as imagens de contêiner e o diretório de saída:

   Para executar uma compilação x86_64, execute o seguinte comando:

   $ ./codebuild_build.sh -i <container-image> -a <output directory>

   Para executar uma ARM compilação, execute o seguinte comando:

   $ ./codebuild_build.sh -i <container-image> -a <output directory> -l public.ecr.aws/codebuild/local-builds:aarch64

   Substituir <container-image> com o nome da imagem do contêiner, como aws/codebuild/standard:5.0 oupublic.ecr.aws/codebuild/amazonlinux2-x86_64-standard:4.0.

   O script inicia a imagem de compilação e executa a compilação no projeto no diretório atual. Para especificar a localização do projeto de compilação, adicione a opção -s <build project directory> ao comando script.

Receber notificações sobre novas versões do agente do CodeBuild

Você pode assinar SNS as notificações da Amazon para ser notificado quando novas versões do AWS CodeBuild agente forem lançadas.

Para assinar as notificações CodeBuild do agente

1. Abra o SNS console da Amazon em https://console.aws.amazon.com/sns/v3/home.

2. Na barra de navegação, se ainda não estiver selecionada, altere a AWS região para Leste dos EUA (Norte da Virgínia). Você deve selecionar essa AWS região porque as SNS notificações da Amazon que você está assinando são criadas nessa região.

3. No painel de navegação, escolha Subscriptions.

4. Selecione Create subscription.

5. Em Criar inscrição, faça o seguinte:

   1. Para Tópico ARN, use o seguinte nome de recurso da Amazon (ARN):

      arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates

   2. Em Protocolo, escolha E-mail ou SMS.

   3. Para Endpoint, escolha onde (e-mail ouSMS) receber as notificações. Digite um e-mail, um endereço ou número de telefone, incluindo o código de área.

   4. Selecione Create subscription.

   5. Se você escolher E-mail, receberá um e-mail solicitando que confirme a inscrição. Siga as instruções no e-mail para concluir sua inscrição.

      Se não deseja mais receber essas notificações, use o procedimento a seguir para cancelar a assinatura.

Para cancelar a assinatura das notificações do CodeBuild agente

1. Abra o SNS console da Amazon em https://console.aws.amazon.com/sns/v3/home.

2. No painel de navegação, escolha Subscriptions.

3. Selecione a assinatura e, em Actions (Ações), escolha Delete subscriptions (Excluir assinaturas). Quando for solicitada sua confirmação, escolha Delete.