Seleccione sus preferencias de cookies

Usamos cookies esenciales y herramientas similares que son necesarias para proporcionar nuestro sitio y nuestros servicios. Usamos cookies de rendimiento para recopilar estadísticas anónimas para que podamos entender cómo los clientes usan nuestro sitio y hacer mejoras. Las cookies esenciales no se pueden desactivar, pero puede hacer clic en “Personalizar” o “Rechazar” para rechazar las cookies de rendimiento.

Si está de acuerdo, AWS y los terceros aprobados también utilizarán cookies para proporcionar características útiles del sitio, recordar sus preferencias y mostrar contenido relevante, incluida publicidad relevante. Para aceptar o rechazar todas las cookies no esenciales, haga clic en “Aceptar” o “Rechazar”. Para elegir opciones más detalladas, haga clic en “Personalizar”.

Ejecutar compilaciones localmente con el agente de AWS CodeBuild

Modo de enfoque
Ejecutar compilaciones localmente con el agente de AWS CodeBuild - AWS CodeBuild

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

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

    1. Clone el repositorio de imágenes de CodeBuild:

      $ 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. 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:latest

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

    $ docker pull public.ecr.aws/codebuild/local-builds:aarch64
  3. 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
  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 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

    Sustituya <container-image> por el nombre de la imagen del contenedor, como aws/codebuild/standard:5.0 o public.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 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
  1. Abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v3/home.

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

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

  4. Seleccione Create subscription.

  5. 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
    2. En Protocol (Protocolo), elija Email (Correo electrónico) o SMS.

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

    4. Seleccione 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 del agente de CodeBuild
  1. Abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v3/home.

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

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

PrivacidadTérminos del sitioPreferencias de cookies
© 2025, Amazon Web Services, Inc o sus afiliados. Todos los derechos reservados.