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

# Esecuzione di una compilazione (AWS CLI)
<a name="run-build-cli"></a>

**Nota**  
Per utilizzare CodePipeline per eseguire una build con AWS CodeBuild, salta questi passaggi e segui le istruzioni in[Crea una pipeline che utilizza CodeBuild ()AWS CLI](how-to-create-pipeline-cli.md).  
Per ulteriori informazioni sull'utilizzo di AWS CLI with CodeBuild, consulta[Guida di riferimento alla riga di comando](cmd-ref.md).

1. Eseguire il comando `start-build` in uno dei seguenti modi:

   ```
   aws codebuild start-build --project-name <project-name>
   ```

   Utilizzare questo comando se si desidera eseguire una compilazione che utilizza la versione più recente dell'artefatto di input di compilazione e le impostazioni correnti del progetto di compilazione.

   ```
   aws codebuild start-build --generate-cli-skeleton
   ```

   Utilizzare questo comando se si desidera eseguire una compilazione con una versione precedente dell'artefatto di input di compilazione o se si desidera ignorare le impostazioni per gli artefatti di output di compilazione, le variabili di ambiente, la buildspec il periodo di timeout di compilazione predefinito.

1. Se eseguite il **start-build** comando con l'`--project-name`opzione, sostituitelo *<project-name>* con il nome del progetto di compilazione, quindi passate al passaggio 6 di questa procedura. Per ottenere un elenco di progetti di compilazione, consulta [Visualizza i nomi dei progetti di compilazione](view-project-list.md).

1. Se esegui il **start-build** comando con l'`--idempotency-token`opzione, nella richiesta viene incluso un identificatore o token univoco con distinzione tra maiuscole e minuscole. `start-build` Il token è valido per 5 minuti dopo la richiesta . Se si ripete la `start-build` richiesta con lo stesso token, ma si modifica un parametro, viene CodeBuild restituito un errore di mancata corrispondenza del parametro.

