

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Esegui le build localmente con l'agente AWS CodeBuild
<a name="use-codebuild-agent"></a>

È possibile utilizzare l' AWS CodeBuild agente per eseguire CodeBuild build su un computer locale. Sono disponibili agenti per piattaforme x86\$164 e ARM.

È inoltre possibile abbonarsi per ricevere notifiche quando vengono pubblicate nuove versioni dell'agente. 

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

Prima di iniziare, devi fare quanto segue:
+ Installa Git sul computer locale.
+ Installa e [configura Docker](https://www.docker.com/) sul tuo computer locale.

## Configura l'immagine di build
<a name="use-codebuild-agent.setup-image"></a>

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

**Per configurare l'immagine di compilazione**

1. [Se desideri utilizzare un'immagine Amazon Linux 2 curata, puoi recuperarla dal repository CodeBuild pubblico di Amazon ECR all'indirizzo https://gallery.ecr. aws/codebuild/amazonlinux-x86\$164-standard](https://gallery.ecr.aws/codebuild/amazonlinux-x86_64-standard) con il seguente comando:

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

   In alternativa, se desideri utilizzare un'altra immagine Linux, procedi nel seguente modo:

   1. Clona il repository di CodeBuild immagini:

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

   1. Passa alla cartella delle immagini. Per questo esempio, usa l'`aws/codebuild/standard:5.0`immagine:

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

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

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

1. Scarica l' CodeBuild agente.

   Per scaricare la versione x86\$164 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
   ```

1. <a name="codebuild-agent-sha"></a>L' CodeBuild agente è disponibile all'[indirizzo https://gallery.ecr. aws/codebuild/local-costruisce](https://gallery.ecr.aws/codebuild/local-builds). 

   La firma Secure Hash Algorithm (SHA) per la versione x86\$164 dell'agente è:

   ```
   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940
   ```

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

   ```
   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192
   ```

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

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

## Esegui l'agente CodeBuild
<a name="use-codebuild-agent.run-agent"></a>

**Per gestire l' CodeBuild agente**

1. Passa alla directory che contiene i sorgenti del progetto di compilazione.

1. Scarica lo 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. Esegui lo `codebuild_build.sh` script e specifica l'immagine del contenitore e la directory di output.

   Per eseguire una build x86\$164, 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 esempio `aws/codebuild/standard:5.0` o`public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0`.

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

## Ricevi notifiche per le nuove versioni degli CodeBuild agenti
<a name="receive-codebuild-agent-notifications"></a>

Puoi abbonarti alle notifiche di Amazon SNS in modo da ricevere una notifica quando vengono rilasciate nuove versioni dell' AWS CodeBuild agente. 

**Per sottoscrivere le notifiche degli CodeBuild agenti**

1. [Apri la console Amazon SNS nella versione v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home) 

1. Nella barra di navigazione, se non è già selezionata, modifica la AWS regione in **Stati Uniti orientali (Virginia settentrionale**). Devi selezionare questa AWS regione perché le notifiche Amazon SNS a cui ti stai abbonando vengono create in questa regione. 

1. Nel riquadro di navigazione, seleziona **Sottoscrizioni**. 

1. Scegli **Create Subscription (Crea sottoscrizione)**. 

1. In **Crea abbonamento, procedi** come segue: 

   1. Per **ARN dell'argomento**, utilizza il seguente Amazon Resource Name (ARN): 

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

   1. Per **Protocollo**, seleziona **-mail)** o **SMS**. 

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

   1. Scegli **Create Subscription** (Crea sottoscrizione). 

   1. Scegli **Email** per ricevere un'email che ti chiede 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 l'iscrizione alle notifiche degli CodeBuild agenti**

1. [Apri la console Amazon SNS nella versione v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home) 

1. Nel riquadro di navigazione, seleziona **Sottoscrizioni**. 

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