Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。
All products
GitHub のアクション

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

この記事の内容

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

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

注: この手順は、セルフホストランナーを恒久的に削除します。 一時的にランナーへのジョブの割り当てを停止するだけなら、そのマシンをシャットダウンするか、run アプリケーションを停止することができます。 ランナーは "Offline (オフライン)" 状態で割り当て済みのままになり、run アプリケーションを使ってランナーを再起動するまではジョブが実行されません。

セルフホストランナーは、GitHub Actions に 14 日以上接続されないと、GitHub から自動的に削除されます。
エフェメラル セルフホストランナーは、GitHub Actions に 1 日以上接続されないと、GitHub から自動的に削除されます。

ユーザリポジトリからセルフホストランナーを削除するには、リポジトリのオーナーでなければなりません。 Organizationのリポジトリの場合は、Organizationのオーナーであるか、そのリポジトリの管理アクセスを持っていなければなりません。 セルフホストランナーのマシンへもアクセスできるようにしておくことをおすすめします。 REST API を使ってセルフホスト ランナーを削除する方法については、「アクション」をご覧ください。

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

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

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

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

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

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

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

Organizationからのランナーの削除

注: この手順は、セルフホストランナーを恒久的に削除します。 一時的にランナーへのジョブの割り当てを停止するだけなら、そのマシンをシャットダウンするか、run アプリケーションを停止することができます。 ランナーは "Offline (オフライン)" 状態で割り当て済みのままになり、run アプリケーションを使ってランナーを再起動するまではジョブが実行されません。

セルフホストランナーは、GitHub Actions に 14 日以上接続されないと、GitHub から自動的に削除されます。
エフェメラル セルフホストランナーは、GitHub Actions に 1 日以上接続されないと、GitHub から自動的に削除されます。

Organizationからセルフホストランナーを削除するには、Organizationのオーナーでなければなりません。 セルフホストランナーのマシンへもアクセスできるようにしておくことをおすすめします。 REST API を使ってセルフホスト ランナーを削除する方法については、「アクション」をご覧ください。

あるいは、GitHub 上のリポジトリ 、組織 へのランナーの削除のアクセス権がないものの、ランナー マシンを再利用したいのであれば、セルフホスト ランナー アプリケーション ディレクトリ内の .runner ファイルを削除できます。 そうすれば、セルフホストランナーアプリケーションをダウンロードし直さなくても、ランナーを再登録できるようになります。 1. GitHub.com で、Organization のメイン ページへ移動します。 1. Organization 名の下で、 [設定] をクリックします。

Organization の設定ボタン 1. 左側のサイドバーで、 [アクション] 、 [ランナー] の順にクリックします。 1. ランナーの一覧で、構成するランナーの名前をクリックします。 1. [削除] をクリックします。

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

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

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

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

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

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

GitHub Enterprise Cloud を使用する場合は、エンタープライズからランナーを削除することもできます。 詳細については、GitHub Enterprise Cloud ドキュメントを参照してください。