Intégrez les validations, les branches et les demandes de fusion de GitLab avec les tâches ClickUp. Cela vous permet de : 

• Consultez toute l'activité GitLab liée à une tâche dans ClickUp. 
• Vous pouvez choisir de recevoir des notifications ClickUp lorsque de nouveaux éléments d'activité GitLab sont ajoutés aux tâches.
• Attachez automatiquement ou manuellement l'activité GitLab aux tâches ClickUp. 
• Changez automatiquement les statuts avec des actions GitLab en ajoutant l'identifiant de tâche ClickUp à vos validations en utilisant ce format : #{taskID}[statut].
  • Exemple : #1abc2de[fermé]

Ce dont vous aurez besoin

• L'intégration GitLab est disponible sur chaque forfait ClickUp.
• Seuls les propriétaires et administrateurs de l'environnement de travail peuvent configurer des intégrations.
• Les invités ne peuvent pas utiliser l'intégration GitLab.
• L'intégration de GitLab fonctionne avec les versions sur site et auto-hébergées de GitLab.

Étape 1 : Autoriser GitLab

Connectez et autorisez GitLab depuis ClickUp :

1. Dans le coin supérieur droit, cliquez sur le menu d'actions rapides.
2. Cliquez sur Centre d'applications.
3. Depuis la barre latérale du Centre d'applications, sélectionnez Développement.
4. Cliquez sur GitLab.
5. Sélectionnez Connecter.
6. Connectez-vous à votre compte GitLab.

Autorisez avec gitlab.com ou GitLab auto-hébergé

Une fois votre compte GitLab connecté, vous pouvez choisir de vous authentifier via gitlab.com ou via un GitLab auto-hébergé.

En utilisant gitlab.com :

1. Sur la page du Centre d'applications GitLab, cliquez sur Gérer.
2. Cliquez sur + Ajouter Gitlab.
3. Sélectionnez Non, j’utilise GitLab.com.
4. Cliquez sur Lier Gitlab.
5. Cliquez sur Autoriser. Vous devez autoriser ClickUp à associer l'activité GitLab avec les tâches ClickUp.

Utilisation de GitLab auto-hébergé :

1. Sur la page du Centre d'applications GitLab, cliquez sur Gérer.
2. Cliquez sur + Ajouter Gitlab.
3. Sélectionnez Oui, j'utilise une version hébergée de Gitlab.
4. collez votre GitLab URL dans le champ de texte Host URL .
   • Exemple d'URL : https://gitlab.mydomain.com/
5. Suivez les instructions pour trouver, copier et coller votre jeton d'accès personnel dans le champ de texte Jeton d'accès.
   

   Si votre équipe est derrière un pare-feu, incluez votre adresse IP statique dans la liste des autorisations de votre pare-feu avant l'intégration. Cette adresse IP statique sera affichée à cette étape.

6. Cliquez sur Lier Gitlab.
7. Cliquez sur Autoriser. Vous devez autoriser ClickUp à associer l'activité GitLab avec les tâches ClickUp.

Pour des raisons de sécurité, nous exigeons que toutes les intégrations GitLab utilisant une instance GitLab auto-hébergée possèdent un Domaine de Premier Niveau (TLD). L'URL ne peut pas comporter de numéro de port ajouté. Nous n'autorisons pas les adresses IP ou les domaines non reconnus comme un domaine de premier niveau. Un exemple d'URL valide serait https://gitlab.clickup.com.

Étape 2 : Ajouter des référentiels personnels à ClickUp

Plusieurs personnes peuvent autoriser GitLab au sein de votre environnement de travail. Vous pouvez personnaliser les référentiels partagés avec votre environnement de travail, ce qui vous permet d'autoriser votre compte personnel sans avoir à associer tous vos référentiels.

Lier un référentiel ne donne pas aux utilisateurs l'accès à la base de code de votre référentiel. Cela permet aux utilisateurs de joindre des éléments d'historique de ce référentiel aux Espaces que vous spécifiez. 

Pour ajouter un référentiel à ClickUp :

1. Depuis le Centre d'applications, sélectionnez GitLab.
2. Cliquez sur Gérer.
3. Les référentiels sont listés dans la section Mes référentiels de Gitlab.
4. À droite du référentiel que vous souhaitez ajouter, cliquez sur + Ajouter à ClickUp.

Étape 3 : Sélectionnez quels Espaces sont associés à vos référentiels 

Les référentiels ajoutés sont répertoriés dans la section GitLab référentiels ajoutés à ClickUp en bas à droite.

