セルフホストランナーを削除する

メモ

GitHub ホステッドランナーは、現在 GitHub Enterprise Server ではサポートされていません。

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

メモ

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

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

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

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

また、GitHub 上のリポジトリ、organization、または Enterprise に対してランナーを削除するアクセス権がないものの、ランナーマシンを再利用する場合は、セルフホステッドランナーアプリケーションディレクトリ (つまり、ランナーソフトウェアをダウンロードして展開したディレクトリ) 内の .runner ファイルを削除できます。そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。1. GitHub で、リポジトリのメインページに移動します。1. リポジトリ名の下にある [Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。

タブを示すリポジトリヘッダーのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で強調表示されています。 1. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。1. ランナーの一覧で、構成するランナーの名前をクリックします。1. [削除] をクリックします。

セルフホストランナーの削除手順が表示されます。ランナーがアクセスできる状態にあるかによって、ランナーを削除するための以下のステップのいずれかを実行してください。
- ランナーマシンにアクセスできる場合: マシンのオペレーティングシステムの画面上の指示に従い、削除コマンドを実行してください。この指示には、必須のURLと自動的に生成された期間限定のトークンが含まれます。
  
  この削除コマンドは、以下のタスクを実行します。
  - GitHub からランナーを削除する。
  - マシン上のセルフホストランナーアプリケーションの設定ファイルの削除。
  - インタラクティブモードで動作していないのであれば設定されているサービスの削除。
- マシンにアクセスできない場合: [Force remove this runner] をクリックして、GitHub でこのランナーを強制的に削除するようにします。

組織からのランナーの削除

メモ

この手順は、セルフホストランナーを恒久的に削除します。一時的にランナーへのジョブの割り当てを停止するだけなら、そのマシンをシャットダウンするか、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 の役割の詳細については、「カスタム組織ロールの権限」を参照してください。

また、GitHub 上のリポジトリ、organization、または Enterprise に対してランナーを削除するアクセス権がないものの、ランナーマシンを再利用する場合は、セルフホステッドランナーアプリケーションディレクトリ (つまり、ランナーソフトウェアをダウンロードして展開したディレクトリ) 内の .runner ファイルを削除できます。そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。1. GitHub で、organization のメインページに移動します。1. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。

1. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。1. ランナーの一覧で、構成するランナーの名前をクリックします。1. [削除] をクリックします。

セルフホストランナーの削除手順が表示されます。ランナーがアクセスできる状態にあるかによって、ランナーを削除するための以下のステップのいずれかを実行してください。
- ランナーマシンにアクセスできる場合: マシンのオペレーティングシステムの画面上の指示に従い、削除コマンドを実行してください。この指示には、必須のURLと自動的に生成された期間限定のトークンが含まれます。
  
  この削除コマンドは、以下のタスクを実行します。
  - GitHub からランナーを削除する。
  - マシン上のセルフホストランナーアプリケーションの設定ファイルの削除。
  - インタラクティブモードで動作していないのであれば設定されているサービスの削除。
- マシンにアクセスできない場合: [Force remove this runner] をクリックして、GitHub でこのランナーを強制的に削除するようにします。

この記事で

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

組織からのランナーの削除

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