1. Se si esegue il comando **start-build** con l'opzione `--generate-cli-skeleton`, i dati in formato JSON appaiono nell'output. Copia i dati in un file (ad esempio,`start-build.json`) in una posizione sul computer locale o sull'istanza in cui AWS CLI è installato. Modificare i dati copiati in modo che corrispondano a questo formato e salvare i risultati:

   ```
   {
     "projectName": "projectName",
     "sourceVersion": "sourceVersion",
     "artifactsOverride": {
       "type": "type",
       "location": "location",
       "path": "path",
       "namespaceType": "namespaceType",
       "name": "artifactsOverride-name",
       "packaging": "packaging"
     },
     "buildspecOverride": "buildspecOverride",
     "cacheOverride": {
       "location": "cacheOverride-location",
       "type": "cacheOverride-type"
     },
     "certificateOverride": "certificateOverride",
     "computeTypeOverride": "computeTypeOverride",
     "environmentTypeOverride": "environmentTypeOverride",
     "environmentVariablesOverride": {
       "name": "environmentVariablesOverride-name",
       "value": "environmentVariablesValue",
       "type": "environmentVariablesOverride-type"
     },
     "gitCloneDepthOverride": "gitCloneDepthOverride",
     "imageOverride": "imageOverride",
     "idempotencyToken": "idempotencyToken",
     "insecureSslOverride": "insecureSslOverride",
     "privilegedModeOverride": "privilegedModeOverride",
     "queuedTimeoutInMinutesOverride": "queuedTimeoutInMinutesOverride",
     "reportBuildStatusOverride": "reportBuildStatusOverride",
     "timeoutInMinutesOverride": "timeoutInMinutesOverride",
     "sourceAuthOverride": "sourceAuthOverride",
     "sourceLocationOverride": "sourceLocationOverride",
     "serviceRoleOverride": "serviceRoleOverride",
     "sourceTypeOverride": "sourceTypeOverride"
   }
   ```

   Sostituire i seguenti segnaposto:
   + *projectName*: stringa obbligatoria. Il nome del progetto di compilazione da utilizzare per questa compilazione. 
   + *sourceVersion*: stringa opzionale. Una versione del codice sorgente da creare, come segue:
     + Per Amazon S3, l'ID della versione che corrisponde alla versione del file ZIP di input che desideri creare. Se non *sourceVersion* è specificato, viene utilizzata la versione più recente.
     + Per CodeCommit, l'ID di commit che corrisponde alla versione del codice sorgente che desideri creare. Se non *sourceVersion* è specificato, viene utilizzato l'ID di commit HEAD del ramo predefinito. (Non è possibile specificare il nome del tag*sourceVersion*, ma è possibile specificare l'ID di commit del tag.)
     + Ad GitHub esempio, l'ID di commit, l'ID della pull request, il nome del ramo o il nome del tag che corrisponde alla versione del codice sorgente che desideri creare. Se si specifica l'ID di una richiesta pull, deve utilizzare il formato `pr/pull-request-ID` (ad esempio `pr/25`). Se un nome ramo è specificato, viene utilizzato l'ID commit HEAD del ramo. Se non *sourceVersion* è specificato, viene utilizzato l'ID di commit HEAD del ramo predefinito. 
     + Per Bitbucket, l'ID commit, il nome ramo o il nome del tag che corrisponde alla versione del codice sorgente che si desidera creare. Se un nome ramo è specificato, viene utilizzato l'ID commit HEAD del ramo. Se non *sourceVersion* è specificato, viene utilizzato l'ID di commit HEAD del ramo predefinito. 
   + I seguenti segnaposto sono per `artifactsOverride`.
     + *type*: facoltativo. Il tipo di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.
     + *location*: facoltativo. La posizione dell'artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.
     + *path*: facoltativo. Il percorso di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.
     + *namespaceType*: facoltativo. Il tipo di percorso di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.
     + *name*: facoltativo. Il nome di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.
     + *packaging*: facoltativo. Il tipo di pacchetto di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.
   + *buildspecOverride*: facoltativo. Una dichiarazione di specifiche di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione. Se questo valore è impostato, può essere una definizione buildspec inlinea oppure il percorso a un file buildspec alternativo, relativo al valore della variabile di ambiente `CODEBUILD_SRC_DIR` incorporata o al percorso di un bucket S3. Il bucket S3 deve trovarsi nella stessa regione AWS del progetto build. Specificare il file buildspec utilizzando il relativo ARN (ad esempio, `arn:aws:s3:::<my-codebuild-sample2>/buildspec.yml`). Se tale valore non è fornito o è impostato su una stringa vuota, il codice di origine deve contenere un file `buildspec.yml` nella directory radice. Per ulteriori informazioni, consulta [Nome del file buildspec e posizione di storage](build-spec-ref.md#build-spec-ref-name-storage).
   + I seguenti segnaposto sono per `cacheOverride`.
     + *cacheOverride-location*: facoltativo. Il percorso di un oggetto `ProjectCache` per questa compilazione che sostituisce l'oggetto `ProjectCache` specificato nel progetto di compilazione. `cacheOverride` è facoltativo e richiede un oggetto `ProjectCache`. `location` è obbligatorio in un oggetto `ProjectCache`.
     + *cacheOverride-type*: facoltativo. Il tipo di un oggetto `ProjectCache` per questa compilazione che sostituisce l'oggetto `ProjectCache` specificato nel progetto di compilazione. `cacheOverride` è facoltativo e richiede un oggetto `ProjectCache`. `type` è obbligatorio in un oggetto `ProjectCache`.
   + *certificateOverride*: facoltativo. Il nome di un certificato per questa compilazione che sostituisce quella definita nel progetto di compilazione.
   + *environmentTypeOverride*: facoltativo. Un tipo di container per questa compilazione che sostituisce quella definita nel progetto di compilazione. L'attuale stringa valida è `LINUX_CONTAINER`.
   + I seguenti segnaposto sono per `environmentVariablesOverride`.
     + *environmentVariablesOverride-name*: facoltativo. Il nome di una variabile di ambiente nel progetto di compilazione il quale valore si desidera ignorare per questa compilazione.
     + *environmentVariablesOverride-type*: facoltativo. Il tipo di variabile di ambiente nel progetto di compilazione il quale valore si desidera ignorare per questa compilazione.
     + *environmentVariablesValue*: facoltativo. Il valore della variabile di ambiente definita nel progetto di compilazione il quale valore si desidera ignorare per questa compilazione.
   + *gitCloneDepthOverride*: facoltativo. Il valore di **Git clone depth** nel progetto di compilazione il quale valore si desidera ignorare per questa compilazione. Se il tipo di origine è Amazon S3, questo valore non è supportato.
   + *imageOverride*: facoltativo. Il nome di un immagine per questa compilazione che sostituisce quella definita nel progetto di compilazione.
   + *idempotencyToken*: facoltativo. Una stringa che serve come token per specificare che la richiesta di compilazione è idempotente. È possibile scegliere qualsiasi stringa con 64 caratteri o meno. Il token è valido per 5 minuti dopo la richiesta di start-build. Se ripeti la richiesta di start-build con lo stesso token, ma modifichi un parametro, CodeBuild restituisce un errore di mancata corrispondenza del parametro. 
   + *insecureSslOverride*: valore booleano facoltativo che specifica se sovrascrivere l'impostazione TLS non sicura specificata nel progetto di compilazione. L'impostazione TLS non sicura determina se ignorare gli avvisi TLS durante la connessione al codice sorgente del progetto. Questo override si applica solo se l'origine della build è Enterprise Server. GitHub 
   + *privilegedModeOverride*: valore booleano facoltativo. Se impostato su true, la compilazione sostituisce la modalità privilegiata nel progetto di compilazione.
   +  *queuedTimeoutInMinutesOverride*: numero intero opzionale che specifica il numero di minuti in cui una build può essere messa in coda prima del timeout. Il valore minimo è cinque minuti e il valore massimo è 480 minuti (8 ore). 
   + *reportBuildStatusOverride*: Valore booleano facoltativo che specifica se inviare al provider di origine lo stato di inizio e completamento di una build. Se lo imposti con un provider di origine diverso GitHub da GitHub Enterprise Server o Bitbucket, viene generato un. invalidInputException 
   + *sourceAuthOverride*: stringa opzionale. Un tipo di autorizzazione per questa compilazione che sostituisce quella definita nel progetto di compilazione. Questo override si applica solo se l'origine del progetto di compilazione è Bitbucket o. GitHub
   + *sourceLocationOverride*: stringa opzionale. Il percorso che, per questa compilazione, sostituisce il percorso di origine definito nel progetto di compilazione.
   + *serviceRoleOverride*: stringa opzionale. Il nome di un ruolo del servizio per questa compilazione che sostituisce quella definita nel progetto di compilazione.
   + *sourceTypeOverride*: stringa opzionale. Un tipo di input di origine per questa compilazione che sostituisce l'input di origine definito nel progetto di compilazione. Le stringhe valide sono `NO_SOURCE`, `CODECOMMIT`, `CODEPIPELINE`, `GITHUB`, `S3`, `BITBUCKET` e `GITHUB_ENTERPRISE`.
   + *timeoutInMinutesOverride*: numero opzionale. Il numero di minuti di timeout di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione. 

   Ti consigliamo di memorizzare una variabile di ambiente con un valore sensibile, come un ID di chiave di AWS accesso, una chiave di accesso AWS segreta o una password come parametro in Amazon EC2 Systems Manager Parameter Store. CodeBuild può utilizzare un parametro memorizzato in Amazon EC2 Systems Manager Parameter Store solo se il nome di quel parametro inizia con `/CodeBuild/` (ad esempio,`/CodeBuild/dockerLoginPassword`). Puoi utilizzare la CodeBuild console per creare un parametro in Amazon EC2 Systems Manager. Selezionare **Create a parameter (Crea un parametro)** e seguire le istruzioni. (In quella finestra di dialogo, per la **chiave KMS**, puoi facoltativamente specificare l'ARN di una AWS KMS chiave nel tuo account. Amazon EC2 Systems Manager utilizza questa chiave per crittografare il valore del parametro durante l'archiviazione e decrittografarlo durante il recupero.) Se usi la CodeBuild console per creare un parametro, la console avvia il parametro con il `/CodeBuild/` momento in cui viene memorizzato. Tuttavia, se utilizzi la console Amazon EC2 Systems Manager Parameter Store per creare un parametro, devi iniziare il nome del parametro con `/CodeBuild/` e devi impostare **Type** su **Secure String**. Per ulteriori informazioni, consulta [AWS Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) and [Walkthrough: Create and test a String parameter (console)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-console.html) nella *Amazon EC2 Systems Manager User* Guide.

   Se il progetto di compilazione si riferisce a parametri memorizzati in Amazon EC2 Systems Manager Parameter Store, il ruolo di servizio del progetto di compilazione deve consentire l'`ssm:GetParameters`azione. Se in precedenza hai scelto **Crea un nuovo ruolo di servizio nel tuo account**, CodeBuild include automaticamente questa azione nel ruolo di servizio predefinito per il tuo progetto di build. Tuttavia, se era stata scelta l'opzione **Choose an existing service role from your account (Scegli un ruolo del servizio esistente dal tuo account)**, è necessario includere questa operazione al ruolo del servizio separatamente.

   Le variabili di ambiente impostate sostituiscono quelle esistenti. Ad esempio, se l'immagine Docker contiene già una variabile di ambiente denominata `MY_VAR` con un valore di `my_value`, e si imposta una variabile di ambiente denominata `MY_VAR` con un valore di `other_value`, il valore `my_value` viene sostituito da `other_value`. Allo stesso modo, se l'immagine Docker contiene già una variabile di ambiente denominata `PATH` con un valore di `/usr/local/sbin:/usr/local/bin`, e si imposta una variabile di ambiente denominata `PATH` con un valore di `$PATH:/usr/share/ant/bin`, il valore di `/usr/local/sbin:/usr/local/bin` viene sostituito dal valore letterale `$PATH:/usr/share/ant/bin`. 

   Non impostare variabili di ambiente con nomi che iniziano con `CODEBUILD_`. Questo prefisso è riservato per l'uso interno .

   Se una variabile di ambiente con lo stesso nome viene definita in più luoghi, il valore della variabile di ambiente viene determinato come segue:
   + Il valore della chiamata all'operazione di inizio della compilazione ha la massima priorità.
   + Il valore della definizione del progetto di compilazione è il seguente in ordine di priorità.
   + Il valore della dichiarazione buildspec ha la minima priorità.

   Per informazioni sui valori validi per questi segnaposto, consultare [Creazione di un progetto di compilazione (AWS CLI)](create-project.md#create-project-cli). Per un elenco delle impostazioni più recenti per un progetto di compilazione, consultare [Visualizza i dettagli del progetto di costruzione](view-project-details.md).

1. Passare alla directory contenente il file appena salvato ed eseguire nuovamente il comando `start-build`.

   ```
   aws codebuild start-build --cli-input-json file://start-build.json
   ```

1. In caso di esito positivo, nell'output vengono visualizzati dati simili a quelli descritti nella procedura [Per eseguire la build](getting-started-overview.md#getting-started-run-build-cli).

Per utilizzare le informazioni dettagliate su questa compilazione, annotare il valore `id` nell'output e consultare [Visualizzazione dei dettagli delle compilazioni (AWS CLI)](view-build-details.md#view-build-details-cli).