Pour rattacher un référentiel à un espace ClickUp , cliquez sur le menu déroulant à droite du nom du référentiel et sélectionnez un ou plusieurs Espaces.

Le référentiel doit être rattaché à un espace avant de pouvoir rattacher GitLab élément à une tâche.

Associez automatiquement l'activité GitLab dans ClickUp. 

ClickUp peut automatiquement associer les nouvelles activités GitLab aux tâches.

Pour ce faire, ajoutez un identifiant de tâche ClickUp ID de tâche dans n'importe quelle partie du titre de la demande de fusion, du nom de la branche ou du message de validation dans l'un de ces formats :

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Par exemple :

#1abc2de

CU-1abc2de

préfixe-1

#prefix-1

Associer manuellement des validations GitLab

Pour associer manuellement un commit GitLab à une tâche ClickUp :

1. Ouvrez une tâche et cliquez sur l'icône GitLab.
2. Cliquez sur l'onglet Validations.
3. Utilisez le menu déroulant à côté de Nouvelle demande de fusion pour sélectionner un référentiel.
4. Utilisez le menu déroulant Sélectionner la branche pour choisir une branche.
5. Joignez votre validation.

Associez manuellement des branches GitLab

Pour associer manuellement une branche GitLab :

1. Ouvrez une tâche et cliquez sur l'icône GitLab.
2. Cliquez sur l'onglet Branche.
3. Utilisez le menu déroulant à côté de Nouvelle demande de fusion pour sélectionner un référentiel.
4. Utilisez le menu déroulant Sélectionner la branche pour attacher une branche.

Changez automatiquement les statuts des tâches depuis GitLab 

Vous pouvez modifier le statut d’une tâche à partir d’une validation, d’un problème ou d’une demande de fusion :

1. Ajoutez l'identifiant de tâche ClickUp à n'importe quelle partie du message de validation et incluez le statut que vous souhaitez entre crochets.
   • Par exemple: #u7hu[staged]
     

     Tous les formats mentionnés dans la section Associer automatiquement l'activité GitLab dans ClickUp de cet article peuvent être utilisés. Pour garantir un formatage approprié, ne rajoutez pas d'espace entre l'identifiant de tâche et les informations de statut.

2. Le statut de la tâche changera.

Créez de nouvelles branches depuis ClickUp

Créez de nouvelles branches en utilisant les actions rapides dans ClickUp :

1. Ouvrez une tâche et cliquez sur l'icône GitLab.
2. À gauche, vous trouverez plusieurs options de copie rapide générées automatiquement. Si vous préférez créer une nouvelle branche directement dans GitLab, cliquez sur Créer une branche dans le coin inférieur gauche du modal.

Personnalisez les noms de branches générés automatiquement

Vous pouvez personnaliser le formatage des noms de branches générés automatiquement utilisés dans les actions rapides :

1. Depuis le Centre d’applications, sélectionnez GitLab.
2. Sous Format des noms de branches auto-générés, apportez des modifications.
3. En bas à droite, cliquez sur Enregistrer.

Créez des demandes de fusion depuis ClickUp

Créez ou liez des demandes de fusion depuis ClickUp.

Pour créer une nouvelle demande de fusion :

1. Ouvrez une tâche et cliquez sur l'icône GitLab.
2. Dans le coin inférieur gauche du modal, cliquez sur Nouvelle demande de fusion.
3. Utilisez le titre de demande de fusion prédéfini ou créez le vôtre.
4. Sélectionnez un référentiel, une branche source et une branche cible.
5. Entrez une description.
6. Créez la demande de fusion en cliquant sur Nouvelle demande de fusion.

Une fois que vous créez ou fusionnez une demande dans ClickUp, un lien vers la tâche ClickUp associée est automatiquement ajouté à la demande de fusion dans GitLab.

Après avoir lié une demande de fusion, vous pouvez voir qui l'a ouverte, le réviseur, le statut CI/CD et le statut de la demande de fusion directement depuis la tâche ClickUp associée.

Supprimez l'intégration GitLab

Seuls les propriétaires et les administrateurs de l'environnement de travail peuvent supprimer l'intégration GitLab.

Pour supprimer l'intégration GitLab :

1. Depuis le Centre d’applications, sélectionnez GitLab.
2. Dans le coin inférieur droit, cliquez sur Supprimer Gitlab.

Résoudre les problèmes liés à l'intégration

Consultez notre article de dépannage GitLab ou contactez le service client de GitLab ici.