Utilisez-vous notre intégration GitHub pour synchroniser le travail entre GitHub et ClickUp ? Ajoutez des automatisations GitHub pour construire un flux de travail efficace. Les équipes de développement peuvent réduire le changement de contexte en utilisant des Automatisations pour maintenir tout à jour.
Ce dont vous aurez besoin
- Les intégrations d’automatisations sont disponibles avec les forfaits Business et supérieurs.
- L'administrateur ou le propriétaire de l'environnement de travail doit activer le ClickApp Automatisation.
- Vous avez besoin des permissions administrateur sur le référentiel GitHub pour configurer les automatisations.
-
Invités et membres limités ne peuvent pas utiliser l'intégration GitHub.
Ajoutez une automatisation GitHub dans ClickUp
Pour configurer une automatisation GitHub à partir d'une liste, d'un dossier ou d'un espace :
-
- Cliquez sur le bouton Automatiser ou sur l'icône en forme d'éclair.
- Cliquez sur Créer une automatisation:
- Sélectionnez un déclencheur ou une Action GitHub.
- Ou, depuis la barre latérale gauche, cliquez sur GitHub et sélectionnez un modèle d'automatisation.
- Configurez votre Déclencheur, vos Conditions et vos Actions.
- Sélectionnez ou connectez votre compte GitHub.
- Entrez votre nom d'utilisateur GitHub et cliquez sur Connecter le compte, puis autorisez ClickUp.
- Ou, cliquez sur Créer un compte pour créer un nouveau compte sur GitHub.com.
- Pour mettre à jour un compte GitHub précédemment autorisé, vous devez le supprimer et le réajouter.
- La suppression d'un compte n'impactera pas les Automatisations existantes utilisant ce compte. Vous devrez le rajouter pour créer des automatisations GitHub à l'avenir.
- Spécifiez qui peut utiliser votre compte GitHub pour créer des Automatisations.
- Chaque automatisation GitHub vous permet de choisir un référentiel (repo) spécifique.
- Sélectionnez ou connectez votre compte GitHub.
-
Cliquez sur Créer.
Automatisations GitHub
Les Automatisations GitHub utilisent la même structure que les Automatisations dans ClickUp.
Chaque automatisation se compose d’un déclencheur et d’une action. Les utilisateurs du forfait Business et supérieurs ont la possibilité d'utiliser des Conditions.
Déclencheurs GitHub
Lorsque les événements suivants se produisent dans le référentiel GitHub spécifié, et que les conditions sont remplies, l'Automatisation s'exécutera et effectuera une Action.
- Demande de fusion acceptée
- Branche fusionnée
- À la validation
- Revue de demande de tirage créée
- Mise à jour de la demande de fusion
- Le statut de CI/CD a changé
- Demande de tirage liée
- Branche liée
- Validation liée
Conditions GitHub
GitHub Automatisation liée à la demande de tirage assistance à une ou plusieurs conditions.
Par exemple, vous pouvez mettre à jour le statut de la tâche lorsqu'une demande de tirage vers la branche principale est liée. Ou définissez la priorité de la tâche comme urgente et commentez lorsqu'une demande de tirage avec l'étiquette hotfix est fusionnée dans la branche QA .
Des conditions peuvent être définies pour plusieurs combinaisons d'étiquettes de demande de tirage, de référence de base et de valeurs de référence de tête.
Logique conditionnelle
Vous pouvez utiliser la logique de Condition suivante :
- est l’une des personnes suivantes : La demande de tirage comprend au moins l’un des éléments suivants : libellé ou branche indiqué.
- est tout ce qui suit : La demande de tirage inclut toutes les étiquettes ou branches spécifiées.
- n'est aucun des suivants : La demande de tirage n'inclut aucune des étiquettes ou branches spécifiées.
- n'inclut pas tout ce qui suit : La demande de tirage n'inclut pas toutes les étiquettes ou branches spécifiées.
Pour le diffamation, vous pouvez utiliser la logique indiquée ci-dessus et :
- est défini : Au moins une étiquette a été appliquée à la demande de tirage.
- n'est pas défini : Aucune étiquette n'a été appliquée à la demande de tirage.
Ajouter une condition
Pour ajouter une condition à votre automatisation GitHub :
- À partir d’une automatisation, sous la section déclencheur, cliquez sur Ajouter condition.
- Sélectionnez à quoi la condition doit s'appliquer :
- Githublabelcondition : libellé appliqué à la demande de tirage.
- Réf. principale : La branche source contenant vos modifications proposées.
- Référence de base : La branche cible où vos modifications seront appliquées.
- Sélectionnez la logique condition .
- Choisissez l'étiquette ou la valeur de branche à utiliser avec cette condition. Les conditions sont sensibles à la casse. Ils doivent correspondre exactement au libellé ou au nom de la branche, sinon ils ne répondront pas aux critères et ne déclencheront pas l'Automatisation.
- Cliquez sur Ajouter un autre pour inclure une étiquette supplémentaire ou une valeur de branche à utiliser.
- Cliquez sur Ajouter une condition pour ajouter plusieurs conditions.
Actions ClickUp
Toutes les actions d’automatisation , à l’exception de notre action webhook , sont disponibles pour mettre à jour la tâche à l’aide GitHub déclencheur.
Pour que les actions d'automatisation soient appliquées aux tâches existantes, la tâche doit déjà être liée au référentiel GitHub en associant une validation, une branche ou une demande de tirage. L'action Créer une tâche est la seule exception, car les nouvelles tâches ne peuvent pas être liées à l'avance.
Actions dans GitHub
Vous pouvez utiliser l’automatisation avec l’action Créer un problème , qui crée un nouveau problème dans GitHub.
Par exemple, lorsqu'un formulaire de bug est soumis et crée une tâche dans une liste spécifique, une automatisation peut créer un problème dans GitHub.