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

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

Dans cet article

Remarque : Les exécuteurs hébergés sur GitHub ne sont pas pris en charge sur GitHub Enterprise Server. Vous pouvez voir plus d’informations sur le support futur planifié dans la GitHub public roadmap.

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 Enterprise Server 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 Enterprise Server 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 et les utilisateurs disposant de l’autorisation « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs » peuvent supprimer un exécuteur d’un référentiel dans l’organisation. Pour plus d’informations sur les rôles d’organisation personnalisés, consultez « À propos des rôles d'organisation personnalisés ».

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, à l’organisation ou à l’entreprise sur GitHub Enterprise Server 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 Enterprise Server.
      • 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 Enterprise Server à 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 Enterprise Server 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 Enterprise Server 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 ou disposer de l’autorisation « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs ». 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 ».

Pour plus d’informations sur les rôles d’organisation personnalisés, consultez « À propos des rôles d'organisation personnalisés ».

Par ailleurs, si vous n’avez pas accès au référentiel, à l’organisation ou à l’entreprise sur GitHub Enterprise Server 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 Enterprise Server.
      • 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 Enterprise Server à supprimer l’exécuteur.

Suppression d’un exécuteur d’une entreprise

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 Enterprise Server 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 Enterprise Server 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 entreprise, vous devez être propriétaire de l’entreprise. 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 les points de terminaison de l’entreprise dans l’API REST GitHub Actions.

Par ailleurs, si vous n’avez pas accès au référentiel, à l’organisation ou à l’entreprise sur GitHub Enterprise Server 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. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.

    Capture d’écran du menu déroulant qui s’affiche lorsque vous cliquez sur la photo de profil sur GitHub Enterprise Server. L’option « Paramètres d’entreprise » est mise en évidence avec un contour orange foncé.

  2. Sur le côté gauche de la page, dans la barre latérale du compte d’entreprise, cliquez sur Stratégies.

  3. Sous « Stratégies  », cliquez sur Actions.

  4. Cliquez sur l’onglet Exécuteurs.

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

  6. Cliquez sur Supprimer.

  7. 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 Enterprise Server.
      • 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 Enterprise Server à supprimer l’exécuteur.