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à.
# Richiesta di approvazioni per l'esecuzione del flusso di lavoro
È possibile configurare l'esecuzione di un flusso di lavoro in modo che richieda un'approvazione prima di procedere. A tale scopo, è necessario aggiungere una [porta](workflows-gates.md) di **approvazione** al flusso di lavoro. Un *cancello di approvazione* impedisce che un flusso di lavoro proceda finché un utente o un gruppo di utenti non invia una o più approvazioni nella console. CodeCatalyst Una volta concesse tutte le approvazioni, il gate viene «sbloccato» e l'esecuzione del flusso di lavoro può riprendere.
Utilizza un **Approval** gate nel tuo flusso di lavoro per dare ai team di sviluppo, operativi e di leadership la possibilità di esaminare le modifiche prima che vengano distribuite a un pubblico più ampio.
Per ulteriori informazioni sulle esecuzioni del flusso di lavoro, consulta[Esecuzione di un workflow](workflows-working-runs.md).
**Topics**
+ [Come posso sbloccare un cancello di approvazione?](#workflows-approval-conditions)
+ [Quando utilizzare la porta «Approvazione»](#workflows-approval-when)
+ [Chi può fornire un'approvazione?](#workflows-approval-who)
+ [Come faccio a notificare agli utenti che è necessaria un'approvazione?](#workflows-approval-notify-methods)
+ [Posso utilizzare una porta di «Approvazione» per impedire l'avvio di un flusso di lavoro?](#workflows-approval-prevent)
+ [Come funzionano le approvazioni dei flussi di lavoro con le modalità di esecuzione in coda, sostituita e parallela?](#workflows-approval-run-mode)
+ [Esempio: un cancello di «approvazione»](workflows-approval-example.md)
+ [Aggiungere un cancello di «Approvazione»](workflows-approval-add.md)
+ [Configurazione delle notifiche di approvazione](workflows-approval-notify.md)
+ [Approvazione o rifiuto dell'esecuzione di un flusso di lavoro](workflows-approval-approve.md)
+ [Porta «Approvazione» YAML](approval-ref.md)
## Come posso sbloccare un cancello di approvazione?
Per sbloccare un cancello di **approvazione**, devono essere soddisfatte *tutte* le seguenti condizioni:
+ **Condizione 1**: è necessario presentare il numero richiesto di approvazioni. Il numero richiesto di approvazioni è configurabile e ogni utente può inviare una singola approvazione.
+ **Condizione 2**: Tutte le approvazioni devono essere presentate prima del timeout del gate. Il cancello scade 14 giorni dopo l'attivazione. Questo periodo non è configurabile.
+ **Condizione 3**: nessuno deve rifiutare l'esecuzione del flusso di lavoro. Un singolo rifiuto causerà l'interruzione dell'esecuzione del flusso di lavoro.
+ **Condizione 4**: (Si applica solo se si utilizza la modalità di esecuzione sostituita). L'esecuzione non deve essere sostituita da un'esecuzione successiva. Per ulteriori informazioni, consulta [Come funzionano le approvazioni dei flussi di lavoro con le modalità di esecuzione in coda, sostituita e parallela?](#workflows-approval-run-mode).
**Se una qualsiasi delle condizioni non viene soddisfatta, CodeCatalyst interrompe il flusso di lavoro e imposta lo stato di esecuzione su **Non riuscito** (nel caso delle **condizioni da 1** a **3**) o **Sostituito** (nel caso della Condizione 4).**
## Quando utilizzare la porta «Approvazione»
In genere, si utilizza un gate di **approvazione** in un flusso di lavoro che distribuisce applicazioni e altre risorse su un server di produzione o in qualsiasi ambiente in cui è necessario convalidare gli standard di qualità. Posizionando il gate prima dell'implementazione in produzione, offri ai revisori la possibilità di convalidare la nuova revisione del software prima che diventi disponibile al pubblico.
## Chi può fornire un'approvazione?
Qualsiasi utente membro del progetto e con il ruolo di **collaboratore o** **amministratore del progetto** può fornire un'approvazione. Anche gli utenti con il ruolo di **amministratore dello spazio** che appartengono allo spazio del progetto possono fornire un'approvazione.
**Nota**
Gli utenti con il ruolo **Revisore** non possono fornire approvazioni.
## Come faccio a notificare agli utenti che è necessaria un'approvazione?
Per notificare agli utenti che è necessaria un'approvazione, devi:
+ Ho CodeCatalyst inviato loro una notifica Slack. Per ulteriori informazioni, consulta [Configurazione delle notifiche di approvazione](workflows-approval-notify.md).
+ Vai alla pagina della CodeCatalyst console in cui si trovano i pulsanti **Approva e** **Rifiuta** e incolla l'URL della pagina in un'applicazione di posta elettronica o di messaggistica indirizzata agli approvatori. Per ulteriori informazioni su come accedere a questa pagina, consulta. [Approvazione o rifiuto dell'esecuzione di un flusso di lavoro](workflows-approval-approve.md)
## Posso utilizzare una porta di «Approvazione» per impedire l'avvio di un flusso di lavoro?
Sì, con qualifiche. Per ulteriori informazioni, consulta [Posso usare un gate per impedire l'avvio di un workflow?](workflows-gates.md#workflows-gates-prevent).
## Come funzionano le approvazioni dei flussi di lavoro con le modalità di esecuzione in coda, sostituita e parallela?
[Quando si utilizza la modalità in coda, sostituita o di esecuzione parallela, la porta **Approval** funziona in modo simile alle azioni.](workflows-actions.md) Ti consigliamo di leggere le [Informazioni sulla modalità di esecuzione parallela](workflows-configure-runs.md#workflows-configure-runs-parallel) sezioni[Informazioni sulla modalità di esecuzione in coda](workflows-configure-runs.md#workflows-configure-runs-queued),[Informazioni sulla modalità di esecuzione sostituita](workflows-configure-runs.md#workflows-configure-runs-superseded), per acquisire familiarità con queste modalità di esecuzione. Una volta acquisita una conoscenza di base delle stesse, torna a questa sezione per scoprire come funzionano queste modalità di esecuzione quando è presente l'**Approval** gate.
Quando è presente l'**Approval** gate, le esecuzioni vengono elaborate come segue:
+ Se utilizzi la [modalità di esecuzione in coda](workflows-configure-runs.md#workflows-configure-runs-queued), le esecuzioni verranno messe in coda dopo l'esecuzione attualmente in attesa di approvazione al gate. Quando il gate viene sbloccato (ossia, tutte le approvazioni sono state concesse), la corsa successiva della coda avanza fino al gate e attende le approvazioni. Questo processo continua con l'elaborazione delle esecuzioni in coda attraverso il gate. one-by-one [Figure 1](#figure-1-workflow-queued-run-mode-ma)illustra questo processo.
+ Se si utilizza la modalità di [esecuzione sostituita, il comportamento è lo stesso della modalità](workflows-configure-runs.md#workflows-configure-runs-superseded) di esecuzione in coda, tranne per il fatto che invece di avere delle esecuzioni accumulate nella coda all'ingresso, le esecuzioni più recenti sostituiscono (sostituiscono) le esecuzioni precedenti. Non ci sono code e qualsiasi esecuzione attualmente in attesa di approvazione all'uscita verrà annullata e sostituita da una nuova esecuzione. [Figure 2](#figure-2-workflow-superseded-run-mode-ma)illustra questo processo.
+ Se utilizzi la [modalità di esecuzione parallela](workflows-configure-runs.md#workflows-configure-runs-parallel), le esecuzioni iniziano in parallelo e non si formano code. Ogni esecuzione viene elaborata immediatamente dal gate poiché non ci sono esecuzioni precedenti. [Figure 3](#figure-3-workflow-parallel-run-mode-ma)illustra questo processo.
**Figura 1****: «modalità di esecuzione in coda» e un cancello di approvazione**
![\[Come funziona una porta «Approvazione» con la «modalità di esecuzione in coda»\]](http://docs.aws.amazon.com/it_it/codecatalyst/latest/userguide/images/flows/runmode-queued-ma.png)
**Figura 2****: «Modalità di esecuzione sostituita» e porta di approvazione**
![\[Come funziona un gate «Approval» con la «modalità di esecuzione sostituita»\]](http://docs.aws.amazon.com/it_it/codecatalyst/latest/userguide/images/flows/runmode-superseded-ma.png)
**Figura 3****: «modalità di esecuzione parallela» e porta di approvazione**
![\[Come funziona un gate «Approval» con la «modalità di esecuzione parallela»\]](http://docs.aws.amazon.com/it_it/codecatalyst/latest/userguide/images/flows/runmode-parallel-ma.png)
# Esempio: un cancello di «approvazione»
L'esempio seguente mostra come aggiungere un gate di **approvazione** chiamato `Approval_01` tra due azioni chiamate`Staging`, e`Production`. L'`Staging`azione viene eseguita per prima, il `Approval_01` gate dopo e l'`Production`azione per ultima. L'`Production`azione viene eseguita solo se il `Approval_01` cancello è sbloccato. La `DependsOn` proprietà garantisce che le `Production` fasi `Staging``Approval_01`, e vengano eseguite in ordine sequenziale.
Per ulteriori informazioni sull'**Approval** gate, vedere[Richiesta di approvazioni per l'esecuzione del flusso di lavoro](workflows-approval.md).
```
Actions:
Staging: # Deploy to a staging server
Identifier: aws/ecs-deploy@v1
Configuration:
...
Approval_01:
Identifier: aws/approval@v1
DependsOn:
- Staging
Configuration:
ApprovalsRequired: 2
Production: # Deploy to a production server
Identifier: aws/ecs-deploy@v1
DependsOn:
- Approval_01
Configuration:
...
```
# Aggiungere un cancello di «Approvazione»
Per configurare il flusso di lavoro in modo che richieda un'approvazione, è necessario aggiungere la porta di **approvazione** al flusso di lavoro. Utilizza le seguenti istruzioni per aggiungere una porta di **approvazione** al tuo flusso di lavoro.
Per ulteriori informazioni su questo cancello, vedi[Richiesta di approvazioni per l'esecuzione del flusso di lavoro](workflows-approval.md).
------
#### [ Visual ]
**Per aggiungere una porta di «Approvazione» a un flusso di lavoro (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. **In alto a sinistra, scegli Gates.**
1. Nel catalogo **Gates**, in **Approvazione**, scegli il segno più (**\$1**).
1. Scegliete **Input** e, nel campo **Dipende da**, effettuate le seguenti operazioni.
Specificate un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente affinché questo gate possa funzionare. Per impostazione predefinita, quando aggiungi un gate a un workflow, il gate è impostato in modo da dipendere dall'ultima azione del workflow. Se rimuovi questa proprietà, il gate non dipenderà da nulla e verrà eseguito per primo, prima di altre azioni.
**Nota**
Un gate deve essere configurato per essere eseguito prima o dopo un'azione, un gruppo di azioni o un gate. Non può essere configurato per funzionare in parallelo con altre azioni, gruppi di azioni e gate.
Per ulteriori informazioni sulla funzionalità **Depends on**, vedere[Sequenziamento di porte e azioni](workflows-gates-depends-on.md).
1. Scegli la scheda **Configurazione**.
1. Nel campo **Gate name**, effettuate le seguenti operazioni.
Specificate il nome che volete dare al cancello. Tutti i nomi delle porte devono essere univoci all'interno del flusso di lavoro. I nomi delle porte 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 porte.
1. (Facoltativo) Nel campo **Numero di approvazioni**, procedi come segue.
Specificate il numero minimo di approvazioni necessarie per sbloccare l'**Approval** gate. Il minimo è`1`. Il massimo è`2`. Se omesso, il valore predefinito è`1`.
**Nota**
Se desideri omettere la `ApprovalsRequired` proprietà, rimuovi la `Configuration` sezione del gate dal file di definizione del flusso di lavoro.
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 aggiungere una porta di «Approvazione» a un flusso di lavoro (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. Aggiungi una `Approval` sezione e le proprietà sottostanti usando l'esempio seguente come guida. Per ulteriori informazioni, consultare [Porta «Approvazione» YAML](approval-ref.md) nella [Definizione YAML del flusso di lavoro](workflow-reference.md).
```
Actions:
MyApproval_01:
Identifier: aws/approval@v1
DependsOn:
- PreviousAction
Configuration:
ApprovalsRequired: 2
```
Per un altro esempio, consulta [Esempio: un cancello di «approvazione»](workflows-approval-example.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.**
------
# Configurazione delle notifiche di approvazione
Puoi fare in modo che venga CodeCatalyst inviata una notifica a un canale Slack per informare gli utenti che l'esecuzione di un flusso di lavoro richiede un'approvazione. Gli utenti visualizzano la notifica e fanno clic sul link al suo interno. Il link li porta a una pagina di CodeCatalyst approvazione in cui possono approvare o rifiutare il flusso di lavoro.
Puoi anche configurare le notifiche per informare gli utenti che un flusso di lavoro è stato approvato, rifiutato o che la richiesta di approvazione è scaduta.
Usa le seguenti istruzioni per configurare le notifiche di Slack.
**Prima di iniziare**
Assicurati di aver aggiunto un cancello di **approvazione** al tuo flusso di lavoro. Per ulteriori informazioni, consulta [Aggiungere un cancello di «Approvazione»](workflows-approval-add.md).
**Per inviare notifiche di approvazione del flusso di lavoro a un canale Slack**
1. Configura CodeCatalyst con Slack. Per ulteriori informazioni, consulta [Guida introduttiva alle notifiche di Slack](getting-started-notifications.md).
1. Nel CodeCatalyst progetto che contiene il flusso di lavoro che richiede un'approvazione, abilita le notifiche, se non sono già abilitate. Per abilitare le notifiche:
1. Vai al tuo progetto e nel riquadro di navigazione, scegli **Impostazioni progetto**.
1. In alto, scegli **Notifiche**.
1. In **Eventi di notifica**, scegli **Modifica notifiche**.
1. Attiva **l'approvazione del flusso di lavoro in sospeso** e scegli un canale Slack a cui inviare la CodeCatalyst notifica.
1. (Facoltativo) Attiva notifiche aggiuntive per avvisare gli utenti delle approvazioni approvate, rifiutate e scadute. Puoi attivare l'approvazione dell'**esecuzione del flusso di lavoro, l'esecuzione del **flusso di lavoro rifiutata****, l'approvazione del **flusso di lavoro sostituita e l'approvazione del **flusso** di lavoro è scaduta**. Accanto a ciascuna notifica, scegli il canale Slack a cui inviare la CodeCatalyst notifica.
1. Seleziona **Salva**.
# Approvazione o rifiuto dell'esecuzione di un flusso di lavoro
Le esecuzioni del flusso di lavoro che includono la porta di **approvazione** dovranno essere approvate o rifiutate. Gli utenti possono fornire la propria approvazione o rifiuto a partire da:
+ la console CodeCatalyst
+ un link fornito da un membro del team
+ una notifica automatica su Slack
Dopo che un utente ha fornito l'approvazione o il rifiuto, questa decisione non può essere annullata.
**Nota**
Solo alcuni utenti possono approvare o rifiutare l'esecuzione di un flusso di lavoro. Per ulteriori informazioni, consulta [Chi può fornire un'approvazione?](workflows-approval.md#workflows-approval-who).
**Prima di iniziare**
Assicurati di aver aggiunto un cancello di **approvazione** al tuo flusso di lavoro. Per ulteriori informazioni, consulta [Aggiungere un cancello di «Approvazione»](workflows-approval-add.md).
**Per approvare o rifiutare un flusso di lavoro, esegui a partire dalla console. CodeCatalyst**
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. Nel diagramma del flusso di lavoro, scegli la casella che rappresenta la porta di **approvazione**.
Viene visualizzato un pannello laterale.
**Nota**
A questo punto, puoi inviare l'URL di questa pagina ad altri approvatori, se lo desideri.
1. **In **Revisione della decisione**, scegli **Approva o Rifiuta**.**
1. (Facoltativo) In **Commento: facoltativo**, inserisci un commento che indichi il motivo per cui hai approvato o rifiutato l'esecuzione del flusso di lavoro.
1. Seleziona **Invia**.
**Per approvare o rifiutare un flusso di lavoro, esegui a partire da un link fornito da un membro del team.**
1. Scegli il link che ti è stato inviato dal membro del team. (Puoi chiedere al membro del tuo team di leggere la procedura precedente per ottenere il link.)
1. Accedi a CodeCatalyst, se richiesto.
Verrai reindirizzato alla pagina di approvazione dell'esecuzione del flusso di lavoro.
1. **In **Decisione di revisione**, scegli **Approva o Rifiuta**.**
1. (Facoltativo) In **Commento: facoltativo**, inserisci un commento che indichi il motivo per cui hai approvato o rifiutato l'esecuzione del flusso di lavoro.
1. Seleziona **Invia**.
**Per approvare o rifiutare un flusso di lavoro, esegui a partire da una notifica automatica di Slack**
1. Assicurati che le notifiche Slack siano configurate. Per informazioni, consulta [Configurazione delle notifiche di approvazione](workflows-approval-notify.md).
1. In Slack, nel canale a cui è stata inviata la notifica di approvazione, scegli il link nella notifica di approvazione.
1. Accedi a CodeCatalyst, se richiesto.
Verrai reindirizzato alla pagina di esecuzione del flusso di lavoro.
1. Nel diagramma del flusso di lavoro, scegli la porta di approvazione.
1. **In **Decisione di revisione**, scegli **Approva o Rifiuta**.**
1. (Facoltativo) In **Commento: facoltativo**, inserisci un commento che indichi il motivo per cui hai approvato o rifiutato l'esecuzione del flusso di lavoro.
1. Seleziona **Invia**.
# Porta «Approvazione» YAML
**Di seguito è riportata la definizione YAML della porta di approvazione.** Per imparare a usare questo cancello, vedi. [Richiesta di approvazioni per l'esecuzione del flusso di lavoro](workflows-approval.md)
Questa definizione di azione esiste come sezione all'interno di un file di definizione del flusso di lavoro più ampio. Per ulteriori informazioni su questo file, consulta [Definizione YAML del flusso di lavoro](workflow-reference.md).
**Nota**
La maggior parte delle proprietà YAML che seguono hanno elementi dell'interfaccia utente corrispondenti nell'editor visivo. **Per cercare un elemento dell'interfaccia utente, usa Ctrl\$1F.** L'elemento verrà elencato con la proprietà YAML associata.
```
# The workflow definition starts here.
# See Proprietà di primo livello for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The 'Approval' gate definition starts here.
Approval:
Identifier: aws/approval@v1
DependsOn:
- another-action
Configuration:
ApprovalsRequired: number
```
## Approval
(Obbligatorio)
Specificate il nome che volete dare al cancello. Tutti i nomi delle porte devono essere univoci all'interno del flusso di lavoro. I nomi delle porte 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 porte.
Default: `Approval_nn`.
**Interfaccia utente corrispondente: scheda di configurazione/nome del gate**
## Identifier
(*Approval*/**Identifier**)
(Obbligatorio)
Identifica la porta. La porta di **approvazione** supporta la versione`1.0.0`. Non modificate questa proprietà a meno che non vogliate abbreviare la versione. Per ulteriori informazioni, consulta [Specificare la versione dell'azione da utilizzare](workflows-action-versions.md).
Default: `aws/approval@v1`.
**Interfaccia utente corrispondente: Workflow diagram/ Approval \$1nn/ aws/approval @v1 label**
## DependsOn
(*Approval*/**DependsOn**)
(Facoltativo)
Specificare un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente affinché questo gate possa funzionare. Per impostazione predefinita, quando aggiungi un gate a un workflow, il gate è impostato in modo da dipendere dall'ultima azione del workflow. Se rimuovi questa proprietà, il gate non dipenderà da nulla e verrà eseguito per primo, prima di altre azioni.
**Nota**
Un gate deve essere configurato per essere eseguito prima o dopo un'azione, un gruppo di azioni o un gate. Non può essere configurato per funzionare in parallelo con altre azioni, gruppi di azioni e gate.
Per ulteriori informazioni sulla funzionalità **Depends on**, vedere[Sequenziamento di porte e azioni](workflows-gates-depends-on.md).
**Interfaccia utente corrispondente: scheda Inputs/ Depends on**
## Configuration
(*Approval*/**Configuration**)
(Facoltativo)
Una sezione in cui è possibile definire le proprietà di configurazione del gate.
Interfaccia utente corrispondente: scheda **Configurazione**
## ApprovalsRequired
(*Approval*/Configuration/**ApprovalsRequired**)
(Facoltativo)
Specificate il numero minimo di approvazioni necessarie per sbloccare la porta di **approvazione**. Il minimo è`1`. Il massimo è`2`. Se omesso, il valore predefinito è`1`.
**Nota**
Se desideri omettere la `ApprovalsRequired` proprietà, rimuovi la `Configuration` sezione del gate dal file di definizione del flusso di lavoro.
Interfaccia utente corrispondente: scheda di configurazione/ **Numero di approvazioni**