ワークフローの手動実行

メモ

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

ワークフローの実行

GitHub で、リポジトリのメインページに移動します。1. リポジトリ名の下にある [ Actions] をクリックします。
左側のサイドバーで、実行するワークフローの名前をクリックします。

ワークフロー実行の一覧の上にある [ワークフローの実行] ボタンをクリックします。

メモ

       **[Run workflow]** ボタンが表示されるには、ワークフロー ファイルで `workflow_dispatch` イベント トリガーが使われている必要があります。

       `workflow_dispatch` ボタンを使ってワークフローを手動で実行できるのは、**** イベント トリガーを使っているワークフロー ファイルだけです。 
       `workflow_dispatch` イベントの構成方法については、「[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#workflow_dispatch)」を参照してください。

ワークフローページのスクリーンショット。ワークフロー実行の一覧の上に、[Run workflow] (ワークフローの実行) というラベルの付いたボタンが濃いオレンジ色の枠線で囲まれています。

       **[Branch]&nbsp;(ブランチ)** ドロップダウン メニューを選択し、ワークフローを実行するブランチをクリックします。

ワークフローに入力が必要な場合は、フィールドに入力します。

       **[ワークフローの実行]** をクリックします。

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

gh workflow run WORKFLOW

ワークフローに入力可能な場合、GitHub CLI は入力を求めるプロンプトを表示します。または、-f または -F を使用して key=value 形式の入力を追加できます。 -F を使用してファイルから読み取ります。

gh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt

標準入力を使用して、入力を JSON として渡すこともできます。

echo '{"name":"mona", "greeting":"hello"}' | gh workflow run greet.yml --json

リポジトリの既定のブランチ以外のブランチでワークフローを実行するには、--ref フラグを使用します。

gh workflow run WORKFLOW --ref BRANCH

ワークフロー実行の進行状況を表示するには、run watch サブコマンドを使用して、インタラクティブリストから実行を選択します。

gh run watch

REST API を使用してワークフローを実行する

REST API を使用する場合は、要求本文パラメーターとして inputs と ref を構成します。入力を省略すると、ワークフローファイルで定義されているデフォルト値が使用されます。

メモ

最大 10 inputs を workflow_dispatch イベントに対して定義できます。

REST API の使用の詳細については、「ワークフローの REST API エンドポイント」を参照してください。

Tool navigation

この記事で

ワークフローを手動実行する設定

ワークフローの実行

REST API を使用してワークフローを実行する