Aggiungere trigger ai flussi di lavoro - Amazon CodeCatalyst

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à.

Aggiungere trigger ai flussi di lavoro

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

Per ulteriori informazioni sui trigger, consulta L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger.

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 o allo stato 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 (YAMLeditor)

      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 nel ramo in cui state inviando il push (ovvero il ramo di destinazione).

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

      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 (YAMLeditor)

      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à (YAMLeditor).)

      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: trigger nei flussi di lavoro.

    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. Di seguito sono riportati i valori validi:

    • Viene creata una pull request (editor visuale) o OPEN (YAMLeditor)

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

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

      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 flusso di lavoro 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: trigger nei flussi di lavoro.

    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:

    minutes hours days-of-month month days-of-week year

    Esempi di espressioni cron

    Minuti Ore Giorni del mese Mese Giorni della settimana Anno Significato

    0

    0

    ?

    *

    MON-FRI

    *

    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 Coordinated Universal Time (). UTC Altri fusi orari non sono supportati.

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

    • Specificare il days-of-month oppure days-of-week campo, 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: trigger nei flussi di lavoro

    Rami e schema delle filiali

    (Facoltativo)

    Specificate i rami del repository 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:

    Per ulteriori informazioni su rami e trigger, consulta. Linee guida per l'utilizzo di trigger e filiali

    Per ulteriori esempi, consulta Esempi: trigger nei flussi di lavoro.

    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: trigger nei flussi di lavoro.

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

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

YAML
Per aggiungere un trigger (YAMLeditor)

  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 o allo stato del flusso di lavoro.

  5. Scegli Modifica.

  6. Scegli YAML.

  7. Aggiungete una Triggers sezione e le proprietà sottostanti utilizzando l'esempio seguente come guida. Per ulteriori informazioni, consultare Triggers nella YAMLDefinizione del workflow.

    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: trigger nei flussi di lavoro

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

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