Automatiser avec GitHub

Cet article s’adresse aux utilisateurs InfraNest qui souhaitent que leurs automatisations d’infrastructure réagissent à l’activité de leurs dépôts GitHub, et qu’elles déclenchent automatiquement des actions sur GitHub — sans écrire de code.

Aperçu

• Créez des automatisations qui surveillent ce qui se passe sur GitHub, comme l’échec d’une exécution de workflow ou une nouvelle pull request, et réagissent automatiquement.
• Déclenchez des actions GitHub — comme la création d’une issue ou la fusion d’une pull request — depuis n’importe quelle automatisation dans InfraNest.
• Tout se configure visuellement dans le générateur d’automatisation, à l’aide de déclencheurs et d’actions GitHub.

NoteAvant de pouvoir utiliser des déclencheurs ou des actions GitHub, vous devez connecter votre compte GitHub. Si vous choisissez d’abord un déclencheur GitHub, InfraNest vous rappellera de le connecter.

Connecter GitHub

1. Allez dans Intégrations.
2. Trouvez GitHub et sélectionnez Connecter GitHub.
3. Choisissez Se connecter avec {provider} ou Installer l’app GitHub, puis suivez les instructions pour autoriser l’accès.
4. Une fois connecté, les déclencheurs et actions GitHub apparaîtront regroupés sous GitHub dans le générateur d’automatisation.

Réagir à l’activité GitHub

1. Ouvrez Automatisations et sélectionnez Nouvelle automatisation.
2. Sous Quand ceci arrive, choisissez Sur événement.
3. Choisissez un déclencheur GitHub, par exemple :
   • Exécution de workflow GitHub — démarrée, terminée, échouée ou réussie
   • Issue GitHub ou Commentaire d’issue GitHub — ouverte, fermée, labellisée, assignée ou commentée
   • Push GitHub, Branche/tag GitHub créé ou Branche/tag GitHub supprimé
   • Pull request GitHub ou Review de PR GitHub — ouverte, fusionnée, fermée, approuvée ou modifications demandées
   • Release GitHub — publiée
   • Déploiement GitHub, Statut de déploiement GitHub, Statut de commit GitHub, Check run GitHub ou Check suite GitHub
4. Utilisez Ajouter une condition pour ajouter des filtres Seulement si — par exemple uniquement pour la branche main, un dépôt spécifique, uniquement les échecs, ou uniquement votre compte Organisation plutôt qu’un compte personnel.
5. Commencez à saisir dans le champ Dépôt (owner/repo) pour choisir parmi vos dépôts connectés.

Agir sur GitHub

1. Dans votre automatisation, allez dans Faire ceci et sélectionnez Ajouter une action.
2. Choisissez une action GitHub dans la liste, par exemple :
   • Déclencher un workflow GitHub, Relancer un workflow GitHub, Relancer les jobs échoués, ou Annuler l’exécution GitHub
   • Créer une issue GitHub, Commenter une issue GitHub, Mettre à jour l’issue GitHub, Fermer une issue GitHub, Rouvrir une issue GitHub, Ajouter des labels, Retirer un label, ou Assigner une issue GitHub
   • Fusionner la pull request, ou Demander une review de PR à des personnes ou à une entrée Équipes
   • Créer un déploiement GitHub, Définir le statut du déploiement
   • Créer une release GitHub
   • Définir le statut du commit
3. Remplissez les champs de cette action — par exemple Dépôt (owner/repo), Fichier ou id du workflow, Branche ou tag, Environnement, Labels (séparés par des virgules), Assignés (séparés par des virgules), ou Relecteurs.
4. Pour chaque champ, vous pouvez saisir une valeur directement, choisir une suggestion depuis votre compte GitHub connecté, ou utiliser Insérer une valeur pour récupérer une variable du déclencheur.
5. Sélectionnez à nouveau Ajouter une action pour ajouter d’autres étapes, ou Enregistrer l'automatisation lorsque vous avez terminé.

Exemples

• Échec du renouvellement SSL → Créer une issue GitHub, ajoutez le label infrastructure, et utilisez Assigner une issue GitHub pour l’attribuer à votre équipe DevOps.
• Un moniteur s’est rétabli → Commenter une issue GitHub, puis Fermer une issue GitHub.
• Une pull request a été fusionnée dans main → Lancer un workflow GitHub pour déployer, puis Définir le statut du déploiement.
• Votre contrôle de santé de production a réussi → Définir le statut du commit sur succès.
• Une release a été publiée → Publier une annonce sur la page de statut.

Astuces

• Lorsqu’une action crée quelque chose — comme une issue ou un déploiement — les étapes suivantes de la même automatisation peuvent la réutiliser automatiquement, sans configuration supplémentaire.
• Demander une review à une entrée Équipes nécessite une connexion Organisation, pas un compte personnel.

TipCertaines actions affichent un badge Pro dans le générateur — celles-ci nécessitent un forfait supérieur pour être utilisées.

Résolution des problèmes

• Si un déclencheur GitHub ne se déclenche jamais, vérifiez que GitHub est correctement connecté sous Intégrations, et demandez à votre administrateur de confirmer que l’application est bien abonnée à ce type d’événement.
• Si une automatisation affiche Dernière exécution en échec ou est Désactivée automatiquement après des échecs répétés, ouvrez l’automatisation et consultez l’Historique pour plus de détails, puis utilisez Réessayer ou Réexécuter si nécessaire.