ワークフローの無効化と有効化

GitHub UI、REST API、または GitHub CLI を使用して、ワークフローを無効化したり再度有効化したりすることができます。

Tool navigation

この記事の内容

ワークフローを無効にすると、リポジトリからファイルを削除することなく、ワークフローがトリガーされないようにすることができます。 GitHub でワークフローを簡単に再度有効にすることができます。

ワークフローを一時的に無効にすると、多くのシナリオで役立つことがあります。 以下は、ワークフローを無効すると便利な場合の例の一部です。

  • リクエストが多すぎるまたは間違っていて、外部サービスに悪影響を与えるワークフローエラー。
  • 重要ではないが、アカウントの時間を消費しすぎるワークフロー。
  • ダウンしているサービスにリクエストを送信するワークフロー。
  • フォークされたリポジトリ上の不要なワークフロー（スケジュールされたワークフローなど）。

警告: 不必要なワークフローの実行を避けるために、スケジュールされたワークフローは自動的に無効化できます。 パブリックリポジトリがフォークされると、スケジュールされたワークフローはデフォルトで無効化されます。 パブリックリポジトリでは、60日間にリポジトリにアクティビティがなかった場合、スケジュールされたワークフローは自動的に無効化されます。

REST API を使用して、ワークフローを無効化または有効化することもできます。 詳しくは、「ワークフローの REST API エンドポイント」を参照してください。

ワークフローの無効化

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

  2. リポジトリ名の下にある [アクション] をクリックします。

    "github/docs" リポジトリのタブのスクリーンショット。 [アクション] タブがオレンジ色の枠線で強調表示されています。

  3. 左サイドバーで、無効にするワークフローをクリックします。

  4. をクリックしてドロップダウン メニューを表示し、 [ワークフローの無効化] をクリックします。

    ワークフローのスクリーンショット。 水平方向のケバブ アイコンでラベル付けされた [ワークフロー オプションの表示] ボタンと [ワークフローを無効にする] メニュー項目が、濃いオレンジ色の輪郭で囲まれています。

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

ワークフローを無効にするには、workflow disable サブコマンドを使います。 workflow を、無効にするワークフローの名前、ID、またはファイル名のいずれかに置き換えます。 たとえば、「"Link Checker"」、「1234567」、「"link-check-test.yml"」のように指定します。 ワークフローを指定しない場合、GitHub CLI はワークフローを選択するためのインタラクティブメニューを返します。

gh workflow disable WORKFLOW

ワークフローの有効化

以前、無効化したワークフローを再度有効化することができます。

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

  2. リポジトリ名の下にある [アクション] をクリックします。

    "github/docs" リポジトリのタブのスクリーンショット。 [アクション] タブがオレンジ色の枠線で強調表示されています。

  3. 左サイドバーで、有効にするワークフローをクリックします。

    [アクション] ページのスクリーンショット。 ワークフロー名が、左側のサイド バーで濃いオレンジ色の輪郭で強調表示されています。

  4. Enable workflow をクリックします。

ワークフローを有効にするには、workflow enable サブコマンドを使います。 workflow を、有効にするワークフローの名前、ID、またはファイル名のいずれかに置き換えます。 たとえば、「"Link Checker"」、「1234567」、「"link-check-test.yml"」のように指定します。 ワークフローを指定しない場合、GitHub CLI はワークフローを選択するためのインタラクティブメニューを返します。

gh workflow enable WORKFLOW