Ejecute compilaciones localmente con el AWS CodeBuild agente

Puede usar el AWS CodeBuild agente para ejecutar CodeBuild compilaciones en una máquina local. Hay agentes disponibles para x86_64 y plataformas. ARM

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

Requisitos previos

Antes de comenzar, haga lo siguiente:

• Instale Git en su equipo local.

• Instale y configure Docker en su máquina local.

Configure la imagen de compilación

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 ECR repositorio CodeBuild público de Amazon en https://gallery.ecr. aws/codebuild/amazonlinux2-x86_64-standard con el siguiente comando:

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

   2. 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

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

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

2. Descarga el CodeBuild agente.

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

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

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

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

3. El CodeBuild agente está disponible en https://gallery.ecr. aws/codebuild/local-compila.

   La firma del algoritmo hash seguro (SHA) para la versión x86_64 del agente es:

   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940

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

   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192

   Puede utilizarla SHA para identificar la versión del agente. Para ver la SHA firma del agente, ejecute el siguiente comando y busque lo SHA siguienteRepoDigests:

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

Ejecute el CodeBuild agente

Para ejecutar el CodeBuild agente

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

2. Descargue el 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. 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_64, utilice el comando siguiente:

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

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

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

   Reemplazar <container-image> con el nombre de la imagen del contenedor, como aws/codebuild/standard:5.0 opublic.ecr.aws/codebuild/amazonlinux2-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.

Recepción de notificaciones sobre nuevas versiones del agente de CodeBuild

Puedes suscribirte a SNS las notificaciones de Amazon para que se te notifique cuando se publiquen nuevas versiones del AWS CodeBuild agente.

Para suscribirte a las notificaciones CodeBuild de los agentes

1. Abre la SNS consola Amazon en la https://console.aws.amazon.com/sns/versión 3/home.

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

3. En el panel de navegación, seleccione Subscriptions.

4. Seleccione Create subscription.

5. En Crear suscripción, haga lo siguiente:

   1. Para el tema ARN, utilice el siguiente nombre de recurso de Amazon (ARN):

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

   2. Para Protocolo, elija Correo electrónico o SMS.

   3. Para Endpoint, elija dónde (correo electrónico oSMS) desea recibir las notificaciones. Escriba un correo electrónico, una dirección o un número de teléfono, incluido el código de área.

   4. Elija Crear una suscripción.

   5. 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 CodeBuild agentes

1. Abre la SNS consola Amazon en la https://console.aws.amazon.com/sns/versión 3/home.

2. En el panel de navegación, seleccione Suscripciones.

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