ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

ワークフローの手動実行

ワークフローが workflow_dispatch イベントで実行されるように設定されている場合、GitHub、GitHub CLI、または REST API の [Actions] タブを使用してワークフローを実行できます。

GitHub ActionsはGitHub Free、GitHub Pro、GitHub FreeのOrganization、GitHub Team、GitHub Enterprise Cloud、GitHub AEで利用できます。 GitHub Actionsは、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 詳しい情報については「GitHubの製品」を参照してください。

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

ワークフローを手動で実行するには、workflow_dispatch イベントで実行するようにワークフローを設定する必要があります。 workflow_dispatchイベントの設定に関する詳しい情報については「ワークフローをトリガーするイベント」を参照してください。

GitHub でワークフローを実行する

GitHub で workflow_dispatch イベントをトリガーするには、ワークフローがデフォルトブランチに含まれている必要があります。 ワークフローの実行を手動でトリガーするには、次の手順に従います。

これらのステップを実行するには、リポジトリへの書き込みアクセスが必要です。

  1. GitHubで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下でActions(アクション)をクリックしてください。 メインのリポジトリナビゲーション内のアクションタブ
  3. 左側のサイドバーで、実行するワークフローをクリックします。 アクション選択ワークフロー
  4. ワークフロー実行の一覧の上にあるRun workflow(ワークフローの実行)を選択します。 アクション ワークフローのディスパッチ
  5. ワークフローを実行するブランチを選択し、ワークフローで使用される入力パラメータを入力します。 Run workflow(ワークフローの実行)をクリックします。 アクションはワークフローを手動で実行します

GitHub CLI を使ってワークフローを実行する

GitHub CLIのセットアップに関する情報については「GitHub CLIでのGitHub Actionsの管理」を参照してください。

ワークフローを実行するには、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-name

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

gh run watch

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

REST API を使用する場合は、 inputsrefをリクエストボディのパラメータとして設定してください。 入力を省略すると、ワークフロー ファイルで定義されているデフォルト値が使用されます。

REST API の使用の詳細については、「ワークフローディスパッチ イベントの作成」を参照してください。

このドキュメントは役立ちましたか? プライバシーポリシー

これらのドキュメントを素晴らしいものにするのを手伝ってください!

GitHubのすべてのドキュメントはオープンソースです。間違っていたり、はっきりしないところがありましたか?Pull Requestをお送りください。

コントリビューションを行う

OR, コントリビューションの方法を学んでください。

問題がまだ解決していませんか?

GitHubコミュニティで質問する サポートへの連絡