Ricerca

Chiedimi qualsiasi cosa

Usa le automazioni di GitHub

Utilizzi la nostra integrazione con GitHub per sincronizzare il lavoro tra GitHub e ClickUp? Aggiungi le Automazioni GitHub per creare un flusso di lavoro efficiente. I team di sviluppo software possono ridurre il cambio di contesto usando le Automazioni per mantenere tutto aggiornato.

Le integrazioni per le Automazioni sono disponibili per i piani Business e superiori.

L'amministratore o titolare dell'Area di lavoro deve attivare la ClickApp Automazione.

Per configurare le Automazioni, sono necessarie le autorizzazioni di amministratore del repository GitHub.

Gli Ospiti e i membri con accesso limitato non possono usare l'integrazione con GitHub.

Creare un'Automazione GitHub in ClickUp

Per configurare un'Automazione GitHub, da un Elenco, una sottocartella, una Cartella o uno Spazio:

  1. In alto a destra, fai clic sull'icona robot.
  2. Fai clic su Crea Automazione:
    • Seleziona un trigger o un'azione GitHub.
    • Oppure, dalla barra laterale sinistra, fai clic su GitHub e seleziona un modello di Automazione.
  3. Configura il Trigger, le Condizioni e le Azioni.
    • Seleziona o collega il tuo account GitHub.
    • Inserisci il tuo nome utente GitHub, fai clic su Connetti account e autorizza ClickUp.
    • Oppure fai clic su Crea un account per creare un nuovo account su GitHub.com.
    • Per aggiornare un account GitHub precedentemente autorizzato, devi rimuoverlo e aggiungerlo di nuovo.
    • La rimozione di un account non influisce sulle Automazioni esistenti che lo utilizzano. Dovrai aggiungerlo di nuovo per creare Automazioni GitHub in futuro.
    • Specifica chi può usare il tuo account GitHub per creare Automazioni.
    • Ogni Automazione GitHub ti consente di scegliere un repository specifico (repo).
  4. Fai clic su Crea.

Automazioni GitHub

Le Automazioni GitHub usano la stessa struttura delle Automazioni in ClickUp.

Ogni Automazione è composta da un Trigger e un'Azione. Gli utenti con il piano Business e superiori possono usare le Condizioni.

Trigger GitHub

Quando si verificano i seguenti eventi nel repository GitHub specificato e le Condizioni sono soddisfatte, l'Automazione viene eseguita e compie un'Azione.

  • Pull Request Merged
  • Branch Merged
  • On Commit
  • Pull Request Review Created
  • Pull Request Review Updated
  • CI/CD Status Changed
  • Pull Request Linked
  • Branch Linked
  • Commit Linked

Condizioni GitHub

Le Automazioni GitHub correlate alle pull request supportano una o più Condizioni.

Ad esempio, puoi aggiornare lo stato dell'attività quando una pull request al branch main viene collegata. Oppure impostare la priorità dell'attività su urgente e aggiungere un commento quando una pull request con l'etichetta hotfix viene unita al branch QA.

Le Condizioni possono essere impostate per più combinazioni di etichette di pull request, ref di base e valori di ref head.

Logica delle condizioni

Puoi usare la seguente logica per le Condizioni:

  • è uno qualsiasi di: la pull request include almeno una delle etichette o dei branch specificati.
  • è tutto di: la pull request include tutte le etichette o i branch specificati.
  • non è nessuno di: la pull request non include nessuna delle etichette o dei branch specificati.
  • non è tutto di: la pull request non include tutte le etichette o i branch specificati.

Per le etichette, puoi usare la logica elencata sopra e inoltre:

  • è impostata: almeno un'etichetta è stata applicata alla pull request.
  • non è impostata: nessuna etichetta è stata applicata alla pull request.

Aggiungere una condizione

Per aggiungere una Condizione alla tua Automazione GitHub:

  1. Da un'Automazione, nella sezione Trigger, fai clic su Aggiungi condizione.
  2. Seleziona a cosa deve applicarsi la condizione:
    • Condizione etichetta Github: le etichette applicate alla pull request.
    • Head ref: il branch sorgente contenente le modifiche proposte.
    • Base ref: il branch di destinazione in cui verranno applicate le modifiche.
  3. Seleziona la logica della Condizione.
  4. Scegli il valore dell'etichetta o del branch da usare con questa condizione. Le Condizioni distinguono tra maiuscole e minuscole e devono corrispondere esattamente al nome dell'etichetta o del branch: in caso contrario, i criteri non saranno soddisfatti e l'Automazione non verrà attivata.
  5. Fai clic su Aggiungi un altro per includere un valore aggiuntivo di etichetta o branch.
  6. Fai clic su Aggiungi condizione per aggiungere più Condizioni.

Azioni ClickUp

Ogni Azione di Automazione, ad eccezione dell'azione webhook, è disponibile per aggiornare le attività usando i Trigger GitHub.

Perché le Azioni di Automazione vengano applicate alle attività esistenti, l'attività deve essere già collegata al repository GitHub tramite un commit, un branch o una pull request. L'unica eccezione è l'azione Crea attività, poiché le nuove attività non possono essere collegate in anticipo.

Azioni in GitHub

Puoi usare le Automazioni con l'Azione Crea issue, che crea una nuova issue in GitHub.

Ad esempio, quando viene inviato un modulo di segnalazione bug e viene creata un'attività in un Elenco specifico, un'Automazione può creare una issue in GitHub.