

Amazon non CodeCatalyst è più aperto 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à.

# Associare un ambiente a un'azione
<a name="deploy-environments-add-app-to-environment"></a>

Quando si associa un ambiente a un'azione [ del flusso di lavoro ](deploy-environments.md#deploy-environments-supported) supportata Account AWS, all'azione vengono assegnati il ruolo IAM predefinito dell'ambiente e Amazon VPC opzionale. L'azione può quindi connettersi e implementarsi Account AWS utilizzando il ruolo IAM e anche connettersi all'Amazon VPC opzionale.

Utilizza le seguenti istruzioni per associare un ambiente a un'azione.

## Fase 1: Associare l'ambiente a un'azione del flusso di lavoro
<a name="deploy-environments-add-app-to-environment-assoc"></a>

Utilizza la procedura seguente per associare un ambiente a un'azione del flusso di lavoro.

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

**Per associare un ambiente a un'azione del flusso di lavoro utilizzando l'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 repository di origine o al nome della filiale in cui è definito il flusso di lavoro oppure 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 un'azione supportata dagli ambienti. Per ulteriori informazioni, consulta [Quali azioni supportano la visualizzazione delle informazioni sulla distribuzione in? CodeCatalyst](deploy-environments.md#deploy-environments-supported-targets).

1. Scegliete la ** scheda ** Configurazione e specificate le informazioni nel ** campo ** Ambiente, come segue.

   **Ambiente**

   Specificate l' CodeCatalyst ambiente da utilizzare con l'azione. L'azione si connette Account AWS all'Amazon VPC opzionale specificato nell'ambiente scelto. L'azione utilizza il ruolo IAM predefinito specificato nell'ambiente per connettersi a e utilizza il Account AWS ruolo IAM specificato nella connessione [ Amazon VPC ](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) per connettersi ad Amazon VPC.
**Nota**  
Se il ruolo IAM predefinito non dispone delle autorizzazioni richieste dall'azione, puoi configurare l'azione per utilizzare un ruolo diverso. Per ulteriori informazioni, consulta [Modificare il ruolo IAM di un'azione](deploy-environments-switch-role.md).

   Per ulteriori informazioni sugli ambienti, consulta [Implementazione in Account AWS e VPC](deploy-environments.md) e[Creazione di un ambiente](deploy-environments-creating-environment.md).

1. (Facoltativo) Modifica il ruolo IAM associato all'azione. Potresti voler cambiare il ruolo se contiene il set errato di autorizzazioni per l'azione.

    Per modificare il ruolo:

   1. Nella sezione ** Cosa c'è in{{my-environment}}? **casella e scegli l'icona con i puntini di sospensione verticali ()![Ellipsis.](https://docs.aws.amazon.com/it_it/codecatalyst/latest/userguide/images/flows/elipsis.png).

   1. Seleziona una delle seguenti opzioni:
      +  **Cambia ruolo. ** Scegli questa opzione per modificare il ruolo IAM utilizzato da questa azione e solo questa azione. Le altre azioni continuano a utilizzare il ruolo IAM predefinito specificato nell'ambiente associato. Per ulteriori informazioni, consulta [Modificare il ruolo IAM di un'azione](deploy-environments-switch-role.md).
      +  **Modifica ambiente**. Scegli questa opzione per modificare il ruolo IAM predefinito elencato nel tuo ambiente. Quando scegli questa opzione, la tua azione, e qualsiasi altra azione associata allo stesso ambiente, inizia utilizzando il nuovo ruolo IAM predefinito.
**Importante**  
Fai attenzione quando aggiorni il ruolo IAM predefinito. La modifica del ruolo potrebbe portare al fallimento delle azioni se le autorizzazioni del ruolo non sono sufficienti per tutte le azioni che condividono l'ambiente.

1. (Facoltativo) Scegli ** Convalida per ** convalidare il codice YAML del flusso di lavoro prima del commit.

1. Scegli ** Commit**, inserisci un messaggio di commit e scegli nuovamente Commit. ** **

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

**Per associare un ambiente a un'azione del flusso di lavoro utilizzando l'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 repository di origine o al nome della filiale in cui è definito il flusso di lavoro oppure in base al nome o allo stato del flusso di lavoro.

1. Scegli **Modifica**.

1. Scegli ** YAML**.

1. Nell'azione del flusso di lavoro che desideri associare a un ambiente, aggiungi un codice simile al seguente:

   ```
   {{action-name}}:
     Environment:
       Name: {{environment-name}}
   ```

   Per ulteriori informazioni, consulta l'[Tipi di operazione](workflows-actions.md#workflows-actions-types)argomento. Questo argomento contiene collegamenti alla documentazione per ogni azione, incluso il relativo riferimento YAML.

1. (Facoltativo) Se desideri che l'azione utilizzi un ruolo diverso dal ruolo IAM predefinito elencato nell'ambiente, aggiungi una `Connections:` sezione che includa il ruolo che desideri utilizzare. Per ulteriori informazioni, consulta [Modificare il ruolo IAM di un'azione](deploy-environments-switch-role.md).

1. (Facoltativo) Scegli ** Convalida per ** convalidare il codice YAML del flusso di lavoro prima del commit.

1. Scegli ** Commit**, inserisci un messaggio di commit e scegli nuovamente Commit. ** **

------

## Passaggio 2: compilare la pagina delle attività di distribuzione
<a name="deploy-environments-add-app-to-environment-run"></a>

Dopo aver associato un ambiente a un'azione del flusso di lavoro, è possibile popolare le ** pagine dell'attività di ** distribuzione ** e della destinazione della ** distribuzione nella ** sezione ** Ambienti della console con le informazioni sulla CodeCatalyst distribuzione. Usa le seguenti istruzioni per compilare queste pagine.

**Nota**  
Solo alcune azioni supportano la visualizzazione delle informazioni sulla distribuzione nella CodeCatalyst console. Per ulteriori informazioni, consulta [Quali azioni supportano la visualizzazione delle informazioni sulla distribuzione in? CodeCatalyst](deploy-environments.md#deploy-environments-supported-targets).

**Per aggiungere informazioni sulla distribuzione a CodeCatalyst**

1. Se l'esecuzione di un flusso di lavoro non si avvia automaticamente al momento del salvataggio delle modifiche[Fase 1: Associare l'ambiente a un'azione del flusso di lavoro](#deploy-environments-add-app-to-environment-assoc), avvia manualmente un'esecuzione come segue:

   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 repository di origine o al nome della filiale in cui è definito il flusso di lavoro oppure in base al nome o allo stato del flusso di lavoro.

   1. Scegli **Esegui**.

   L'esecuzione del flusso di lavoro avvia una nuova distribuzione, CodeCatalyst alla quale vengono aggiunte informazioni sulla distribuzione. CodeCatalyst

1. Verifica che l'attività di distribuzione sia stata aggiunta alla console: CodeCatalyst 

   1. Nel riquadro di navigazione, scegli ** CI/CD**, quindi scegli ** Ambienti. **

   1. Scegli il tuo ambiente (ad esempio,`Production`).

   1. Scegli la ** scheda Attività ** di distribuzione e verifica che una distribuzione appaia con ** lo stato ** di ** SUCCESSO. ** Ciò indica che l'esecuzione di un flusso di lavoro ha consentito di distribuire correttamente le risorse dell'applicazione.

   1. Scegli la ** scheda Destinazioni ** di distribuzione e verifica che le risorse dell'applicazione siano visualizzate.