Esegui build localmente conAWS CodeBuildagente

È possibile utilizzareAWS CodeBuildagente da gestireCodeBuildsi basa su un computer locale. Sono disponibili agenti per piattaforme x86_64 e ARM.

Puoi anche iscriverti per ricevere notifiche quando vengono pubblicate nuove versioni dell'agente.

Prerequisiti

Prima di iniziare, devi fare quanto segue:

• Installa Git sul computer locale.

• Installazione e configurazionedockersul tuo computer locale.

Configura l'immagine di build

È necessario configurare l'immagine di build solo la prima volta che si esegue l'agente o quando l'immagine è cambiata.

Per configurare l'immagine di build

1. Se desideri utilizzare un'immagine Amazon Linux 2 curata, puoi estrarla dalCodeBuildarchivio Amazon ECR pubblico all'indirizzohttps://gallery.ecr.aws/codebuild/amazonlinux2-x86_64-standardcon il seguente comando:

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

   In alternativa, se desideri utilizzare un'altra immagine Linux, procedi come segue:

   1. Clona ilCodeBuildrepository di immagini:

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

   2. Passa alla cartella delle immagini. Per questo esempio, usaaws/codebuild/standard:5.0immagine:

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

   3. Costruisci l'immagine. Questo processo può richiedere diversi minuti.

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

2. Scarica l'agente di CodeBuild.

   Per scaricare la versione x86_64 dell'agente, esegui il seguente comando:

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

   Per scaricare la versione ARM dell'agente, esegui il seguente comando:

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

3. LaCodeBuildl'agente è disponibile pressohttps://gallery.ecr.aws/codebuild/local-builds.

   La firma Secure Hash Algorithm (SHA) per la versione x86_64 dell'agente è:

   sha256:fac17c6d6c3cb500f6e7975887de1e41d29a9e70a86d6f49f76a2beacfcf967e

   La firma SHA per la versione ARM dell'agente è:

   sha256:57a5dfda63be50edce13dea16dcd5e73e8d8559029658ba08b793c9a7adc68c7

   È possibile utilizzare lo SHA per identificare la versione dell'agente. Per visualizzare la firma SHA dell'agente, esegui il seguente comando e cerca lo SHA sottoRepoDigests:

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

Esegui ilCodeBuildagente

Per eseguire ilCodeBuildagente

1. Passa alla directory che contiene il sorgente del tuo progetto di build.

2. Scarica ilcodebuild_build.shsceneggiatura:

   $ curl -O  https://raw.githubusercontent.com/aws/aws-codebuild-docker-images/master/local_builds/codebuild_build.sh
   $ chmod +x codebuild_build.sh

3. Esegui ilcodebuild_build.shcrea uno script e specifica l'immagine del contenitore e la directory di output.

   Per eseguire una build x86_64, esegui il seguente comando:

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

   Per eseguire una build ARM, esegui il seguente comando:

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

   Sostituisci<container-image>con il nome dell'immagine del contenitore, ad esempioaws/codebuild/standard:5.0opublic.ecr.aws/codebuild/amazonlinux2-x86_64-standard:4.0.

   Lo script avvia l'immagine di build ed esegue la build sul progetto nella directory corrente. Per specificare la posizione del progetto di costruzione, aggiungi-s <build project directory>opzione al comando script.

Notifiche per le nuove versioni dell'agente CodeBuild

Puoi iscriverti alle notifiche di Amazon SNS in modo da ricevere una notifica quando nuove versioni diAWS CodeBuildgli agenti vengono rilasciati.

Per abbonarsi aCodeBuildnotifiche agli agenti

1. Apri la console Amazon SNS all'indirizzo https://console.aws.amazon.com/sns/v3/home.

2. Nella barra di navigazione, se non è già selezionata, modificaAWSRegione daStati Uniti orientali (Virginia settentrionale). Devi selezionare questoAWSRegione perché le notifiche Amazon SNS a cui ti iscrivi vengono create in questa regione.

3. Nel riquadro di navigazione scegliere Subscriptions (Iscrizioni).

4. Scegliere Create Subscription (Crea iscrizione).

5. NelCrea un abbonamento, effettuate le seguenti operazioni:

   1. Per Topic ARN (ARN argomento), usare il seguente Amazon Resource Name (ARN):

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

   2. Per Protocol (Protocollo), seleziona Email (E-mail) o SMS.

   3. Per Endpoint, scegli come ricevere le notifiche (e-mail o SMS). Inserisci un indirizzo e-mail o un numero di telefono, incluso il prefisso.

   4. Scegli Create Subscription (Crea sottoscrizione).

   5. ScegliEmailper ricevere un'email in cui ti viene chiesto di confermare l'iscrizione. Segui le istruzioni nell'e-mail per completare l'iscrizione.

      Se non desideri più ricevere queste notifiche, segui la procedura seguente per annullare la sottoscrizione.

Per annullare la sottoscrizione alle notifiche dell'agenteCodeBuild

1. Apri la console Amazon SNS all'indirizzo https://console.aws.amazon.com/sns/v3/home.

2. Nel riquadro di navigazione scegli Subscriptions (Sottoscrizioni).

3. Seleziona la sottoscrizione e da Actions (Operazioni), seleziona Delete subscriptions (Elimina sottoscrizioni). Quando viene richiesto di confermare, selezionare Delete (Elimina).