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à.
# Tutorial: utilizzare le variabili a livello di pipeline
In questo tutorial, creerai una pipeline in cui aggiungi una variabile a livello di pipeline ed eseguirai un'azione di CodeBuild compilazione che restituisce il valore della variabile.
**Importante**
Come parte della creazione di una pipeline, per gli artefatti verrà utilizzato un bucket di artefatti S3 fornito dal cliente. CodePipeline (Questo è diverso dal bucket utilizzato per un'azione sorgente S3.) Se il bucket di artefatti S3 si trova in un account diverso da quello della pipeline, assicurati che il bucket di artefatti S3 sia di proprietà di utenti sicuri e affidabili. Account AWS
**Topics**
+ [Prerequisiti](#tutorials-pipeline-variables-prereq)
+ [Passaggio 1: crea la tua pipeline e crea il progetto](#tutorials-pipeline-variables-pipeline)
+ [Passaggio 2: Rilascia le modifiche e visualizza i log](#tutorials-pipeline-variables-view)
## Prerequisiti
Prima di iniziare è necessario:
+ Crea un repository. CodeCommit
+ Aggiungi un file.txt al repository.
## Passaggio 1: crea la tua pipeline e crea il progetto
In questa sezione, andrai a creare una pipeline con le operazioni seguenti:
+ Una fase di origine con una connessione al tuo CodeCommit repository.
+ Una fase di compilazione con un'azione di AWS CodeBuild compilazione.
**Per creare una pipeline con la procedura guidata**
1. Accedi alla CodePipeline console all'indirizzo [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Nella pagina **Welcome (Benvenuto)**, pagina **Getting started (Nozioni di base)** o pagina **Pipelines (Pipeline)**, scegli **Create pipeline (Crea pipeline)**.
1. Nella pagina **Passaggio 1: Scegli l'opzione di creazione**, in **Opzioni di creazione**, scegli l'opzione **Crea pipeline personalizzata**. Scegli **Next (Successivo)**.
1. Nel **Passaggio 2: Scegliete le impostazioni della pipeline**, in **Nome della tubazione**, immettete. **MyVariablesPipeline**
1. **Nel **tipo di tubazione**, mantenete la selezione di default su V2.** I tipi di tubazioni differiscono per caratteristiche e prezzo. Per ulteriori informazioni, consulta [Tipi di tubazioni](pipeline-types.md).
1. In **Service Role (Ruolo del servizio)**, scegliere **New service role (Nuovo ruolo del servizio)**.
**Nota**
Se invece scegli di utilizzare il tuo ruolo di CodePipeline servizio esistente, assicurati di aver aggiunto l'autorizzazione `codeconnections:UseConnection` IAM alla tua politica del ruolo di servizio. Per istruzioni sul ruolo CodePipeline di servizio, consulta [Aggiungere autorizzazioni al ruolo CodePipeline di servizio](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).
1. In **Variabili**, scegli **Aggiungi variabile**. In **Nome**, inserisci `timeout`. In **Predefinito**, inserisci 1000. Nella descrizione, immettere la seguente descrizione:**Timeout**.
Questo creerà una variabile in cui è possibile dichiarare il valore all'avvio dell'esecuzione della pipeline. I nomi delle variabili devono corrispondere `[A-Za-z0-9@\-_]+` e possono essere qualsiasi cosa tranne una stringa vuota.
1. In **Impostazioni avanzate** non modificare le impostazioni predefinite. In **Artifact store (Archivio artefatti)**, seleziona **Default location (Posizione predefinita)** per utilizzare l'archivio artefatti predefinito, ad esempio il bucket Amazon S3 dedicato agli artefatti designato come predefinito, per la pipeline nella regione selezionata.
**Nota**
Non si tratta del bucket di origine per il codice sorgente, ma dell'archivio artefatti per la pipeline. È richiesto un archivio artefatti separato, ad esempio un bucket S3, per ogni pipeline.
Scegli **Next (Successivo)**.
1. Nella pagina **Passaggio 3: Aggiungi fase di origine**, aggiungi una fase di origine:
1. In **Source provider (Provider origine)**, scegliere **AWS CodeCommit**.
1. In **Nome del deposito e Nome del** **ramo, scegli il** tuo repository e il tuo ramo.
Scegli **Next (Successivo)**.
1. Nel **passaggio 4: Aggiungi fase di compilazione, aggiungi una fase** di compilazione:
1. In **Build provider (Provider compilazione)**, scegli **AWS CodeBuild**. Consenti a **Region (Regione)** di preimpostarsi sulla regione della pipeline.
1. Seleziona **Crea progetto**.
1. In **Project name (Nome progetto)** immettere un nome per questo progetto di compilazione.
1. In **Environment image (Immagine ambiente)**, scegli **Managed image (Immagine gestita)**. In **Operating system** (Sistema operativo), seleziona **Ubuntu**.
1. In **Runtime**, seleziona **Standard**. **Per **Image**, scegliete: 5.0aws/codebuild/standard.**
1. Per **Service Role (Ruolo del servizio)**, scegli **New service role (Nuovo ruolo del servizio)**.
**Nota**
Annota il nome del tuo ruolo di servizio. CodeBuild Avrai bisogno del nome del ruolo per l'ultimo passaggio di questo tutorial.
1. In **Buildspec**, per **Build specifications** (Specifiche di compilazione), scegli **Insert build commands (Inserisci comandi di compilazione)**. Scegli **Passa all'editor** e incolla quanto segue nei **comandi di compilazione**. In buildspec, la variabile customer `$CUSTOM_VAR1` verrà utilizzata per generare la variabile pipeline nel registro di compilazione. Creerai la variabile `$CUSTOM_VAR1` di output come variabile di ambiente nel passaggio successivo.
```
version: 0.2
#env:
#variables:
# key: "value"
# key: "value"
#parameter-store:
# key: "value"
# key: "value"
#git-credential-helper: yes
phases:
install:
#If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
#If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
runtime-versions:
nodejs: 12
#commands:
# - command
# - command
#pre_build:
#commands:
# - command
# - command
build:
commands:
- echo $CUSTOM_VAR1
#post_build:
#commands:
# - command
# - command
artifacts:
files:
- '*'
# - location
name: $(date +%Y-%m-%d)
#discard-paths: yes
#base-directory: location
#cache:
#paths:
# - paths
```
1. Scegli **Continua a CodePipeline**. Questo ritorna alla CodePipeline console e crea un CodeBuild progetto che utilizza i comandi di compilazione per la configurazione. Il progetto di compilazione utilizza un ruolo di servizio per gestire le Servizio AWS autorizzazioni. Questa operazione potrebbe richiedere un paio di minuti.
1. **In **Variabili di ambiente *- facoltativo***, per creare una variabile di ambiente come variabile di input per l'azione di compilazione che verrà risolta dalla variabile a livello di pipeline, scegli Aggiungi variabile di ambiente.** Questo creerà la variabile specificata in buildspec as. `$CUSTOM_VAR1` In **Nome**, inserisci `CUSTOM_VAR1`. In **Valore**, immetti `#{variables.timeout}`. In **Tipo, scegliete**. `Plaintext`
Il `#{variables.timeout}` valore della variabile di ambiente si basa sullo spazio dei nomi della variabile a livello di pipeline `variables` e sulla variabile a livello di pipeline creata per la pipeline nel passaggio 7. `timeout`
1. Scegli **Next (Successivo)**.
1. **Nel **passaggio 5: Aggiungi fase di test, scegli Ignora fase** di test, quindi **accetta il messaggio di avviso scegliendo nuovamente Ignora**.**
Scegli **Next (Successivo)**.
1. **Nella pagina Passaggio 6: Aggiungi fase di distribuzione, scegli Ignora fase** **di distribuzione****, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora.** Scegli **Next (Successivo)**.
1. **Nel **Passaggio 7: Revisione**, scegli Crea pipeline.**
## Passaggio 2: Rilascia le modifiche e visualizza i log
1. Dopo che la pipeline è stata eseguita correttamente, nella fase di compilazione corretta, scegli **Visualizza** dettagli.
Nella pagina dei dettagli, scegli la scheda **Registri.** Visualizza l'output della CodeBuild build. I comandi restituiscono il valore della variabile inserita.
1. **Nel navigatore a sinistra, scegli Cronologia.**
**Scegli l'esecuzione recente, quindi scegli la scheda Variabili.** Visualizzate il valore risolto per la variabile pipeline.