{"meta":{"title":"ワークフロー","intro":"トリガー、構文、高度な機能など、 GitHub Actions ワークフローの概要について説明します。","product":"GitHub Actions","breadcrumbs":[{"href":"/ja/actions","title":"GitHub Actions"},{"href":"/ja/actions/concepts","title":"概念"},{"href":"/ja/actions/concepts/workflows-and-actions","title":"ワークフローとアクション"},{"href":"/ja/actions/concepts/workflows-and-actions/workflows","title":"ワークフロー"}],"documentType":"article"},"body":"# ワークフロー\n\nトリガー、構文、高度な機能など、 GitHub Actions ワークフローの概要について説明します。\n\n## ワークフローについて\n\n**ワークフロー**とは、1 つ以上のジョブを実行する構成可能な自動化プロセスです。 ワークフローは、リポジトリにチェックインされる YAML ファイルによって定義され、リポジトリ内のイベントによってトリガーされたときに実行されます。また、手動でトリガーしたり、定義されたスケジュールでトリガーしたりすることもできます。\n\nワークフローは、リポジトリ内の `.github/workflows` ディレクトリで定義されます。 1 つのリポジトリで複数のワークフローを使用でき、それぞれで次のような異なるタスクのセットを実行できます。\n\n* Pull request のビルドとテスト\n* リリースが作成される度にアプリケーションを配置する\n* 新しい issue が開かれる度にラベルを追加する\n\n## ワークフローの基本\n\nワークフローには、次の基本的なコンポーネントが含まれている必要があります。\n\n1. ワークフローをトリガーする 1 つ以上の *イベント* 。\n2. 1 つ以上の *ジョブ*。それぞれが *ランナー* マシンで実行され、一連の 1 つ以上の \\_ステップ\\_が実行されます。\n3. 各ステップは、ユーザーが定義したスクリプトか、アクションを実行でき、ワークフローを簡略化できる再利用可能な拡張機能です。\n\nこれらの基本的なコンポーネントについて詳しくは、「[GitHub Actionsについて](/ja/actions/get-started/understand-github-actions#the-components-of-github-actions)」をご覧ください。\n\n![ランナー 1 をトリガーしてジョブ 1 を実行し、それによってランナー 2 がジョブ 2 の実行をトリガーするイベントの図。 各ジョブは複数のステップに分割されています。](/assets/images/help/actions/overview-actions-simple.png)\n\n## ワークフロー トリガー\n\nワークフロー トリガーは、ワークフローの実行を引き起こすイベントです。 次のようなイベントがあります。\n\n* ワークフローのリポジトリ内で発生するイベント\n* GitHub の外側で発生し、`repository_dispatch` 上で GitHub イベントをトリガーするイベント\n* スケジュールされた時刻\n* マニュアル\n\nたとえば、リポジトリの既定のブランチに対してプッシュが行われたときや、リリースが作成されたとき、またはイシューが開かれたときに実行するようにワークフローを構成できます。\n\nワークフロー トリガーは、`on` キーを使って定義されます。 詳しくは、「[GitHub Actions　のワークフロー構文](/ja/actions/reference/workflows-and-actions/workflow-syntax#on)」をご覧ください。\n\nワークフローの実行がトリガーされるには、以下のステップが生じます。\n\n1. リポジトリでイベントが発生します。 イベントには、コミット SHA と Git ref が関連付けられています。\n2. GitHub は、リポジトリのルートにある `.github/workflows` ディレクトリで、イベントの関連するコミット SHA または Git ref に存在するワークフロー ファイルを検索します。\n3. トリガーするイベントと一致する `on:` 値を持つすべてのワークフローに対して、ワークフロー実行がトリガーされます。 一部のイベントでは、実行のために、リポジトリの既定のブランチにワークフロー ファイルが存在している必要もあります。\n\n各ワークフロー実行では、そのイベントに関連付けられたコミット SHA または Git ref に存在するワークフローのバージョンが使用されます。 ワークフローが実行されると、GitHub はランナー環境で `GITHUB_SHA`（コミット SHA）および `GITHUB_REF`（Git ref）環境変数を設定します。 詳しくは、「[変数に情報を格納する](/ja/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables)」をご覧ください。\n\n詳しくは、「[ワークフローをトリガーする](/ja/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow)」をご覧ください。\n\n## 次のステップ\n\n最初のワークフローをビルドするには、「[サンプル ワークフローの作成](/ja/actions/tutorials/create-an-example-workflow)」を参照してください。"}