Integra i commit, i branch e le richieste di merge di GitLab con le attività di ClickUp. Questo ti permette di: 

• Vedi tutte le attività di GitLab relative a un'attività in ClickUp. 
• Opzionalmente ricevi notifiche di ClickUp quando vengono aggiunti nuovi elementi di attività di GitLab alle attività.
• Allega automaticamente o manualmente le azioni di Gitlab alle attività di ClickUp. 
• Modifica automaticamente gli stati con le azioni di Gitlab aggiungendo l'ID dell'attività di ClickUp ai tuoi commit con questo format: #{taskID}[stato].
  • Esempio: #1abc2de[chiuso]

Cosa ti serve

• L'integrazione con GitLab è disponibile su ogni piano di ClickUp.
• Solo i proprietari e gli amministratori dello spazio di lavoro possono configurare le integrazioni.
• Gli ospiti non possono utilizzare l'integrazione GitLab.
• L'integrazione con GitLab funziona sia con le versioni on-premise che self-hosted di GitLab.

Passaggio 1: Autorizzare Gitlab

Connettiti e autorizza Gitlab da ClickUp:

1. Nell'angolo in alto a destra, clicca sul menu delle azioni rapide.
2. Clicca Centro Applicazioni.
3. Dalla barra laterale del Centro Applicazioni, seleziona Sviluppo.
4. Clicca su Gitlab.
5. Seleziona Connetti.
6. Accedi al tuo account Gitlab.

Autenticati con gitlab.com o con Gitlab self-hosted

Una volta collegato il tuo account GitLab, puoi scegliere di autorizzare tramite gitlab.com o un GitLab auto-ospitato.

Utilizzo di Gitlab.com:

1. Nella pagina del Gitlab App Center, clicca su Gestisci.
2. Clicca su + Aggiungi Gitlab.
3. Seleziona No, uso gitlab.com.
4. Clicca su Collega Gitlab.
5. Clicca su Autorizza. Devi autorizzare ClickUp ad associare l'attività di GitLab con le tue attività ClickUp.

Utilizzo di Gitlab in hosting:

1. Nella pagina del Gitlab App Center, clicca su Gestisci.
2. Clicca su + Aggiungi Gitlab.
3. Seleziona Sì, utilizzo una versione ospitata di Gitlab.
4. Inserisci l'URL del tuo GitLab nella casella di testo URL host .
   • URL di esempio: https://gitlab.mydomain.com/
5. Segui le istruzioni per trovare, copiare e incollare il tuo token di accesso personale nella casella di testo Token di accesso.
   

   Se il tuo team è dietro un firewall, includi il tuo indirizzo IP statico nella lista dei permessi del firewall prima di integrare. Questo indirizzo IP statico verrà mostrato in questa fase.

6. Clicca su Collega Gitlab.
7. Clicca su Autorizza. Devi autorizzare ClickUp ad associare le azioni di Gitlab alle attività di ClickUp.

Per motivi di sicurezza, richiediamo che tutte le integrazioni GitLab che utilizzano un'istanza GitLab auto-ospitata abbiano un Dominio di Primo Livello (TLD). L'URL non può avere un numero di porta aggiunto. Non consentiamo indirizzi IP o domini che non sono riconosciuti come un Dominio di Primo Livello. Un esempio di URL valido sarebbe https://gitlab.clickup.com.

Passaggio 2: Aggiungere i repository personali a ClickUp

Più persone possono autorizzare Gitlab all'interno della tua area di lavoro. Puoi personalizzare quali repository sono condivisi con la tua area di lavoro, consentendoti di autorizzare il tuo account personale senza allegare tutti i tuoi repository.

Collegare un repository non consente agli utenti di accedere al codice sorgente del tuo repository. Consente agli utenti di allegare elementi storici a quel repository agli spazi specificati. 

Per aggiungere un repository a ClickUp:

1. Dal Centro App, seleziona GitLab.
2. Fai clic su Gestisci.
3. I repository sono elencati nella sezione I miei repository su Gitlab.
4. A destra del repository che vuoi aggiungere, clicca su + Aggiungi a ClickUp.

Passaggio 3: seleziona quali spazi sono collegati ai tuoi repository 

I repository aggiunti sono elencati nella sezione dei repository Gitlab aggiunti a ClickUp in basso a destra.

