Suppression d’exécuteurs auto-hébergés

Vous pouvez supprimer définitivement un exécuteur autohébergé d’un dépôt ou d’une organisation.

Dans cet article

Suppression d’un exécuteur d’un dépôt

Remarques :

  • Cette procédure supprime définitivement l’exécuteur auto-hébergé. Si vous souhaitez seulement empêcher temporairement l’attribution de travaux à un exécuteur, vous pouvez soit arrêter la machine, soit arrêter l’application run. L’exécuteur reste attribué à l’état « Hors connexion » et n’exécute aucun travail tant que vous n’avez pas redémarré l’exécuteur à l’aide de l’application run.
  • Un exécuteur auto-hébergé est automatiquement supprimé de GitHub s’il ne s’est pas connecté à GitHub Actions depuis plus de 14 jours. Un exécuteur auto-hébergé éphémère est automatiquement supprimé de GitHub s’il n’a pas été connecté à GitHub Actions depuis plus de 1 jour.
  • Les exécuteurs juste-à-temps (JIT) ne peuvent exécuter qu’un seul travail. Si les exécuteurs JIT n’exécutent jamais de travail, ils sont automatiquement supprimés. Pour supprimer un exécuteur JIT avant la suppression automatique, vous devez supprimer l’exécuteur JIT sur GitHub.

Pour supprimer un exécuteur auto-hébergé d’un dépôt utilisateur, vous devez être propriétaire du dépôt. Les propriétaires d’organisation peuvent supprimer un exécuteur d’un référentiel dans l’organisation.

Nous vous recommandons également d’avoir accès à la machine de l’exécuteur auto-hébergé.

Pour obtenir des informations sur la façon de supprimer un exécuteur auto-hébergé avec l’API REST, consultez « Points de terminaison d’API REST pour les exécuteurs auto-hébergés ».

Par ailleurs, si vous n’avez pas accès au référentiel ou à l’organisation sur GitHub pour supprimer un exécuteur, mais que vous voulez réutiliser l’ordinateur de l’exécuteur, vous pouvez supprimer le fichier .runner à l’intérieur du répertoire d’application de l’exécuteur autohébergé (c’est-à-dire le répertoire dans lequel vous avez téléchargé et décompressé le logiciel d’exécuteur). Ainsi, l’exécuteur peut être inscrit sans avoir à retélécharger l’application de l’exécuteur auto-hébergée.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre dépôt, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.

  4. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.

  5. Cliquez sur Supprimer.

  6. Vous verrez des instructions pour supprimer l’exécuteur auto-hébergé. Effectuez l’une des étapes suivantes pour supprimer l’exécuteur, s’il est toujours accessible :

    • Si vous avez accès à la machine de l’exécuteur : Suivez les instructions à l’écran pour que le système d’exploitation de votre machine exécute la commande de suppression. Les instructions incluent l’URL nécessaire et un jeton généré automatiquement à durée limitée.

      La commande de suppression exécute les tâches suivantes :

      • Elle supprime l’exécuteur de GitHub.
      • Elle supprime tout fichier de configuration d’application d’exécuteur auto-hébergé sur la machine.
      • Elle supprime tous les services configurés s’ils ne s’exécutent pas en mode interactif.

    • Si vous n’avez pas accès à la machine : Cliquez sur Forcer la suppression de cet exécuteur pour forcer GitHub à supprimer l’exécuteur.

Suppression d’un exécuteur d’une organisation

Remarques :

  • Cette procédure supprime définitivement l’exécuteur auto-hébergé. Si vous souhaitez seulement empêcher temporairement l’attribution de travaux à un exécuteur, vous pouvez soit arrêter la machine, soit arrêter l’application run. L’exécuteur reste attribué à l’état « Hors connexion » et n’exécute aucun travail tant que vous n’avez pas redémarré l’exécuteur à l’aide de l’application run.
  • Un exécuteur auto-hébergé est automatiquement supprimé de GitHub s’il ne s’est pas connecté à GitHub Actions depuis plus de 14 jours. Un exécuteur auto-hébergé éphémère est automatiquement supprimé de GitHub s’il n’a pas été connecté à GitHub Actions depuis plus de 1 jour.
  • Les exécuteurs juste-à-temps (JIT) ne peuvent exécuter qu’un seul travail. Si les exécuteurs JIT n’exécutent jamais de travail, ils sont automatiquement supprimés. Pour supprimer un exécuteur JIT avant la suppression automatique, vous devez supprimer l’exécuteur JIT sur GitHub.

Pour supprimer un exécuteur auto-hébergé d’une organisation, vous devez être un propriétaire d’organisation. Nous vous recommandons également d’avoir accès à la machine de l’exécuteur auto-hébergé. Pour obtenir des informations sur la façon de supprimer un exécuteur auto-hébergé avec l’API REST, consultez « Points de terminaison d’API REST pour les exécuteurs auto-hébergés ».

Par ailleurs, si vous n’avez pas accès au référentiel ou à l’organisation sur GitHub pour supprimer un exécuteur, mais que vous voulez réutiliser l’ordinateur de l’exécuteur, vous pouvez supprimer le fichier .runner à l’intérieur du répertoire d’application de l’exécuteur autohébergé (c’est-à-dire le répertoire dans lequel vous avez téléchargé et décompressé le logiciel d’exécuteur). Ainsi, l’exécuteur peut être inscrit sans avoir à retélécharger l’application de l’exécuteur auto-hébergée.

  1. Sur GitHub, accédez à la page principale de l’organisation.

  2. Sous le nom de votre organisation, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

  3. Dans la barre latérale gauche, cliquez sur Actions, puis sur Exécuteurs.

  4. Dans la liste des exécuteurs, cliquez sur le nom de celui que vous souhaitez configurer.

  5. Cliquez sur Supprimer.

  6. Vous verrez des instructions pour supprimer l’exécuteur auto-hébergé. Effectuez l’une des étapes suivantes pour supprimer l’exécuteur, s’il est toujours accessible :

    • Si vous avez accès à la machine de l’exécuteur : Suivez les instructions à l’écran pour que le système d’exploitation de votre machine exécute la commande de suppression. Les instructions incluent l’URL nécessaire et un jeton généré automatiquement à durée limitée.

      La commande de suppression exécute les tâches suivantes :

      • Elle supprime l’exécuteur de GitHub.
      • Elle supprime tout fichier de configuration d’application d’exécuteur auto-hébergé sur la machine.
      • Elle supprime tous les services configurés s’ils ne s’exécutent pas en mode interactif.

    • Si vous n’avez pas accès à la machine : Cliquez sur Forcer la suppression de cet exécuteur pour forcer GitHub à supprimer l’exécuteur.

Suppression d’un exécuteur d’une entreprise

Si vous utilisez GitHub Enterprise Cloud, vous pouvez également supprimer des exécuteurs d’une entreprise. Pour plus d’informations, consultez la documentation GitHub Enterprise Cloud.