Voyez vos déploiements à côté de vos moniteurs

Voyez vos déploiements juste à côté de vos moniteurs et serveurs, pour repérer instantanément si une release a causé un incident — fini la comparaison d’horodatages dans GitHub. Ceci s’adresse à toute personne utilisant GitHub pour déployer et souhaitant plus de contexte quand quelque chose ne va pas.

Aperçu

• Associez un dépôt GitHub aux moniteurs, serveurs ou tags qu’il concerne.
• Chaque déploiement de ce dépôt apparaît alors sur l’incident correspondant (s’il a eu lieu dans l’heure précédente) et comme repère sur les graphiques de temps de réponse et de serveur.
• Un déploiement ne fait qu’ajouter de l’information — il ne modifie jamais le statut, la disponibilité ou les incidents d’un moniteur.

Avant de commencer

• Connectez GitHub via l’app InfraNest Automations. Une connexion par jeton ne reçoit pas les déploiements.

• Déterminez ce qui compte comme un déploiement pour votre dépôt. Vous choisirez l’une de ces options lors de l’association :

  • Un déploiement GitHub — votre job de déploiement utilise un environnement GitHub (par exemple, environment: production), donc GitHub enregistre chaque déploiement de lui-même.
  • Un workflow terminé — vous déployez via un workflow GitHub Actions qui n’utilise pas d’environnement. Choisissez ce workflow, et chaque fin d’exécution compte comme un déploiement.
  • Une release publiée — la publication d’une release sur GitHub est votre méthode de livraison.

  Vous n’êtes pas sûr ? Choisissez Un déploiement GitHub. Si aucun n’est trouvé, le formulaire vous le signalera et proposera Un workflow terminé à la place.

Associer un dépôt

1. Allez dans Integrations et ouvrez GitHub.
2. Allez dans Connections & settings, trouvez Les déploiements à côté de vos moniteurs et cliquez sur Link a repository. Une fois qu’un dépôt est associé, cliquez sur Gérer à cet endroit pour voir vos associations et en ajouter d’autres.
3. Sous Repository, choisissez le dépôt. Les dépôts sont regroupés par propriétaire, et ceux qui ont déjà déployé apparaissent en premier.
4. Sous Ce qui compte comme un déploiement, choisissez l’une des trois options ci-dessus.
   • Pour Un déploiement GitHub, choisissez sous Quels déploiements si tous les déploiements comptent, ou Seulement les déploiements vers un environnement, comme production, afin que les déploiements de test n’apparaissent pas.
   • Pour Un workflow terminé, choisissez le Workflow, et si vous le souhaitez, une branche comme main. Une exécution échouée s’affiche comme un déploiement échoué.
5. Sous Shown on, choisissez Choisissez un moniteur, un serveur ou un tag.
6. Cliquez sur Link.

Si nous ne trouvons aucun déploiement pour le dépôt sur GitHub, le formulaire vous le signale avant l’association. Consultez la section Avant de commencer ci-dessus pour savoir ce dont votre déploiement a besoin.

Lorsque vous associez un dépôt, InfraNest récupère aussi ses déploiements précédents depuis GitHub, afin que vos graphiques ne démarrent pas vides. Cela prend quelques secondes.

Chaque association affiche ensuite l’un des états suivants :

• dernier déploiement {ago} — tout fonctionne.
• recherche des déploiements précédents… — récupération en cours. Actualisez la page dans un instant.
• aucun déploiement trouvé sur GitHub — GitHub n’a jamais eu de déploiement pour ce dépôt. Consultez la section Avant de commencer ci-dessus.
• aucun déploiement reçu pour le moment — tout est configuré, il n’y a simplement pas encore eu de déploiement.

Associer un dépôt depuis un moniteur

Vous pouvez aussi associer un dépôt depuis le moniteur lui-même :

1. Ouvrez le moniteur et allez dans son onglet Paramètres.
2. Dans la carte GitHub deploys, cliquez sur Link a repository.
3. Choisissez le Repository et Ce qui compte comme un déploiement, puis cliquez sur Link. Il n’y a pas de choix Shown on ici : les déploiements s’affichent sur ce moniteur.

La carte liste les dépôts associés à ce moniteur, chacun avec l’heure de son dernier déploiement et un bouton pour le retirer. Elle ne s’affiche qu’une fois GitHub connecté via l’app InfraNest Automations. Les dépôts associés via l’un des tags du moniteur n’y sont pas listés — gérez-les depuis la page GitHub, que Gérer dans GitHub ouvre.

NoteAssocier un tag couvre tout ce qui porte ce tag, y compris les moniteurs et serveurs que vous taguez ultérieurement.

Vous pouvez associer le même dépôt plusieurs fois — par exemple, à un moniteur et à un serveur. Pour arrêter d’afficher les déploiements d’un dépôt quelque part, retirez son association depuis la même liste, ou depuis la carte GitHub deploys du moniteur.

Voir les déploiements sur un incident ou un graphique

1. Sur un incident : ouvrez l’incident depuis la page Incidents ou depuis la page du moniteur. Les déploiements de l’heure précédant son début sont listés en haut de sa chronologie, avec un lien vers le déploiement sur GitHub et les pull requests qu’il a mises en production, afin que vous puissiez voir immédiatement ce qui a changé. Un déploiement échoué est également affiché, et signalé comme tel.
2. Sur les graphiques : chaque déploiement apparaît comme une ligne verticale en pointillés avec un petit drapeau. Survolez-la pour voir le commit, l’environnement, qui a déployé, et ce qu’il contenait — par exemple, Contient #12, #14 · 3 commits. Cliquez dessus pour ouvrir le déploiement sur GitHub.
3. Les déploiements compris dans la période du graphique sont aussi listés sous celui-ci, avec les dépôts dont ils proviennent et un lien Gérer vers vos associations. Si rien n’est encore associé, le graphique propose Link a repository à la place.

TipAvec PagerDuty connecté, un déploiement associé apparaît aussi sous Recent changes sur l’incident PagerDuty.

Bon à savoir

• Les déploiements apparaissent dès que GitHub les signale. Les déploiements précédents sont récupérés lors de l’association du dépôt, aussi loin que votre forfait conserve l’historique de surveillance.
• Les déploiements sont conservés aussi longtemps que votre forfait conserve l’historique de surveillance.
• Seuls les déploiements terminés sont affichés : réussis, échoués ou en erreur. Les déploiements encore en cours ne le sont pas.
• Le contenu d’un déploiement est déterminé en le comparant au déploiement réussi précédent vers le même endroit. Le premier déploiement que nous connaissons n’a encore rien avec quoi se comparer, et l’indique.

Dépannage

• L’association indique « aucun déploiement trouvé sur GitHub ». Votre déploiement n’indique pas à GitHub qu’il a eu lieu. Donnez à votre job de déploiement un environnement (par exemple, environment: production), ou retirez l’association et réassociez le dépôt avec Un workflow terminé et votre workflow de déploiement.
• Aucun déploiement n’apparaît, et l’association indique « aucun déploiement reçu pour le moment ». Vérifiez que GitHub est connecté via l’app InfraNest Automations plutôt que par un jeton.
• Les déploiements apparaissent pour le mauvais environnement. Retirez l’association et réassociez le dépôt, en choisissant Seulement les déploiements vers un environnement et l’environnement souhaité.