Aggiungere un trigger push, pull o schedule

Utilizza le seguenti istruzioni per aggiungere un trigger push, pull o schedulate al tuo flusso di lavoro.

Visual

Per aggiungere un trigger (editor visivo)

1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

2. Scegliere il progetto.

3. Nel riquadro di navigazione, scegli CI/CD, quindi scegli Flussi di lavoro.

4. 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 del flusso di lavoro.

5. Scegli Modifica.

6. Scegli Visual.

7. Nel diagramma del flusso di lavoro, scegli la casella Source and Triggers.

8. Nel riquadro di configurazione, scegli Aggiungi trigger.

9. Nella finestra di dialogo Aggiungi trigger, fornisci le informazioni nei campi, come segue.

   Tipo di trigger

   Specificare il tipo di trigger. È possibile utilizzare uno dei seguenti valori:

   • Push (editor visivo) o PUSH (editor YAML)

     Un push trigger avvia l'esecuzione di un flusso di lavoro quando una modifica viene inviata all'archivio di origine. L'esecuzione del flusso di lavoro utilizzerà i file del ramo verso cui state inviando il push (ovvero il ramo di destinazione).

   • Pull request (editor visivo) o PULLREQUEST (editor YAML)

     Un trigger di pull request avvia un flusso di lavoro quando una pull request viene aperta, aggiornata o chiusa nel repository di origine. L'esecuzione del flusso di lavoro utilizzerà i file nel ramo da cui state estraendo (ovvero il ramo di origine).

   • Pianificazione (editor visivo) o SCHEDULE (editor YAML)

     Un trigger di pianificazione avvia l'esecuzione del flusso di lavoro in base a una pianificazione definita da un'espressione cron specificata dall'utente. Verrà avviato un flusso di lavoro separato per ogni ramo del repository di origine utilizzando i file del ramo. (Per limitare i rami su cui si attiva il trigger, usa il campo Branches (editor visivo) o la Branches proprietà (editor YAML).)

     Quando configuri un trigger di pianificazione, segui queste linee guida:

     • Utilizza solo un trigger di pianificazione per flusso di lavoro.

     • Se hai definito più flussi di lavoro nel tuo CodeCatalyst spazio, ti consigliamo di programmarne non più di 10 per avviarli contemporaneamente.

     • Assicurati di configurare l'espressione cron del trigger con un tempo adeguato tra le esecuzioni. Per ulteriori informazioni, consulta Expression.

   Per alcuni esempi, consulta Esempi di fattori scatenanti.

   Eventi per la pull request

   Questo campo viene visualizzato solo se è stato selezionato il tipo di trigger della richiesta Pull.

   Specificate il tipo di eventi di pull request che avvieranno l'esecuzione di un flusso di lavoro. I seguenti sono i valori validi:

   • Viene creata una pull request (editor visivo) o OPEN (editor YAML)

     L'esecuzione del flusso di lavoro viene avviata quando viene creata una richiesta pull.

   • La pull request è chiusa (editor visivo) o CLOSED (editor YAML)

     L'esecuzione del flusso di lavoro viene avviata quando viene chiusa una pull request. Il comportamento dell'CLOSEDevento è complicato e può essere compreso meglio attraverso un esempio. Per ulteriori informazioni, consulta Esempio: un trigger con pull, branch e un evento «CLOSED».

   • Viene effettuata una nuova revisione per pull request (editor visivo) o REVISION (editor YAML)

     L'esecuzione del workflow viene avviata quando viene creata una revisione di una pull request. La prima revisione viene creata quando viene creata la pull request. Dopodiché, viene creata una nuova revisione ogni volta che qualcuno invia un nuovo commit al ramo sorgente specificato nella pull request. Se includi l'REVISIONevento nel trigger della pull request, puoi omettere l'OPENevento, poiché REVISION è un superset di. OPEN

   È possibile specificare più eventi nello stesso trigger di pull request.

   Per alcuni esempi, consulta Esempi di fattori scatenanti.

   Pianificazione

   Questo campo viene visualizzato solo se è stato selezionato il tipo di trigger Schedule.

   Specificate l'espressione cron che descrive quando desiderate che avvenga l'esecuzione del flusso di lavoro pianificato.

   Le espressioni Cron CodeCatalyst utilizzano la seguente sintassi a sei campi, in cui ogni campo è separato da uno spazio:

   minuti, ore, mese, anno. days-of-monthdays-of-week

   Esempi di espressioni cron

   Minuti	Ore	Giorni del mese	Mese	Giorni della settimana	Anno	Significato
   0	0	?	*	LUN-VEN	*	Esegue un flusso di lavoro a mezzanotte (UTC+0) dal lunedì al venerdì.
   0	2	*	*	?	*	Esegue un flusso di lavoro ogni giorno alle 2:00 (UTC+0).
   15	22	*	*	?	*	Esegue un flusso di lavoro alle 22:15 (UTC+0) ogni giorno.
   0/30	22-2	?	*	SAT-SUN	*	Esegue un flusso di lavoro ogni 30 minuti dal sabato alla domenica tra le 22:00 del giorno iniziale e le 2:00 del giorno successivo (UTC+0).
   45	13	L	*	?	2023-2027	Esegue un flusso di lavoro alle 13:45 (UTC+0) dell'ultimo giorno del mese tra gli anni 2023 e 2027 inclusi.

   Quando specifichi le espressioni cron in CodeCatalyst, assicurati di seguire queste linee guida:

   • Specificate una singola espressione cron per trigger. SCHEDULE

   • Racchiudi l'espressione cron tra virgolette doppie (") nell'editor YAML.

   • Specificate l'ora in UTC (Coordinated Universal Time). Altri fusi orari non sono supportati.

   • Configura almeno 30 minuti tra un'esecuzione e l'altra. Una cadenza più veloce non è supportata.

   • Specificate il days-of-weekcampo days-of-montho, ma non entrambi. Se si specifica un valore o un asterisco (*) in uno dei campi, è necessario utilizzare un punto interrogativo (?) nell'altro. L'asterisco significa «tutti» e il punto interrogativo significa «qualsiasi».

   Per altri esempi di espressioni cron e informazioni sui caratteri jolly come, e ? *L, consulta il riferimento alle espressioni Cron nella Amazon EventBridge User Guide. Le espressioni Cron CodeCatalyst funzionano esattamente EventBridge allo stesso modo.

   Per esempi di trigger di pianificazione, vedi. Esempi di fattori scatenanti

   Rami e schema delle filiali

   (Facoltativo)

   Specificate i rami nel vostro archivio di origine monitorati dal trigger per sapere quando avviare l'esecuzione di un flusso di lavoro. È possibile utilizzare modelli regex per definire i nomi delle filiali. Ad esempio, utilizzare per main.* abbinare tutti i rami che iniziano conmain.

   I rami da specificare sono diversi a seconda del tipo di trigger:

   • Per un trigger push, specifica i rami verso cui stai eseguendo il push, ovvero i rami di destinazione. Verrà avviata un'esecuzione del flusso di lavoro per ramo corrispondente, utilizzando i file nel ramo corrispondente.

     Esempi: main.*, mainline

   • Per un trigger di pull request, specifica i rami verso cui stai inviando il push, ovvero i rami di destinazione. Verrà avviata un'esecuzione del flusso di lavoro per ramo corrispondente, utilizzando il file di definizione del flusso di lavoro e i file di origine nel ramo di origine (non nel ramo corrispondente).

     Esempi:main.*,mainline, v1\-.* (corrisponde ai rami che iniziano con) v1-

   • Per un trigger di pianificazione, specifica i rami che contengono i file che desideri vengano utilizzati dall'esecuzione pianificata. Verrà avviata un'esecuzione del flusso di lavoro per ramo corrispondente, utilizzando il file di definizione del flusso di lavoro e i file sorgente nel ramo corrispondente.

     Esempi: main.*, version\-1\.0

   Nota

   Se non specifichi i rami, il trigger monitora tutti i rami nel tuo repository di origine e avvierà un flusso di lavoro eseguito utilizzando il file di definizione del flusso di lavoro e i file sorgente in:

   • Il ramo verso cui stai eseguendo il push (per i trigger push). Per ulteriori informazioni, consulta Esempio: un semplice pulsante di comando a codice.

   • Il ramo da cui stai prelevando (per i trigger di pull request). Per ulteriori informazioni, consulta Esempio: un semplice trigger di pull request.

   • Tutte le filiali (per i trigger di pianificazione). Verrà avviata un'unica esecuzione del flusso di lavoro per ramo nel repository di origine. Per ulteriori informazioni, consulta Esempio: un semplice trigger di pianificazione.

   Per ulteriori informazioni su rami e trigger, consulta. Attiva considerazioni durante la ramificazione

   Per ulteriori esempi, consulta Esempi di fattori scatenanti.

   File modificati

   Questo campo viene visualizzato solo se è stato selezionato il tipo di trigger di richiesta Push o Pull.

   Specificate i file o le cartelle nell'archivio di origine monitorati dal trigger per sapere quando avviare l'esecuzione di un flusso di lavoro. È possibile utilizzare espressioni regolari per abbinare nomi o percorsi di file.

   Per alcuni esempi, consulta Esempi di fattori scatenanti.