Per collegare un repository a uno spazio di ClickUp, clicca sull'elenco a discesa a destra del nome del repository e seleziona uno o più spazi.

Il repository deve essere associato a uno Spazio prima che tu possa collegare elementi di GitLab alle attività.

Associa automaticamente le attività di GitLab in ClickUp 

ClickUp può associare automaticamente le nuove attività di GitLab con le attività.

Per fare ciò, aggiungi un ID attività di ClickUp ID attività in qualsiasi parte del titolo della richiesta di unione, del nome del ramo o del messaggio di commit in uno di questi formati:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Ad esempio:

#1abc2de

CU-1abc2de

prefisso-1

#prefisso-1

Associare manualmente i commit di GitLab

Per associare manualmente un commit di Gitlab a un'attività di ClickUp:

1. Apri un'attività e clicca sull'icona GitLab.
2. Clicca sulla scheda Commit.
3. Utilizza il menu a discesa accanto a Nuova richiesta di unione per selezionare un repository.
4. Usa l'elenco a discesa Seleziona ramo per selezionare un ramo.
5. Allega il tuo commit.

Associazione manuale dei branch di GitLab

Per associare manualmente un ramo GitLab:

1. Apri un'attività e clicca sull'icona GitLab.
2. Clicca sulla scheda Rami.
3. Utilizza il menu a discesa accanto a Nuova richiesta di unione per selezionare un repository.
4. Usa l'elenco a discesa Seleziona ramo per allegare un ramo.

Cambia automaticamente gli stati delle attività da GitLab 

Puoi modificare lo stato di un'attività da un commit, da un problema o da un richiedere:

1. Aggiungi l'ID della tarefa ClickUp a qualsiasi parte del messaggio di commit e includi lo status desiderato tra parentesi quadre.
   • Ad esempio: #u7hu[fase]
     

     Tutti i formati elencati nella sezione Associa automaticamente l'attività di GitLab in ClickUp di questo articolo possono essere utilizzati. Per garantire una corretta formattazione, non aggiungere uno spazio tra l'ID attività e le informazioni sullo stato.

2. Lo stato dell'attività cambierà.

Crea nuovi branch da ClickUp

Crea nuovi rami utilizzando azioni rapide in ClickUp:

1. Apri un'attività e clicca sull'icona GitLab.
2. A sinistra, ci sono diverse opzioni di copia rapida auto-generate. Se preferisci creare un nuovo ramo direttamente in GitLab, clicca su Crea Ramo nell'angolo in basso a sinistra della finestra modale.

Personalizza i nomi dei rami generati automaticamente

Puoi personalizzare la formattazione dei nomi dei rami generati automaticamente e utilizzati nelle azioni rapide:

1. Dall'App Center, seleziona GitLab.
2. Sotto Formato dei nomi di ramo auto-generati, apporta modifiche.
3. In basso a destra, clicca su Salva.

Creare richieste di unione da ClickUp

Crea o collega richieste di unione da ClickUp.

Per creare una nuova richiesta di unione:

1. Apri un'attività e clicca sull'icona GitLab.
2. Nell'angolo in basso a sinistra della finestra modale, clicca su Nuova richiesta di unione.
3. Utilizza il titolo predefinito per la richiesta di unione o creane uno tuo.
4. Seleziona un repository, un ramo sorgente e un ramo di destinazione.
5. Inserisci una descrizione.
6. Crea la richiesta di unione cliccando su Nuova richiesta di unione.

Una volta che crei o unisci una richiesta in ClickUp, un link alla tarefa ClickUp associata viene automaticamente aggiunto alla richiesta di unione in GitLab.

Dopo che una richiesta di unione è stata collegata, puoi vedere chi l'ha aperta, il revisore, lo stato CI/CD e lo stato della richiesta di unione direttamente dalla tarefa ClickUp collegata.

Rimuovi l'integrazione con GitLab

Solo i titolari dell'area di lavoro e gli amministratori possono rimuovere l'integrazione con GitLab.

Per rimuovere l'integrazione con GitLab:

1. Dall'App Center, seleziona GitLab.
2. Nell'angolo in basso a destra, clicca su Rimuovi Gitlab.

Risolvi i problemi dell'integrazione

Leggi il nostro articolo sulla risoluzione dei problemi di Gitlab o contatta il supporto clienti di Gitlab qui.