セルフホストランナーの削除

リポジトリ、Organization、または Enterprise から、セルフホステッド ランナーを完全に削除できます。

この記事の内容

リポジトリからのランナーの削除

メモ

  • この手順は、セルフホストランナーを恒久的に削除します。 一時的にランナーへのジョブの割り当てを停止するだけなら、そのマシンをシャットダウンするか、run アプリケーションを停止することができます。 ランナーは "Offline (オフライン)" 状態で割り当て済みのままになり、run アプリケーションを使ってランナーを再起動するまではジョブが実行されません。
  • 14 日以上 GitHub Actions に接続していないセルフホステッド ランナーは、GitHub から自動的に削除されます。 1 日以上 GitHub Actions に接続していないエフェメラル セルフホステッド ランナーは、GitHub から自動的に削除されます。
  • Just-In-Time (JIT) ランナーは、1 つのジョブのみを実行できます。 JIT ランナーがジョブを実行しない場合は、自動的に削除されます。 自動削除の前に JIT ランナーを削除するには、GitHub で JIT ランナーを削除する必要があります。

ユーザリポジトリからセルフホストランナーを削除するには、リポジトリのオーナーでなければなりません。 組織の所有者と[組織ランナーとランナー グループを管理する」アクセス許可を持つユーザーは、組織内のリポジトリからランナーを削除できます。 カスタム organization の役割の詳細については、「カスタム Organization ロールについて」を参照してください。

セルフホストランナーのマシンへもアクセスできるようにしておくことをおすすめします。

REST API を使って自己ホストランナーを削除する方法については、「セルフホステッド ランナーの REST API エンドポイント」を参照してください。

また、GitHub 上のリポジトリ、organization、または Enterprise に対してランナーを削除するアクセス権がないものの、ランナー マシンを再利用する場合は、セルフホステッド ランナー アプリケーション ディレクトリ (つまり、ランナー ソフトウェアをダウンロードして展開したディレクトリ) 内の .runner ファイルを削除できます。 そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. リポジトリ名の下にある [Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    タブを示すリポジトリ ヘッダーのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で強調表示されています。

  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。

  4. ランナーの一覧で、構成するランナーの名前をクリックします。

  5. [削除] をクリックします。

  6. セルフホストランナーの削除手順が表示されます。 ランナーがアクセスできる状態にあるかによって、ランナーを削除するための以下のステップのいずれかを実行してください。

    • ランナー マシンにアクセスできる場合: マシンのオペレーティング システムの画面上の指示に従い、削除コマンドを実行してください。 この指示には、必須のURLと自動的に生成された期間限定のトークンが含まれます。

      この削除コマンドは、以下のタスクを実行します。

      • GitHub からランナーを削除する。
      • マシン上のセルフホストランナーアプリケーションの設定ファイルの削除。
      • インタラクティブモードで動作していないのであれば設定されているサービスの削除。

    • マシンにアクセスできない場合: [Force remove this runner] をクリックして、GitHub でこのランナーを強制的に削除するようにします。

Organizationからのランナーの削除

メモ

  • この手順は、セルフホストランナーを恒久的に削除します。 一時的にランナーへのジョブの割り当てを停止するだけなら、そのマシンをシャットダウンするか、run アプリケーションを停止することができます。 ランナーは "Offline (オフライン)" 状態で割り当て済みのままになり、run アプリケーションを使ってランナーを再起動するまではジョブが実行されません。
  • 14 日以上 GitHub Actions に接続していないセルフホステッド ランナーは、GitHub から自動的に削除されます。 1 日以上 GitHub Actions に接続していないエフェメラル セルフホステッド ランナーは、GitHub から自動的に削除されます。
  • Just-In-Time (JIT) ランナーは、1 つのジョブのみを実行できます。 JIT ランナーがジョブを実行しない場合は、自動的に削除されます。 自動削除の前に JIT ランナーを削除するには、GitHub で JIT ランナーを削除する必要があります。

組織からセルフホストされたランナーを削除するには、組織の所有者であるか、「組織ランナーとランナー グループを管理する」アクセス許可が必要です。 セルフホストランナーのマシンへもアクセスできるようにしておくことをおすすめします。 REST API を使って自己ホストランナーを削除する方法については、「セルフホステッド ランナーの REST API エンドポイント」を参照してください。

カスタム organization の役割の詳細については、「カスタム Organization ロールについて」を参照してください。

また、GitHub 上のリポジトリ、organization、または Enterprise に対してランナーを削除するアクセス権がないものの、ランナー マシンを再利用する場合は、セルフホステッド ランナー アプリケーション ディレクトリ (つまり、ランナー ソフトウェアをダウンロードして展開したディレクトリ) 内の .runner ファイルを削除できます。 そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。

  1. GitHub で、organization のメイン ページに移動します。

  2. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。

  4. ランナーの一覧で、構成するランナーの名前をクリックします。

  5. [削除] をクリックします。

  6. セルフホストランナーの削除手順が表示されます。 ランナーがアクセスできる状態にあるかによって、ランナーを削除するための以下のステップのいずれかを実行してください。

    • ランナー マシンにアクセスできる場合: マシンのオペレーティング システムの画面上の指示に従い、削除コマンドを実行してください。 この指示には、必須のURLと自動的に生成された期間限定のトークンが含まれます。

      この削除コマンドは、以下のタスクを実行します。

      • GitHub からランナーを削除する。
      • マシン上のセルフホストランナーアプリケーションの設定ファイルの削除。
      • インタラクティブモードで動作していないのであれば設定されているサービスの削除。

    • マシンにアクセスできない場合: [Force remove this runner] をクリックして、GitHub でこのランナーを強制的に削除するようにします。

Enterprise からランナーを削除する

メモ

  • この手順は、セルフホストランナーを恒久的に削除します。 一時的にランナーへのジョブの割り当てを停止するだけなら、そのマシンをシャットダウンするか、run アプリケーションを停止することができます。 ランナーは "Offline (オフライン)" 状態で割り当て済みのままになり、run アプリケーションを使ってランナーを再起動するまではジョブが実行されません。
  • 14 日以上 GitHub Actions に接続していないセルフホステッド ランナーは、GitHub から自動的に削除されます。 1 日以上 GitHub Actions に接続していないエフェメラル セルフホステッド ランナーは、GitHub から自動的に削除されます。
  • Just-In-Time (JIT) ランナーは、1 つのジョブのみを実行できます。 JIT ランナーがジョブを実行しない場合は、自動的に削除されます。 自動削除の前に JIT ランナーを削除するには、GitHub で JIT ランナーを削除する必要があります。

セルフホスト ランナーをエンタープライズから削除するには、エンタープライズ所有者である必要があります。 セルフホストランナーのマシンへもアクセスできるようにしておくことをおすすめします。 REST API を使用してセルフホスト ランナーを削除する方法については、GitHub Actions REST API のエンタープライズ エンドポイントを参照してください。

また、GitHub 上のリポジトリ、organization、または Enterprise に対してランナーを削除するアクセス権がないものの、ランナー マシンを再利用する場合は、セルフホステッド ランナー アプリケーション ディレクトリ (つまり、ランナー ソフトウェアをダウンロードして展開したディレクトリ) 内の .runner ファイルを削除できます。 そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。

  1. ページの上部にある [ Policies] をクリックします。

  2. [ Policies] で、[Actions] をクリックします。

  3. [Runners](ランナー) タブをクリックします。

  4. ランナーの一覧で、構成するランナーの名前をクリックします。

  5. [削除] をクリックします。

  6. セルフホストランナーの削除手順が表示されます。 ランナーがアクセスできる状態にあるかによって、ランナーを削除するための以下のステップのいずれかを実行してください。

    • ランナー マシンにアクセスできる場合: マシンのオペレーティング システムの画面上の指示に従い、削除コマンドを実行してください。 この指示には、必須のURLと自動的に生成された期間限定のトークンが含まれます。

      この削除コマンドは、以下のタスクを実行します。

      • GitHub からランナーを削除する。
      • マシン上のセルフホストランナーアプリケーションの設定ファイルの削除。
      • インタラクティブモードで動作していないのであれば設定されているサービスの削除。

    • マシンにアクセスできない場合: [Force remove this runner] をクリックして、GitHub でこのランナーを強制的に削除するようにします。