

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 predefinite
<a name="workflows-using-predefined-variables"></a>

*Le variabili predefinite* sono coppie chiave-valore emesse automaticamente da un flusso di lavoro e rese disponibili per l'uso nelle azioni del flusso di lavoro. 

Per ulteriori informazioni sulle variabili, vedere. [Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md)

**Topics**
+ [Esempi di riferimento a variabili predefinite](workflows-predefined-examples.md)
+ [Riferimento a una variabile predefinita](workflows-working-with-variables-reference-output-vars.md)
+ [Determinazione delle variabili predefinite emesse dal flusso di lavoro](workflows-working-with-variables-determine-output-vars.md)
+ [Elenco di variabili predefinite](workflow-ref-action-variables.md)

# Esempi di riferimento a variabili predefinite
<a name="workflows-predefined-examples"></a>

Gli esempi seguenti mostrano come fare riferimento a variabili predefinite nel file di definizione del flusso di lavoro.

Per ulteriori informazioni sulle variabili predefinite, vedere. [Utilizzo di variabili predefinite](workflows-using-predefined-variables.md)

**Topics**
+ [Esempio: riferimento alla variabile predefinita "CommitId"](#workflows-working-with-variables-ex-refer-action)
+ [Esempio: riferimento alla variabile predefinita BranchName ""](#workflows-working-with-variables-ex-branch)

## Esempio: riferimento alla variabile predefinita "CommitId"
<a name="workflows-working-with-variables-ex-refer-action"></a>

L'esempio seguente mostra come fare riferimento alla variabile `CommitId` predefinita nell'azione. `MyBuildAction` La `CommitId` variabile viene emessa automaticamente da CodeCatalyst. Per ulteriori informazioni, consulta [Elenco di variabili predefinite](workflow-ref-action-variables.md).

Sebbene l'esempio mostri la variabile utilizzata nell'azione di creazione, è possibile utilizzarla `CommitId` in qualsiasi azione.

```
MyBuildAction:
    Identifier: aws/build@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      Steps:
      #Build Docker image and tag it with a commit ID
        - Run: docker build -t image-repo/my-docker-image:latest .
        - Run: docker tag image-repo/my-docker-image:${WorkflowSource.CommitId}
```

## Esempio: riferimento alla variabile predefinita BranchName ""
<a name="workflows-working-with-variables-ex-branch"></a>

L'esempio seguente mostra come fare riferimento alla variabile `BranchName` predefinita nell'azione. `CDKDeploy` La `BranchName` variabile viene emessa automaticamente da CodeCatalyst. Per ulteriori informazioni, consulta [Elenco di variabili predefinite](workflow-ref-action-variables.md).

Sebbene l'esempio mostri la variabile utilizzata nell'azione di **AWS CDK distribuzione**, è possibile utilizzarla `BranchName` in qualsiasi azione.

```
CDKDeploy:
    Identifier: aws/cdk-deploy@v2
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      StackName: app-stack-${WorkflowSource.BranchName}
```

# Riferimento a una variabile predefinita
<a name="workflows-working-with-variables-reference-output-vars"></a>

Puoi fare riferimento a variabili predefinite in qualsiasi azione all'interno di un CodeCatalyst flusso di lavoro Amazon.

Utilizza le seguenti istruzioni per fare riferimento a una variabile predefinita in un flusso di lavoro.

Per ulteriori informazioni sulle variabili predefinite, vedere. [Utilizzo di variabili predefinite](workflows-using-predefined-variables.md)

**Prerequisito**  
Determina il nome della variabile predefinita a cui desideri fare riferimento, ad esempio. `CommitId` Per ulteriori informazioni, consulta [Determinazione delle variabili predefinite emesse dal flusso di lavoro](workflows-working-with-variables-determine-output-vars.md).

------
#### [ Visual ]

*Non disponibile. Scegli YAML per visualizzare le istruzioni YAML.*

------
#### [ YAML ]

**Per fare riferimento a una variabile predefinita (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' CodeCatalyst azione, aggiungete il riferimento alla variabile predefinito utilizzando la seguente sintassi:

   ```
   ${action-group-name.action-name-or-WorkflowSource.variable-name}
   ```

   Sostituire:
   + *action-group-name*con il nome del gruppo di azioni.
**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-or-WorkflowSource*con:

     Il nome dell'azione che genera la variabile.

     or

     `WorkflowSource`, se la variabile è la `CommitId` variabile `BranchName` or.
   + *variable-name*con il nome della variabile.

   Esempio:

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${MyFirstECSAction.cluster}
   ```

   Un altro esempio:

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${WorkflowSource.CommitId}
   ```

   Per ulteriori esempi, consulta [Esempi di riferimento a variabili predefinite](workflows-predefined-examples.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.**

------

# Determinazione delle variabili predefinite emesse dal flusso di lavoro
<a name="workflows-working-with-variables-determine-output-vars"></a>

Utilizzate la procedura seguente per determinare quali variabili predefinite emette un flusso di lavoro durante l'esecuzione. È quindi possibile fare riferimento a queste variabili all'interno dello stesso flusso di lavoro. 

Per ulteriori informazioni sulle variabili predefinite, vedere[Utilizzo di variabili predefinite](workflows-using-predefined-variables.md).

**Per determinare le variabili predefinite emesse dal flusso di lavoro**
+ Esegui una delle seguenti operazioni:
  + **Esegui il flusso di lavoro una volta**. Al termine dell'esecuzione, le variabili emesse dal flusso di lavoro vengono visualizzate nella scheda **Variabili** della pagina dei dettagli dell'esecuzione. Per ulteriori informazioni, consulta [Visualizzazione dello stato e dei dettagli dell'esecuzione del flusso di lavoro](workflows-view-run.md).
  + **Consulta il. [Elenco di variabili predefinite](workflow-ref-action-variables.md)** Questo riferimento elenca il nome della variabile (chiave) e il valore per ogni variabile predefinita.

**Nota**  
La dimensione totale massima delle variabili di un flusso di lavoro è elencata in[Quote per i flussi di lavoro in CodeCatalyst](workflows-quotas.md). Se la dimensione totale supera il massimo, l'azione che si verifica dopo il raggiungimento del massimo potrebbe non riuscire.

# Elenco di variabili predefinite
<a name="workflow-ref-action-variables"></a>

Consultate le seguenti sezioni per visualizzare le variabili predefinite prodotte automaticamente dalle CodeCatalyst azioni come parte dell'esecuzione di un flusso di lavoro.

Per ulteriori informazioni sulle variabili predefinite, vedere. [Utilizzo di variabili predefinite](workflows-using-predefined-variables.md)

**Nota**  
[Questo elenco include solo le variabili predefinite emesse dall' CodeCatalyst origine e dalle azioni. CodeCatalyst ](workflows-actions.md#workflows-actions-types) Se utilizzi altri tipi di azioni, come le azioni GitHub Actions o CodeCatalyst Labs, consulta invece. [Determinazione delle variabili predefinite emesse dal flusso di lavoro](workflows-working-with-variables-determine-output-vars.md)

**Elenco**

**Nota**  
Non tutte le CodeCatalyst azioni producono variabili predefinite. Se l'azione non è presente nell'elenco, non produce variabili.
+ [variabili BranchName '' e CommitId ''](workflows-sources-variables.md)
+ [Variabili 'Deploy CloudFormation stack'](deploy-action-cfn-variables.md)
+ [Variabili «Distribuisci su Amazon ECS»](deploy-action-ecs-variables.md)
+ [Variabili «Distribuisci su cluster Kubernetes»](deploy-action-eks-variables.md)
+ [variabili 'AWS CDK deploy'](cdk-dep-action-variables.md)
+ [variabili 'AWS CDK bootstrap'](cdk-boot-action-variables.md)
+ [variabili 'AWS Lambda invoke'](lam-invoke-action-variables.md)
+ [Variabili «Render Amazon ECS task definition»](render-ecs-action-variables.md)