

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejecute compilaciones localmente con el AWS CodeBuild agente
<a name="use-codebuild-agent"></a>

Puede usar el AWS CodeBuild agente para ejecutar CodeBuild compilaciones en una máquina local. Hay agentes disponibles para las plataformas x86\$164 y ARM.

Es posible suscribirse para recibir notificaciones cuando se publican versiones nuevas del agente. 

## Requisitos previos
<a name="use-codebuild-agent.prerequisites"></a>

Antes de comenzar, haga lo siguiente:
+ Instale Git en su equipo local.
+ Instale y configure [Docker](https://www.docker.com/) en su máquina local.

## Configure la imagen de compilación
<a name="use-codebuild-agent.setup-image"></a>

Solo es necesario configurar la imagen de compilación la primera vez que se va a ejecutar el agente o cuando la imagen haya cambiado.

**Para configurar la imagen de compilación**

1. Si desea utilizar una imagen seleccionada de Amazon Linux 2, puede extraerla del repositorio CodeBuild público de Amazon ECR en [https://gallery.ecr. aws/codebuild/amazonlinux-x86\$164-standard](https://gallery.ecr.aws/codebuild/amazonlinux-x86_64-standard) con el siguiente comando:

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

   Como alternativa, si desea utilizar otra imagen de Linux, ejecute los pasos siguientes:

   1. Clona el repositorio CodeBuild de imágenes:

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

   1. Cambie al directorio de imágenes. En este ejemplo se utiliza la imagen de `aws/codebuild/standard:5.0`.

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

   1. Compile la imagen. Esto puede tardar varios minutos. 

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

1. Descarga el CodeBuild agente.

   Para descargar la versión x86\$164 del agente, ejecute el comando siguiente:

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

   Para descargar la versión ARMA del agente, ejecute el comando siguiente:

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

1. <a name="codebuild-agent-sha"></a>El CodeBuild agente está disponible en [https://gallery.ecr. aws/codebuild/local-compila](https://gallery.ecr.aws/codebuild/local-builds). 

   La firma del algoritmo de hash seguro (SHA) de la versión x86\$164 del agente es:

   ```
   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940
   ```

   La firma SHA de la versión ARM del agente es:

   ```
   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192
   ```

   Puede usar el SHA para identificar la versión del agente. Para ver la firma SHA del agente, ejecute el comando siguiente y busque el SHA en `RepoDigests`: 

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

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

**Para ejecutar el CodeBuild agente**

1. Cambie al directorio que contiene el código fuente del proyecto de compilación.

1. Descargue el 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. Ejecute el script de `codebuild_build.sh` y especifique la imagen del contenedor y el directorio de salida:

   Para ejecutar una compilación de x86\$164, utilice el comando siguiente:

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

   Para ejecutar una compilación de ARM, utilice el comando siguiente:

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

   *<container-image>*Sustitúyalo por el nombre de la imagen del contenedor, como `aws/codebuild/standard:5.0` o`public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0`.

   El script lanza la imagen de compilación y ejecuta la compilación en el proyecto en el directorio actual. Para especificar la ubicación del proyecto de compilación, añada la opción `-s <build project directory>` al comando del script.

## Reciba notificaciones sobre las nuevas versiones CodeBuild del agente
<a name="receive-codebuild-agent-notifications"></a>

Puede suscribirse a las notificaciones de Amazon SNS para que se le notifique cuando se publiquen nuevas versiones del AWS CodeBuild agente. 

**Para suscribirse a las notificaciones de los CodeBuild agentes**

1. [Abra la consola Amazon SNS en https://console.aws.amazon.com/sns/ la versión 3/home.](https://console.aws.amazon.com/sns/v3/home) 

1. En la barra de navegación, si aún no está seleccionada, cambie la AWS región a **EE.UU. Este (Norte de Virginia).** Debe seleccionar esta AWS región porque las notificaciones de Amazon SNS a las que se está suscribiendo se crean en esta región. 

1. En el panel de navegación, seleccione **Subscriptions**. 

1. Seleccione **Create subscription**. 

1. En **Crear suscripción**, haga lo siguiente: 

   1. En **Topic ARN**, use el siguiente nombre de recurso de Amazon (ARN): 

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

   1. En **Protocol (Protocolo)**, elija **Email (Correo electrónico)** o **SMS**. 

   1. En **Endpoint (Punto de conexión)**, elija dónde desea recibir las notificaciones (por correo electrónico o SMS). Escriba un correo electrónico, una dirección o un número de teléfono, incluido el código de área. 

   1. Seleccione **Crear subscripción**. 

   1. Seleccione **Correo electrónico** para recibir un correo electrónico en el que se le pedirá que confirme la suscripción. Siga las instrucciones del mensaje para completar la suscripción. 

      Si ya no desea recibir estas notificaciones, utilice el siguiente procedimiento para cancelar la suscripción. 

**Para cancelar la suscripción a las notificaciones de los agentes CodeBuild**

1. [Abra la consola Amazon SNS en https://console.aws.amazon.com/sns/ la versión 3/home.](https://console.aws.amazon.com/sns/v3/home) 

1. En el panel de navegación, seleccione **Suscripciones**. 

1. Elija la suscripción y, en **Actions (Acciones)**, elija **Delete subscriptions (Eliminar suscripciones)**. Cuando se le pida confirmación, elija **Delete**. 