10. (Facoltativo) Scegliete Convalida per convalidare il codice YAML del flusso di lavoro prima di eseguire il commit.

11. Scegliete Commit, inserite un messaggio di commit e scegliete nuovamente Commit.

YAML

Per aggiungere un trigger (editor YAML)

1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

2. Scegliere il progetto.

3. Nel riquadro di navigazione, scegli CI/CD, quindi scegli Flussi di lavoro.

4. 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 del flusso di lavoro.

5. Scegli Modifica.

6. Scegli YAML.

7. Aggiungi una Triggers sezione e le proprietà sottostanti usando l'esempio seguente come guida. Per ulteriori informazioni, consultare Triggers nella Definizione YAML del flusso di lavoro.

   Un trigger con codice potrebbe avere il seguente aspetto:

   Triggers:
     - Type: PUSH
       Branches:
         - main

   Un trigger di pull request potrebbe avere il seguente aspetto:

   Triggers:
     - Type: PULLREQUEST
       Branches:
         - main.*
       Events: 
         - OPEN
         - REVISION
         - CLOSED
   

   Un trigger di pianificazione potrebbe essere simile al seguente:

   Triggers:
     - Type: SCHEDULE
       Branches:
         - main.*
       # Run the workflow at 1:15 am (UTC+0) every Friday until the end of 2023
       Expression: "15 1 ? * FRI 2022-2023"
   

   Per altri esempi di espressioni cron che è possibile utilizzare nella Expression proprietà, vedereExpression.

   Per altri esempi di trigger push, pull request e schedule, vedi. Esempi di fattori scatenanti

8. (Facoltativo) Scegliete Convalida per convalidare il codice YAML del flusso di lavoro prima di eseguire il commit.

9. Scegliete Commit, inserite un messaggio di commit e scegliete nuovamente Commit.