Puede utilizar el agente de AWS CodeBuild para ejecutar compilaciones de CodeBuild en un equipo local. Hay agentes disponibles para las plataformas x86_64 y 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
-
Si desea utilizar una imagen seleccionada de Amazon Linux 2, puede extraerla del repositorio público de Amazon ECR de CodeBuild en https://gallery.ecr.aws/codebuild/amazonlinux2-x86_64-standard
con este comando: $
docker pull public.ecr.aws/codebuild/amazonlinux2-x86_64-standard:4.0Como alternativa, si desea utilizar otra imagen de Linux, ejecute los pasos siguientes:
-
Clone el repositorio de imágenes de CodeBuild:
$
git clone https://github.com/aws/aws-codebuild-docker-images.git -
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 -
Compile la imagen. Esto puede tardar varios minutos.
$
docker build -t aws/codebuild/standard:5.0 .
-
-
Descargue el agente de CodeBuild.
Para descargar la versión x86_64 del agente, ejecute el comando siguiente:
$
docker pull public.ecr.aws/codebuild/local-builds:latestPara descargar la versión ARMA del agente, ejecute el comando siguiente:
$
docker pull public.ecr.aws/codebuild/local-builds:aarch64 -
El agente de CodeBuild está disponible en https://gallery.ecr.aws/codebuild/local-builds.
La firma del algoritmo de hash seguro (SHA) de la versión x86_64 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
Ejecutar el agente de CodeBuild
Para ejecutar el agente de CodeBuild
-
Cambie al directorio que contiene el código fuente del proyecto de compilación.
-
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 -
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 compilación de ARM, utilice el comando siguiente:
$
./codebuild_build.sh -i<container-image>
-a<output directory>
-l public.ecr.aws/codebuild/local-builds:aarch64Sustituya
<container-image>
por el nombre de la imagen del contenedor, comoaws/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
al comando del script.<build project directory>
Recepción de notificaciones de versiones nuevas del agente de CodeBuild
Puede suscribirse a las notificaciones de Amazon SNS para saber cuándo se lanzan nuevas versiones del agente de AWS CodeBuild.
Para suscribirse a las notificaciones del agente de CodeBuild
-
Abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v3/home
. -
En la barra de navegación, si aún no está seleccionada, cambie la región de AWS a Este de EE. UU. (Norte de Virginia). Debe seleccionar esta región de AWS porque las notificaciones de Amazon SNS a las que se va a suscribir se crean en esa región.
-
En el panel de navegación, seleccione Subscriptions.
-
Seleccione Create subscription.
-
En Crear suscripción, haga lo siguiente:
-
En Topic ARN, use el siguiente nombre de recurso de Amazon (ARN):
arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates
-
En Protocol (Protocolo), elija Email (Correo electrónico) o SMS.
-
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.
-
Seleccione Crear una suscripción.
-
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 del agente de CodeBuild
-
Abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v3/home
. -
En el panel de navegación, seleccione Subscriptions.
-
Elija la suscripción y, en Actions (Acciones), elija Delete subscriptions (Eliminar suscripciones). Cuando se le pida confirmación, elija Delete.