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à.
# Si integra AWS CodeBuild
-a
```
Per eseguire una build ARM, esegui il seguente comando:
```
$ ./codebuild_build.sh -i -a -l public.ecr.aws/codebuild/local-builds:aarch64
```
Sostituisci ** 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 `opzione al comando script.
## Ricevi notifiche per le nuove versioni degli CodeBuild agenti
```
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 ** 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:::/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).
# Esegui una build in batch (AWS CLI)
```
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-batch --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-batch** comando con l'`--project-name`opzione, sostituitelo ** 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-batch** comando con l'`--idempotency-token`opzione, nella richiesta viene incluso un identificatore o token univoco con distinzione tra maiuscole e minuscole. `start-build-batch` Il token è valido per 5 minuti dopo la richiesta . Se si ripete la `start-build-batch` 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 **start-build-batch** comando con l'`--generate-cli-skeleton`opzione, i dati in formato JSON vengono emessi nel file. ** Questo file è simile allo skelton prodotto dal **start-build** comando, con l'aggiunta del seguente oggetto. Per ulteriori informazioni sugli oggetti comuni, vedere. [Esecuzione di una compilazione (AWS CLI)](run-build-cli.md)
Modifica questo file per aggiungere eventuali sostituzioni di build e salva i risultati.
```
"buildBatchConfigOverride": {
"combineArtifacts": combineArtifacts,
"restrictions": {
"computeTypesAllowed": [
allowedComputeTypes
],
"maximumBuildsAllowed": maximumBuildsAllowed
},
"serviceRole": "batchServiceRole",
"timeoutInMins": batchTimeout
}
```
L'`buildBatchConfigOverride`oggetto è una [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html)struttura che contiene le modifiche di configurazione della build in batch per questa build.
*combineArtifacts*
Un valore booleano che specifica se gli elementi di compilazione per la compilazione in batch devono essere combinati in un'unica posizione degli artefatti.
*allowedComputeTypes*
Array di stringhe che specificano i tipi di calcolo consentiti per la compilazione batch. Vedi Tipi di calcolo dell'ambiente di [compilazione per questi valori](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html).
*maximumBuildsAllowed*
Specifica il numero massimo di compilazioni consentite.
*batchServiceRole*
Specifica l'ARN del ruolo di servizio per il progetto di compilazione batch.
*batchTimeout*
Specifica la quantità massima di tempo, espressa in minuti, in cui deve essere completata la compilazione batch.
1. Passare alla directory contenente il file appena salvato ed eseguire nuovamente il comando `start-build-batch`.
```
aws codebuild start-build-batch --cli-input-json file://start-build.json
```
1. In caso di successo, la rappresentazione JSON di un [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html)oggetto viene visualizzata nell'output della console. Vedi la [sintassi di StartBuildBatch risposta](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax) per un esempio di questi dati.
# Avvio di esecuzioni di compilazione automaticamente (AWS CLI)
```
**è il nome del progetto di compilazione che contiene il codice sorgente da ricostruire.
Infatti GitHub, nell'output vengono visualizzate informazioni simili alle seguenti:
```
{
"webhook": {
"url": ""
}
}
```
**è l'URL del GitHub webhook.
Per GitHub Enterprise Server, nell'output vengono visualizzate informazioni simili alle seguenti:
![\[Informazioni di output di esempio.\]](http://docs.aws.amazon.com/it_it/codebuild/latest/userguide/images/create-webhook-ghe.png)
1. Copiare l'URL della chiave segreta e di payload dall'output. Sono necessari per aggiungere un webhook in GitHub Enterprise Server.
1. In GitHub Enterprise Server, scegliete il repository in cui è archiviato il CodeBuild progetto. Selezionare **Settings (Impostazioni)**, quindi **Hooks & services (Hook e servizi)** e selezionare **Add webhook (Aggiungi webhook)**.
1. Inserire l'URL di payload e della chiave segreta, accettare le impostazioni predefinite per gli altri campi e selezionare **Add webhook (Aggiungi webhook)**.
# Interruzione di esecuzioni di compilazioni automaticamente (AWS CLI)
```
+ dove ** è il nome del progetto di compilazione che contiene il codice sorgente da ricostruire.
Se questo comando viene completato, nessuna informazione e nessun errore appaiono nell'output.
**Nota**
Questo elimina il webhook solo dal tuo CodeBuild progetto. È inoltre necessario eliminare il webhook dal proprio repository GitHub o da quello di GitHub Enterprise Server.
# Esecuzione di una compilazione (AWS SDKs)
```
1. Carica la cartella AWS SAM del progetto in un archivio di sorgenti supportato. Per un elenco dei tipi di sorgenti supportati, consulta [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html).
## Creare un progetto CodeBuild Lambda Java
` per creare una semplice app React.
1. Carica la cartella del progetto dell'app React in un repository di sorgenti supportato. Per un elenco dei tipi di sorgenti supportati, vedi [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html).
## Creare un progetto CodeBuild Lambda Node.js
"
LAMBDA_ENV_VARIABLE: "FEATURE_ENABLED"
LAMBDA_ENV_VARIABLE_VALUE: "true"
phases:
install:
commands:
- pip3 install boto3
build:
commands:
- python3 update_lambda_environment_variables.py
```
1. Selezionare **Update buildspec (Aggiorna buildspec)**.
## Aggiorna la tua configurazione Lambda
[ ...]
```
+ ````, ecc.: Uno o più pattern globulari da confrontare con i file nella directory di lavoro.
+ `*`: Corrisponde a qualsiasi sequenza di caratteri (esclusi i separatori di percorso).
+ `**`: corrisponde a qualsiasi sequenza di caratteri (inclusi i separatori di percorso).
**Nota**
Assicurati che la stringa glob contenga virgolette. Per verificare i risultati del pattern-matching, usa il comando. `echo`
```
version: 0.2
phases:
build:
commands:
- echo $(codebuild-glob-search '**/__tests__/*.js')
- codebuild-glob-search '**/__tests__/*.js' | xargs -n 1 echo
```
## Output
`, dove `shard_number` rappresenta il numero dello shard in cui viene creato il gruppo di report. Questa organizzazione consente di tracciare e analizzare le tendenze sia a livello di compilazione consolidato che individuale, offrendo flessibilità nel modo in cui monitorate e valutate i relativi processi di compilazione.
Il rapporto di creazione in batch segue la stessa struttura dei report di compilazione [individuali](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_Report.html). I seguenti campi chiave nella scheda **Report sono specifici per i report** creati in batch:
**Stato del report relativo alla creazione in Batch**
Lo stato dei report di creazione in batch segue regole specifiche a seconda del tipo di report:
+ Rapporti di test:
+ Riuscito: lo stato viene impostato su Riuscito quando tutti i singoli report di compilazione hanno avuto esito positivo.
+ Non riuscito: lo stato è impostato su Non riuscito se un singolo report di compilazione non è riuscito.
+ Incompleto: lo stato viene contrassegnato come incompleto se un singolo rapporto di compilazione è mancante o presenta uno stato incompleto.
+ Rapporti sulla copertura del codice:
+ Completo: lo stato viene impostato per essere completato quando tutti i report di compilazione individuali sono completi.
+ Non riuscito: lo stato è impostato su Non riuscito se un singolo report di compilazione non è riuscito.
+ Incompleto: lo stato viene contrassegnato come incompleto se un singolo rapporto di compilazione è mancante o presenta uno stato incompleto.
**Riepilogo del test**
Il rapporto di test unito consolida i seguenti campi di tutti i singoli report di build:
+ duration-in-nano-seconds: Durata massima del test in nanosecondi tra tutti i singoli report di build.
+ totale: il conteggio combinato di tutti i casi di test, sommando il numero totale di test di ciascuna build.
+ conteggi degli stati: fornisce una visualizzazione consolidata degli stati dei test, ad esempio superati, non riusciti o ignorati, calcolati aggregando il conteggio di ogni tipo di stato in tutte le singole build.
**Riepilogo della copertura del codice**
Il rapporto sulla copertura del codice unito combina i campi di tutte le singole build utilizzando i seguenti calcoli:
+ filiali coperte: somma di tutte le filiali coperte dai singoli report.
+ succursali perse: somma di tutte le filiali mancanti riportate nelle segnalazioni individuali.
+ branch-coverage-percentage: `(Total covered branches / Total branches) * 100`
+ righe coperte: somma di tutte le righe coperte dai singoli report.
+ righe mancanti: somma di tutte le righe mancanti dei singoli report.
+ lines-coverage-percentage: `(Total covered lines / Total lines) * 100`
**ID di esecuzione**
L'ARN di compilazione in batch.
**Casi di test**
Il report unito contiene un elenco consolidato di tutti i casi di test relativi alle singole build, accessibile sia tramite l'[DescribeTestCases](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DescribeTestCases.html)API che tramite il rapporto sulla build in batch nella console.
**Coperture del codice**
Il rapporto sulla copertura del codice unito fornisce informazioni consolidate sulla copertura di linee e filiali per ogni file in tutte le singole build, accessibili sia tramite l'[DescribeCodeCoverages](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DescribeCodeCoverages.html)API che tramite il rapporto di creazione in batch nella console. Nota: per i file coperti da più file di test distribuiti su diversi shard, il report unito utilizza i seguenti criteri di selezione:
1. La selezione primaria si basa sulla copertura di linea più alta tra gli shard.
1. Se la copertura di linea è uguale su più frammenti, viene selezionato lo shard con la copertura di diramazione più elevata.
# Esempio di esecuzione parallela di test per vari framework di test
...
```
Ecco alcuni esempi che utilizzano: `codebuild-hash-files`
```
codebuild-hash-files package-lock.json
codebuild-hash-files '**/*.md'
```
## Versione cache
Artifacts:
Type: S3
Location:
Name: myArtifact
EncryptionDisabled: true
OverrideArtifactName: true
Environment:
Type: LINUX_CONTAINER
ComputeType: BUILD_GENERAL1_SMALL
Image: aws/codebuild/standard:5.0
Certificate:
# PrivilegedMode must be true if you specify LOCAL_DOCKER_LAYER_CACHE
PrivilegedMode: true
Source:
Type: GITHUB
Location:
InsecureSsl: true
GitCloneDepth: 1
ReportBuildStatus: false
TimeoutInMinutes: 10
Cache:
Type: LOCAL
Modes: # You can specify one or more cache mode,
- LOCAL_CUSTOM_CACHE
- LOCAL_DOCKER_LAYER_CACHE
- LOCAL_SOURCE_CACHE
```
**Nota**
Per impostazione predefinita, il daemon Docker è abilitato per le build non VPC. Se desideri utilizzare i contenitori Docker per le build VPC, [consulta Runtime Privilege e Linux Capabilities sul sito Web di Docker Docs e](https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities) abilita la modalità privilegiata. Inoltre, Windows non supporta la modalità privilegiata.
Per ulteriori informazioni, consulta [Creazione di un progetto di compilazione (CloudFormation)](create-project.md#create-project-cloud-formation).
# Il debug si integra AWS CodeBuild
:`
Ad esempio, `project-name:d25be134-05cb-404a-85da-ac5f85d2d72c`.
+ ARN della sandbox: arn:aws:codebuild: ::sandbox/**: ** ** **
Ad esempio, `arn:aws:codebuild:us-west-2:962803963624:sandbox/project-name:d25be134-05cb-404a-85da-ac5f85d2d72c`.
------
#### [ Sample response ]
```
{
"sandboxes": [{
"id": "project-name",
"arn": "arn:aws:codebuild:us-west-2:962803963624:sandbox/project-name",
"projectName": "project-name",
"requestTime": "2025-02-06T11:24:15.560000-08:00",
"endTime": "2025-02-06T11:39:21.587000-08:00",
"status": "STOPPED",
"source": {
"type": "S3",
"location": "arn:aws:s3:::cofa-e2e-test-1-us-west-2-beta-default-build-sources/eb-sample-jetty-v4.zip",
"insecureSsl": false
},
"environment": {
"type": "LINUX_CONTAINER",
"image": "aws/codebuild/standard:6.0",
"computeType": "BUILD_GENERAL1_SMALL",
"environmentVariables": [{
"name": "foo",
"value": "bar",
"type": "PLAINTEXT"
},
{
"name": "bar",
"value": "baz",
"type": "PLAINTEXT"
}
],
"privilegedMode": false,
"imagePullCredentialsType": "CODEBUILD"
},
"timeoutInMinutes": 10,
"queuedTimeoutInMinutes": 480,
"logConfig": {
"cloudWatchLogs": {
"status": "ENABLED",
"groupName": "group",
"streamName": "stream"
},
"s3Logs": {
"status": "ENABLED",
"location": "codefactory-test-pool-1-us-west-2-beta-default-build-logs",
"encryptionDisabled": false
}
},
"encryptionKey": "arn:aws:kms:us-west-2:962803963624:alias/SampleEncryptionKey",
"serviceRole": "arn:aws:iam::962803963624:role/BuildExecutionServiceRole",
"currentSession": {
"id": "0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"currentPhase": "COMPLETED",
"status": "STOPPED",
"startTime": "2025-02-06T11:24:15.626000-08:00",
"endTime": "2025-02-06T11:39:21.600000-08:00",
"phases": [{
"phaseType": "SUBMITTED",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:15.577000-08:00",
"endTime": "2025-02-06T11:24:15.606000-08:00",
"durationInSeconds": 0
},
{
"phaseType": "QUEUED",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:15.606000-08:00",
"endTime": "2025-02-06T11:24:16.067000-08:00",
"durationInSeconds": 0
},
{
"phaseType": "PROVISIONING",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:16.067000-08:00",
"endTime": "2025-02-06T11:24:20.519000-08:00",
"durationInSeconds": 4,
"contexts": [{
"statusCode": "",
"message": ""
}]
},
{
"phaseType": "DOWNLOAD_SOURCE",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:20.519000-08:00",
"endTime": "2025-02-06T11:24:22.238000-08:00",
"durationInSeconds": 1,
"contexts": [{
"statusCode": "",
"message": ""
}]
},
{
"phaseType": "RUNNING_SANDBOX",
"phaseStatus": "TIMED_OUT",
"startTime": "2025-02-06T11:24:22.238000-08:00",
"endTime": "2025-02-06T11:39:21.560000-08:00",
"durationInSeconds": 899,
"contexts": [{
"statusCode": "BUILD_TIMED_OUT",
"message": "Build has timed out. "
}]
},
{
"phaseType": "COMPLETED",
"startTime": "2025-02-06T11:39:21.560000-08:00"
}
],
"logs": {
"groupName": "group",
"streamName": "stream/0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logsV2:log-groups/log-group/group/log-events/stream$252F0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"s3DeepLink": "https://s3.console.aws.amazon.com/s3/object/codefactory-test-pool-1-us-west-2-beta-default-build-logs/0103e0e7-52aa-4a3d-81dd-bfc27226fa54.gz?region=us-west-2",
"cloudWatchLogsArn": "arn:aws:logs:us-west-2:962803963624:log-group:group:log-stream:stream/0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"s3LogsArn": "arn:aws:s3:::codefactory-test-pool-1-us-west-2-beta-default-build-logs/0103e0e7-52aa-4a3d-81dd-bfc27226fa54.gz",
"cloudWatchLogs": {
"status": "ENABLED",
"groupName": "group",
"streamName": "stream"
},
"s3Logs": {
"status": "ENABLED",
"location": "codefactory-test-pool-1-us-west-2-beta-default-build-logs",
"encryptionDisabled": false
}
}
}
}],
"sandboxesNotFound": []
}
```
------
### Ferma una sandbox (AWS CLI)
:sandbox/
```
**Nota**
Per risolvere gli errori di connessione, usa il `-v` flag per abilitare l'output dettagliato. Ad esempio, `ssh -v codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1::sandbox/`.
Per ulteriori indicazioni sulla risoluzione dei problemi, vedere. [Risoluzione dei problemi AWS CodeBuild di connessione SSH nella sandbox](sandbox-troubleshooting.md)
## Fase 4: Rivedi i risultati
`, è possibile che si verifichi un `InvalidInputException` errore del tipo:
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for {sandbox-arn}
User: arn:aws:sts:::assumed-role//AWSCodeBuild-
is not authorized to perform: ssm:StartSession on resource.
```
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for
sandbox : codebuild: is not connected.
```
**Causa possibile:**
+ Agente Amazon EC2 Systems Manager mancante: nell'immagine di build non è installato o configurato correttamente l'agente SSM.
+ Autorizzazioni insufficienti: il ruolo del servizio di CodeBuild progetto non dispone delle autorizzazioni SSM richieste.
**Soluzione consigliata:** se utilizzi un'immagine personalizzata per la build, procedi come segue.
1. Installazione di SSM Agent Per ulteriori informazioni, consulta [Installazione e disinstallazione manuale dell'agente SSM su istanze Amazon EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) per Linux nel. ** La versione di SSM Agent deve essere o successiva. `3.0.1295.0`
1. Copia il file, [ https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.json](https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.json) nella directory dell'immagine. `/etc/amazon/ssm/` **Ciò abilita la modalità contenitore nell'agente SSM.**
1. Assicurati che il ruolo di servizio del tuo CodeBuild progetto disponga delle seguenti autorizzazioni, quindi riavvia l'ambiente sandbox:
```
{
"Effect": "Allow",
"Action": [
"ssmmessages:CreateControlChannel",
"ssmmessages:CreateDataChannel",
"ssmmessages:OpenControlChannel",
"ssmmessages:OpenDataChannel"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ssm:StartSession"
],
"Resource": [
"arn:aws:codebuild:region:account-id:build/*",
"arn:aws:ssm:region::document/AWS-StartSSHSession"
]
}
```
## Errore: «Impossibile individuare le credenziali» quando SSH entra nell'ambiente sandbox CodeBuild
`, è possibile che si verifichi il seguente errore di credenziali:
```
Unable to locate credentials. You can configure credentials by running
"aws configure".
```
**Possibile causa:** AWS le credenziali non sono state configurate correttamente nell'ambiente locale.
**Soluzione consigliata:** configura AWS CLI le credenziali seguendo la documentazione ufficiale: [Configurazione delle impostazioni per la Guida utente dell'](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)*interfaccia AWS CLI a riga di AWS comando per* la versione 2.
## `StartSandboxConnection``AccessDeniedException`errore quando SSH entra nell'ambiente sandbox CodeBuild
`, è possibile che si verifichi il seguente errore di autorizzazione:
```
An error occurred (AccessDeniedException) when calling the StartSandboxConnection
operation:
User: arn:aws:sts::account-id:assumed-role/role-name
is not authorized to perform: codebuild:StartSandboxConnection on resource:
sandbox-arn
because no identity-based policy allows the codebuild:StartSandboxConnection action
```
**Possibile causa:** AWS le tue credenziali non dispongono delle CodeBuild autorizzazioni necessarie per eseguire questa operazione.
**Soluzione consigliata:** assicurati che l'utente o il ruolo IAM associato alle tue AWS CLI credenziali disponga delle seguenti autorizzazioni:
```
{
"Effect": "Allow",
"Action": [
"codebuild:StartSandboxConnection"
],
"Resource": [
"arn:aws:codebuild:region:account-id:sandbox/*"
]
}
```
## Errore: «ssh: impossibile risolvere il nome host» quando SSH entra nell'ambiente sandbox CodeBuild
`, si verifica il seguente errore di risoluzione del nome host:
```
ssh: Could not resolve hostname
```
**Possibile causa:** questo errore si verifica in genere quando lo script di connessione alla CodeBuild sandbox richiesto non è stato eseguito correttamente nell'ambiente locale.
**Soluzione consigliata:**
1. Scarica lo script di connessione alla CodeBuild sandbox.
1. Esegui lo script nel tuo terminale per stabilire la configurazione SSH necessaria.
1. Riprova la connessione SSH all'ambiente sandbox.
# Compilazioni di debug con Session Manager
",
"arn:aws:s3:::/*"
]
}
]
}
```
*Per ulteriori informazioni, consulta [Controllo e registrazione dell'attività della sessione nella Guida](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-logging-auditing.html) per l'utente.AWS Systems Manager *
## Metti in pausa la compilazione
--region --output json
```
1. Copia il valore della `sessionTarget` proprietà. Il nome della `sessionTarget` proprietà può variare a seconda del tipo di output del `aws` comando. Questo è il motivo `--output json` per cui viene aggiunto al comando nel passaggio precedente.
1. Usa il seguente comando per connetterti al contenitore di compilazione.
```
aws ssm start-session --target --region
```
Per questo esempio, verificate che il `/tmp/hello-world` file esista e contenga il testo`Hello World`.
## Riprendi la compilazione
--idempotency-token
```
Nel comando precedente, sostituire il seguente segnaposto:
+ **: stringa richiesta. L'ID della build o della build batch da riprovare. Per ottenere un elenco delle build IDs, consulta i seguenti argomenti:
+ [Visualizza un elenco di build () IDs AWS CLI](view-build-list.md#view-build-list-cli)
+ [Visualizza un elenco di build in batch IDs (AWS CLI)](view-build-list.md#view-batch-build-list-cli)
+ [Visualizza un elenco di build IDs per un progetto di compilazione (AWS CLI)](view-builds-for-project.md#view-builds-for-project-cli)
+ [Visualizza un elenco di build in batch IDs per un progetto di compilazione (AWS CLI)](view-builds-for-project.md#view-batch-builds-for-project-cli)
+ `--idempotency-token`: facoltativo. Se esegui il **retry-build** comando con l'opzione, nella richiesta viene incluso un identificatore o token univoco con distinzione tra maiuscole e minuscole. `retry-build` Il token è valido per 5 minuti dopo la richiesta . Se si ripete la `retry-build` richiesta con lo stesso token, ma si modifica un parametro, viene CodeBuild restituito un errore di mancata corrispondenza del parametro.
## Riprova una build manualmente ()AWS SDKs
" \
--auto-retry-limit \
--source "" \
--artifacts {} \
--environment "{\"type\": \"environment-type>\",\"image\": \"image-type>\",\"computeType\": \"compute-type>\"}" \
--service-role "service-role>"
```
Nel comando precedente, sostituire i seguenti segnaposto:
+ **: imposta il limite di tentativi automatici sul numero massimo di tentativi automatici desiderato dopo una compilazione non riuscita.
+ **,,**,**, *environment-type>* *image-type>**compute-type>*, e*service-role>*: Imposta le impostazioni di configurazione del progetto desiderate.
## Riprova automaticamente una build ()AWS SDKs
```
Nel comando precedente, sostituire il seguente segnaposto:
+ **: stringa richiesta. L'identificatore della build batch da interrompere. Per ottenere un elenco degli identificatori di build in batch, consultate i seguenti argomenti:
+ [Visualizza un elenco di build in batch IDs (AWS CLI)](view-build-list.md#view-batch-build-list-cli)
+ [Visualizza un elenco di build in batch IDs per un progetto di compilazione (AWS CLI)](view-builds-for-project.md#view-batch-builds-for-project-cli)
## Interrompi una compilazione in batch ()AWS SDKs