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

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

この記事の内容

注: GitHub ホステッドランナーは、現在 GitHub Enterprise Server でサポートされていません。 GitHub public roadmap で、今後の計画的なサポートの詳細を確認できます。

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

Note

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

ユーザリポジトリからセルフホストランナーを削除するには、リポジトリのオーナーでなければなりません。組織の所有者を持つユーザーは、組織内のリポジトリからランナーを削除できます。

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

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

あるいは、GitHub Enterprise Server 上のリポジトリ、組織、またはエンタープライズへのランナーの削除のアクセス権がないものの、ランナーマシンを再利用したいのであれば、セルフホストランナーアプリケーションディレクトリ（つまり、ランナーソフトウェアをダウンロードして解凍したディレクトリ）内の .runner ファイルを削除できます。そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。

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

Organizationからのランナーの削除

Note

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

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

あるいは、GitHub Enterprise Server 上のリポジトリ、組織、またはエンタープライズへのランナーの削除のアクセス権がないものの、ランナーマシンを再利用したいのであれば、セルフホストランナーアプリケーションディレクトリ（つまり、ランナーソフトウェアをダウンロードして解凍したディレクトリ）内の .runner ファイルを削除できます。そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。

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

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

Note

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

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

あるいは、GitHub Enterprise Server 上のリポジトリ、組織、またはエンタープライズへのランナーの削除のアクセス権がないものの、ランナーマシンを再利用したいのであれば、セルフホストランナーアプリケーションディレクトリ（つまり、ランナーソフトウェアをダウンロードして解凍したディレクトリ）内の .runner ファイルを削除できます。そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。

GitHub Enterprise Server の右上で、ご自分のプロフィールフォトをクリックしてから、 [Enterprise 設定] をクリックします。
ページの左側にある Enterprise アカウントのサイドバーで、 [ポリシー] をクリックします。
「ポリシー」で、[アクション] をクリックします。
[Runners](ランナー) タブをクリックします。
ランナーの一覧で、構成するランナーの名前をクリックします。
[削除] をクリックします。
セルフホストランナーの削除手順が表示されます。ランナーがアクセスできる状態にあるかによって、ランナーを削除するための以下のステップのいずれかを実行してください。
- ランナーマシンにアクセスできる場合: マシンのオペレーティングシステムの画面上の指示に従い、削除コマンドを実行してください。この指示には、必須のURLと自動的に生成された期間限定のトークンが含まれます。
  
  この削除コマンドは、以下のタスクを実行します。
  - GitHub Enterprise Serverからのランナーの削除。
  - マシン上のセルフホストランナーアプリケーションの設定ファイルの削除。
  - インタラクティブモードで動作していないのであれば設定されているサービスの削除。
- マシンにアクセスできない場合: [このランナーを強制的に削除する] をクリックして、GitHub Enterprise Server でこのランナーを強制的に削除するようにします。