Stai utilizzando la nostra integrazione con GitHub per sincronizzare i lavori tra GitHub e ClickUp? Aggiungi le Automazioni di GitHub per creare un flusso di lavoro efficiente. I team di software possono ridurre il cambio di contesto utilizzando le Automazioni per mantenere tutto aggiornato.
Cosa ti serve
- Le integrazioni di automazione sono disponibili con i piani Business e superiori.
- L'amministratore o proprietario dello spazio di lavoro deve abilitare l'Automation ClickApp.
- È necessario disporre dei permessi di amministratore sul repository GitHub per configurare le Automazioni.
- Ospiti non possono utilizzare l'integrazione di GitHub.
Aggiungi un'Automazione GitHub in ClickUp
Puoi aggiungere le Automazioni GitHub a livello di spazi, cartelle ed elenchi della gerarchia ClickUp.
- Naviga nello Spazio, nella Cartella, o nell'Elenco dove verrà applicata l'Automazione.
- Clicca sul pulsante Automazioni nell'angolo in alto a destra.
- Fai clic su Aggiungi automazioni.
- Seleziona Sfoglia in alto.
- Seleziona Github dalla barra laterale sinistra.
- Seleziona l'Automazione che desideri utilizzare, o clicca Mostra altro per vedere altre Automazioni GitHub disponibili.
- Collega il tuo account GitHub utilizzando le opzioni seguenti:
-
Scegli dalla lista a discesa degli account GitHub esistenti.
- Per aggiornare un account GitHub precedentemente autorizzato, devi rimuoverlo e aggiungerlo nuovamente.
- Rimuovere un account non influenzerà le Automazioni esistenti che utilizzano quell'account. Dovrai riaggiungerlo per creare Automazioni GitHub in futuro.
- Inserisci il tuo nome utente GitHub e clicca Collega account e autorizza ClickUp o clicca Crea un account per creare un nuovo account su GitHub.com.
-
Scegli dalla lista a discesa degli account GitHub esistenti.
- Specifica chi può utilizzare il tuo account GitHub per creare Automazioni.
- Configura il Trigger, le Condizioni e le Azioni.
- Ogni Automazione di GitHub ti permette di scegliere un repository specifico.
- Le opzioni disponibili varieranno a seconda dell'Automazione GitHub che stai utilizzando.
- Fai clic su Crea.
- Considera di dare alla tua GitHub Automazioni una descrizione significativa per aiutare gli altri a capire Da fare.
Automazioni di GitHub
Le Automazioni di GitHub utilizzano la stessa struttura delle Automazioni in ClickUp.
Ogni automazione è costituita da un trigger e da un'azione. Gli utenti con il piano Business e superiori hanno l'opzione di utilizzare Condizioni.
Trigger di GitHub
Quando si verificano i seguenti eventi nel repo GitHub specificato, e le Condizioni sono soddisfatte, l'Automazione verrà eseguita e svolgerà un'Azione.
-
Richiesta di unione unificata
-
Branch Unito
-
Al Commit
-
Revisione della Richiesta di Pull Creata
-
Revisione della richiesta di unione aggiornata
-
Stato CI/CD modificato
-
Pull Request collegata
-
Ramo collegato
-
Commit collegato
Condizioni GitHub
Le automazioni di GitHub relative alle richieste di pull supportano una o più Condizioni.
Ad esempio, puoi aggiornare lo stato dell'attività quando una richiesta di pull al branch principale è collegata. Oppure imposta la priorità dell'attività come urgente e commenta quando una richiesta di pull con l'etichetta hotfix viene unita al branch QA .
Le condizioni possono essere impostate per diverse combinazioni di etichette delle richieste di pull, valori di base e valori di testa.
Logica condizionale
Puoi utilizzare la seguente logica di Condizione:
- è uno dei seguenti: La richiesta pull include almeno una delle etichette o dei rami specificati.
- include tutti: La richiesta di pull include tutte le etichette o i branch specificati.
- non è nessuno dei seguenti: La richiesta di pull non include nessuna delle etichette o dei branch specificati.
- non è tutto quanto: La richiesta di pull non include tutte le etichette o i branch specificati.
Per le etichette, puoi utilizzare la logica elencata sopra e..:
- è impostato: È stata applicata almeno un'etichetta alla richiesta di unione.
- non impostato: Nessuna etichetta è stata applicata alla richiesta di pull.
Aggiungi una Condizione
Per aggiungere una Condizione alla tua Automazione GitHub:
- Da un'Automazione, nella sezione Trigger, clicca su Aggiungi Condizione.
- Seleziona a cosa dovrebbe applicarsi la condizione:
- Condizione dell'etichetta Github: Etichette applicate alla richiesta di pull.
- Riferimento principale: Il ramo sorgente contenente le tue proposte di modifica.
- Rif. base: il ramo di destinazione in cui verranno applicate le modifiche.
Azioni ClickUp
Ogni Azione di Automazione, eccetto l'azione webhook, è disponibile per aggiornare le attività utilizzando i Trigger di GitHub.
Perché le Azioni di Automazione siano applicate alle attività esistenti, l'attività deve già essere collegata al repository di GitHub tramite il collegamento di un commit, un ramo o una richiesta pull. L'azione Crea Attività è l'unica eccezione, poiché le nuove attività non possono essere collegate in anticipo.
Azioni in GitHub
Puoi utilizzare le Automazioni con l'azione Crea Problema, che genera un nuovo problema su GitHub.
Ad esempio, quando viene inviato un modulo per la segnalazione di un bug e viene creata un'attività in un Elenco specifico, un'Automazione può creare un problema in GitHub.