Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md). 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à. # Utilizzo di variabili definite dall'utente *Le variabili definite dall'utente* sono coppie chiave-valore definite dall'utente. Esistono due tipi di elenchi: + Variabili **in testo semplice o semplicemente **variabili****: si tratta di coppie chiave-valore che vengono definite in testo semplice all'interno del file di definizione del flusso di lavoro. + **Segreti**: si tratta di coppie chiave-valore che definisci in una pagina **Secrets** separata della console Amazon CodeCatalyst . La *chiave* (nome) è un'etichetta pubblica e il *valore* contiene le informazioni che desideri mantenere private. La chiave viene specificata solo nel file di definizione del flusso di lavoro. Utilizzate i segreti al posto delle password e di altre informazioni sensibili nel file di definizione del flusso di lavoro. **Nota** *Per brevità, questa guida utilizza il termine *variabile per indicare una variabile in testo* non crittografato.* Per ulteriori informazioni sulle variabili, vedere. [Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md) **Topics** + [Esempi di variabili](workflows-working-with-variables-ex.md) + [Definizione di una variabile](workflows-working-with-variables-define-input.md) + [Definire un segreto](workflows-working-with-variables-define-secret.md) + [Esportazione di una variabile in modo che altre azioni possano utilizzarla](workflows-working-with-variables-export-input.md) + [Fare riferimento a una variabile nell'azione che la definisce](workflows-working-with-variables-reference-input.md) + [Fare riferimento a un output variabile mediante un'altra azione](workflows-working-with-variables-reference-action.md) + [Fare riferimento a un segreto](workflows-working-with-variables-reference-secret.md) # Esempi di variabili Gli esempi seguenti mostrano come definire e fare riferimento alle variabili nel file di definizione del flusso di lavoro. Per ulteriori informazioni sulle variabili, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md). **Topics** + [Esempio: definizione di una variabile utilizzando la proprietà Inputs](#workflows-working-with-variables-ex-define-inputs) + [Esempio: definizione di una variabile utilizzando la proprietà Steps](#workflows-working-with-variables-ex-define-steps) + [Esempio: esportazione di una variabile utilizzando la proprietà Outputs](#workflows-working-with-variables-ex-export-outputs) + [Esempio: riferimento a una variabile definita nella stessa azione](#workflows-working-with-variables-ex-refer-current) + [Esempio: riferimento a una variabile definita in un'altra azione](#workflows-working-with-variables-ex-refer-other) + [Esempio: fare riferimento a un segreto](#workflows-working-with-variables-ex-refer-secret) ## Esempio: definizione di una variabile utilizzando la proprietà Inputs L'esempio seguente mostra come definire due variabili `VAR1` e`VAR2`, in una `Inputs` sezione. ``` Actions: Build: Identifier: aws/build@v1 Inputs: Variables: - Name: VAR1 Value: "My variable 1" - Name: VAR2 Value: "My variable 2" ``` ## Esempio: definizione di una variabile utilizzando la proprietà Steps L'esempio seguente mostra come definire una `DATE` variabile nella `Steps` sezione in modo esplicito. ``` Actions: Build: Identifier: aws/build@v1 Configuration: Steps: - Run: DATE=$(date +%m-%d-%y) ``` ## Esempio: esportazione di una variabile utilizzando la proprietà Outputs L'esempio seguente mostra come definire due variabili `REPOSITORY-URI` e `TIMESTAMP` come esportarle utilizzando la `Outputs` sezione. ``` Actions: Build: Identifier: aws/build@v1 Inputs: Variables: - Name: REPOSITORY-URI Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo Configuration: Steps: - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) Outputs: Variables: - REPOSITORY-URI - TIMESTAMP ``` ## Esempio: riferimento a una variabile definita nella stessa azione L'esempio seguente mostra come specificare una `VAR1` variabile in`MyBuildAction`, e quindi farvi riferimento nella stessa azione utilizzando`$VAR1`. ``` Actions: MyBuildAction: Identifier: aws/build@v1 Inputs: Variables: - Name: VAR1 Value: my-value Configuration: Steps: - Run: $VAR1 ``` ## Esempio: riferimento a una variabile definita in un'altra azione L'esempio seguente mostra come specificare una `TIMESTAMP` variabile in`BuildActionA`, esportarla utilizzando la `Outputs` proprietà e quindi farvi riferimento in `BuildActionB` using`${BuildActionA.TIMESTAMP}`. ``` Actions: BuildActionA: Identifier: aws/build@v1 Configuration: Steps: - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) Outputs: Variables: - TIMESTAMP BuildActionB: Identifier: aws/build@v1 Configuration: Steps: - Run: docker build -t my-ecr-repo/image-repo:latest . - Run: docker tag my-ecr-repo/image-repo:${BuildActionA.TIMESTAMP} # Specifying just '$TIMESTAMP' here will not work # because TIMESTAMP is not a variable # in the BuildActionB action. ``` ## Esempio: fare riferimento a un segreto L'esempio seguente mostra come fare riferimento a un `my-password` segreto. `my-password`Questa è la chiave del segreto. La chiave di questo segreto e il valore della password corrispondente devono essere specificati nella pagina **Segreti** della CodeCatalyst console prima di essere utilizzati nel file di definizione del flusso di lavoro. Per ulteriori informazioni, consulta [Mascherare i dati utilizzando segreti](workflows-secrets.md). ``` Actions: BuildActionA: Identifier: aws/build@v1 Configuration: Steps: - Run: curl -u LiJuan:${Secrets.my-password} https://example.com ``` # Definizione di una variabile È possibile definire le variabili in due modi: + Nella `Inputs` sezione di un'azione del flusso di lavoro, consulta [Per definire una variabile nella sezione «Ingressi»](#workflows-to-define-variable-input) + Nella `Steps` sezione di un'azione del flusso di lavoro, consulta [Per definire una variabile nella sezione «Passaggi»](#workflows-to-define-variable-steps) **Nota** Il `Steps` metodo funziona solo con le azioni CodeCatalyst build, test e **GitHub Actions**, poiché queste sono le uniche azioni che includono una `Steps` sezione. Per alcuni esempi, consulta [Esempi di variabili](workflows-working-with-variables-ex.md). Per ulteriori informazioni sulle variabili, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md). ------ #### [ Visual ] **Per definire una variabile nella sezione 'Input' (editor visuale)** 1. Apri la CodeCatalyst console all'indirizzo [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **Visual**. 1. Nel diagramma del flusso di lavoro, scegli l'azione in cui desideri impostare la variabile. 1. Scegliete **Ingressi**. 1. In **Variabili, facoltativo**, **scegliete Aggiungi variabile**, quindi effettuate le seguenti operazioni: Specificate una sequenza di name/value coppie che definisca le variabili di input che desiderate rendere disponibili per l'azione. I nomi delle variabili sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9), trattini (-) e caratteri di sottolineatura (\$1). Gli spazi non sono consentiti. Non è possibile utilizzare le virgolette per abilitare caratteri e spazi speciali nei nomi delle variabili. Per ulteriori informazioni sulle variabili, inclusi esempi, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md). 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.** ------ #### [ YAML ] **Per definire una variabile nella sezione 'Input' (editor YAML)** 1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/) 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **YAML**. 1. In un'azione del flusso di lavoro, aggiungi un codice simile al seguente: ``` action-name: Inputs: Variables: - Name: variable-name Value: variable-value ``` Per ulteriori esempi, consulta [Esempi di variabili](workflows-working-with-variables-ex.md). Per ulteriori informazioni, consulta la sezione [Definizione YAML del flusso di lavoro](workflow-reference.md) dedicata alla tua azione. 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.** ------ ------ #### [ Visual ] **Per definire una variabile nella sezione «Steps» (editor visivo)** 1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **Visual**. 1. Nel diagramma del flusso di lavoro, scegli l'azione in cui desideri impostare la variabile. 1. Scegliere **Configuration (Configurazione)**. 1. Nei **comandi Shell** o nelle **GitHubazioni YAML**, a seconda di quale sia disponibile, definisci una variabile nelle azioni, in modo esplicito o `Steps` implicito. + Per definire la variabile in modo esplicito, includila in un comando bash direttamente nella sezione. `Steps` + Per definire una variabile in modo implicito, specificala in un file a cui si fa riferimento nella sezione dell'azione. `Steps` Per alcuni esempi, consulta [Esempi di variabili](workflows-working-with-variables-ex.md). Per ulteriori informazioni, consulta la sezione dedicata [Definizione YAML del flusso di lavoro](workflow-reference.md) all'azione. 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.** ------ #### [ YAML ] **Per definire una variabile nella sezione 'Steps' (editor YAML)** 1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/) 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **YAML**. 1. In un'azione del flusso di lavoro, definisci una variabile nella `Steps` sezione dell'azione, in modo esplicito o implicito. + Per definire la variabile in modo esplicito, includila in un comando bash direttamente nella sezione. `Steps` + Per definire una variabile in modo implicito, specificala in un file a cui si fa riferimento nella sezione dell'azione. `Steps` Per alcuni esempi, consulta [Esempi di variabili](workflows-working-with-variables-ex.md). Per ulteriori informazioni, consulta la sezione dedicata [Definizione YAML del flusso di lavoro](workflow-reference.md) all'azione. 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.** ------ # Definire un segreto È possibile definire un segreto nella pagina **Segreti** della CodeCatalyst console. Per ulteriori informazioni, consulta [Mascherare i dati utilizzando segreti](workflows-secrets.md). Ad esempio, potresti definire un segreto simile al seguente: + Nome (chiave): **my-password** + Valore: **^\$1H3\$1\$1b9** Dopo aver definito il segreto, è possibile specificare la chiave del segreto (**my-password**) nel file di definizione del flusso di lavoro. Per un esempio su come Eseguire questa operazione, consulta [Esempio: fare riferimento a un segreto](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret). # Esportazione di una variabile in modo che altre azioni possano utilizzarla Utilizza le seguenti istruzioni per esportare una variabile da un'azione in modo da potervi fare riferimento in altre azioni. Prima di esportare una variabile, tenete presente quanto segue: + Se devi solo fare riferimento alla variabile all'interno dell'azione in cui è definita, non devi esportarla. + Non tutte le azioni supportano l'esportazione di variabili. Per determinare se la tua azione supporta questa funzionalità, esegui le istruzioni dell'editor visivo che seguono e verifica se l'azione include un pulsante **Variabili** nella scheda **Output**. In caso affermativo, è supportata l'esportazione di variabili. + Per esportare una variabile da un' GitHub azione, vedere[Esportazione dei parametri GitHub di output](integrations-github-action-export.md). Per ulteriori informazioni sulle variabili, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md). **Prerequisito** Assicurati di aver definito la variabile che desideri esportare. Per ulteriori informazioni, consulta [Definizione di una variabile](workflows-working-with-variables-define-input.md). ------ #### [ Visual ] **Per esportare una variabile (editor visuale)** 1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **Visual**. 1. Nel diagramma del flusso di lavoro, scegli l'azione da cui desideri esportare la variabile. 1. Scegliete **Output**. 1. In **Variabili, facoltativo**, **scegliete Aggiungi variabile**, quindi effettuate le seguenti operazioni: Specificate il nome di una variabile che desiderate che l'azione esporti. Questa variabile deve essere già definita nella `Steps` sezione `Inputs` o della stessa azione. 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.** ------ #### [ YAML ] **Per esportare una variabile (editor YAML)** 1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/) 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **YAML**. 1. Nell'azione da cui desideri esportare la variabile, aggiungi un codice simile al seguente: ``` action-name: Outputs: Variables: - Name: variable-name ``` Per ulteriori esempi, consulta [Esempi di variabili](workflows-working-with-variables-ex.md). 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.** ------ # Fare riferimento a una variabile nell'azione che la definisce Utilizzate le seguenti istruzioni per fare riferimento a una variabile nell'azione che la definisce. **Nota** Per fare riferimento a una variabile generata da un' GitHub azione, vedere[Parametri di GitHub output di riferimento](integrations-github-action-referencing.md). Per ulteriori informazioni sulle variabili, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md). **Prerequisito** Assicurati di aver definito la variabile a cui vuoi fare riferimento. Per ulteriori informazioni, consulta [Definizione di una variabile](workflows-working-with-variables-define-input.md). ------ #### [ Visual ] *Non disponibile Scegli YAML per visualizzare le istruzioni YAML.* ------ #### [ YAML ] **Per fare riferimento a una variabile nell'azione che la definisce** 1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **YAML**. 1. Nell' CodeCatalyst azione che definisce la variabile a cui vuoi fare riferimento, aggiungi la variabile usando la seguente sintassi bash: ``` $variable-name ``` Esempio: ``` MyAction: Configuration: Steps: - Run: $variable-name ``` Per ulteriori esempi, consulta [Esempi di variabili](workflows-working-with-variables-ex.md). Per ulteriori informazioni, consultate le informazioni di riferimento per la vostra azione in. [Definizione YAML del flusso di lavoro](workflow-reference.md) 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.** ------ # Fare riferimento a un output variabile mediante un'altra azione Utilizzate le seguenti istruzioni per fare riferimento alle variabili generate da altre azioni. **Nota** Per fare riferimento a una variabile in uscita da un' GitHub azione, vedere[Parametri di GitHub output di riferimento](integrations-github-action-referencing.md). Per ulteriori informazioni sulle variabili, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md). **Prerequisito** Assicurati di aver esportato la variabile a cui desideri fare riferimento. Per ulteriori informazioni, consulta [Esportazione di una variabile in modo che altre azioni possano utilizzarla](workflows-working-with-variables-export-input.md). ------ #### [ Visual ] *Non disponibile. Scegli YAML per visualizzare le istruzioni YAML.* ------ #### [ YAML ] **Per fare riferimento a un output variabile mediante un'altra azione (editor YAML)** 1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/) 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **YAML**. 1. Nell' CodeCatalyst azione, aggiungi un riferimento alla variabile utilizzando la seguente sintassi: ``` ${action-group-name.action-name.variable-name} ``` Sostituire: + *action-group-name*con il nome del gruppo di azioni che contiene l'azione che genera la variabile. **Nota** È possibile omettere *action-group-name* se non esiste un gruppo di azioni o se la variabile è prodotta da un'azione nello stesso gruppo di azioni. + *action-name*con il nome dell'azione che genera la variabile. + *variable-name*con il nome della variabile. Esempio: ``` MySecondAction: Configuration: Steps: - Run: ${MyFirstAction.TIMESTAMP} ``` Per ulteriori esempi, consulta [Esempi di variabili](workflows-working-with-variables-ex.md). Per ulteriori informazioni, consulta la sezione [Definizione YAML del flusso di lavoro](workflow-reference.md) dedicata alle tue azioni. 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.** ------ # Fare riferimento a un segreto Per istruzioni su come fare riferimento a un segreto nel file di definizione del flusso di lavoro, vedere. [Usare un segreto](workflows-secrets.using.md) Per un esempio, consulta [Esempio: fare riferimento a un segreto](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret).