

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Execute compilações localmente com o agente AWS CodeBuild
<a name="use-codebuild-agent"></a>

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

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

## Pré-requisitos
<a name="use-codebuild-agent.prerequisites"></a>

Antes de começar, será necessário fazer o seguinte:
+ Instale o Git na sua máquina local.
+ Instale e configure o [Docker](https://www.docker.com/) na máquina local.

## Configurar a imagem de compilação
<a name="use-codebuild-agent.setup-image"></a>

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 repositório CodeBuild público do Amazon ECR em https://gallery.ecr. aws/codebuild/amazonlinux-x86\$164-standard](https://gallery.ecr.aws/codebuild/amazonlinux-x86_64-standard) com o seguinte comando:

   ```
   $ docker pull public.ecr.aws/codebuild/amazonlinux-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
      ```

   1. 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
      ```

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

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

1. Baixe o CodeBuild agente.

   Para baixar a versão x86\$164 do agente, execute o seguinte comando:

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

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

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

1. <a name="codebuild-agent-sha"></a>O CodeBuild agente está disponível em [https://gallery.ecr. aws/codebuild/local-constrói](https://gallery.ecr.aws/codebuild/local-builds). 

   A assinatura do Secure Hash Algorithm (SHA) para a versão x86\$164 do agente é:

   ```
   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940
   ```

   A assinatura SHA para a versão ARM do agente é:

   ```
   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192
   ```

   É possível usar o SHA para identificar a versão do agente. Para ver a assinatura SHA do agente, execute o seguinte comando e procure o SHA em `RepoDigests`: 

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

## Execute o CodeBuild agente
<a name="use-codebuild-agent.run-agent"></a>

**Para executar o CodeBuild agente**

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

1. Baixe o script [codebuild\$1build.sh](https://github.com/aws/aws-codebuild-docker-images/blob/master/local_builds/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
   ```

1. 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\$164, execute o seguinte comando:

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

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

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

   *<container-image>*Substitua pelo nome da imagem do contêiner, como `aws/codebuild/standard:5.0` ou`public.ecr.aws/codebuild/amazonlinux-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.

## Receba notificações sobre novas versões do CodeBuild agente
<a name="receive-codebuild-agent-notifications"></a>

Você pode assinar as notificações do Amazon SNS 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 console do Amazon SNS em https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home) 

1. 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 notificações do Amazon SNS que você está assinando são criadas nessa região. 

1. No painel de navegação, escolha ** Subscriptions**. 

1. Selecione **Create subscription**. 

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

   1. Para **Topic ARN** (ARN do tópico), use o seguinte nome do recurso da Amazon (ARN): 

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

   1. Em **Protocolo**, escolha **Email** ou **SMS**. 

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

   1. Selecione **Criar assinatura**. 

   1. 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 console do Amazon SNS em https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home) 

1. No painel de navegação, escolha **Assinaturas**. 

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