注: GitHub ホステッド ランナーは、現在 GitHub Enterprise Server でサポートされていません。 GitHub public roadmap で、今後の計画的なサポートの詳細を確認できます。
概要
GitHub Actions は、ビルド、テスト、デプロイのパイプラインを自動化できる継続的インテグレーションと継続的デリバリー (CI/CD) のプラットフォー� です。 リポジトリに対するすべての pull request をビルドしてテストしたり、マージされた pull request を運用環境にデプロイしたりするワークフローを作成できます。
GitHub Actions は、DevOps である� けでなく、リポジトリで他のイベントが発生したときにワークフローを実行できます。 たとえば、リポジトリで新しい issue が作成されるたびに、適切なラベルを自動的に追� するワークフローを実行できます。
のワークフローを実行するには、独自の Linux、Windows、または macOS 仮想マシンをホストする必要があります。 セルフホステッド ランナーは、物理または仮想にでき、コンテナー内、オンプレミス、またはクラウドに配置できます。
GitHub Actions を Enterprise に導入する方法の詳細については、「Enterprise への GitHub Actions の導入」を参照してく� さい。
GitHub Actions のコンポーネント
リポジトリで、pull request のオープンや issue の作成などの イベント が発生したときにトリガーされるように GitHub Actions ワークフロー を構成できます。 ワークフローには、1 つ以上の ジョブ が含まれており、ジョブは� �次にまたは並列で実行できます。 各ジョブは、専用の仮想マシン ランナー 内、またはコンテナー内で実行され、定義した スクリプト を実行するか、または アクション (ワークフローを簡略化できる再利用可能な拡張機能) を実行する 1 つ以上のステップで構成されます。
Workflows
ワークフローは、1 つ以上のジョブを実行する構成可能な自動化プロセスです。 ワークフローは、リポジトリにチェックインされる YAML ファイルによって定義され、リポジトリ内のイベントによってトリガーされたときに実行されます。また、手動でトリガーしたり、定義されたスケジュールでトリガーしたりすることもできます。
ワークフローはリポジトリ内の .github/workflows
ディレクトリで定義され、リポジトリには複数のワークフローを含めることができます。各ワークフローは、それぞれ異なる一連のタスクを実行できます。 たとえば、あるワークフローでは、pull request をビルドしてテストし、別のワークフローでは、リリースが作成されるたびにアプリケーションをデプロイし、さらに別のワークフローでは、新しい issue が開かれるたびにラベルを追� することができます。
ワークフローの詳細については、「Using workflows」 (ワークフローの使用) を参照してく� さい。
イベント
イベントは、ワークフロー実行をトリガーする、リポジトリ内の特定のアクティビティです。 たとえば、pull request が作成されたとき、issue が開かれたとき、またはリポジトリにコミットがプッシュされたときに、GitHub からアクティビティを発生させることができます。 また、スケジュールに従って、REST API に投稿して、または手動で、ワークフロー実行をトリガーすることもできます。
ワークフローのトリガーに使用できるイベントの完全な一覧については、「ワークフローをトリガーするイベント」を参照してく� さい。
ジョブ
ジョブは、同じランナーで実行される、ワークフロー内の一連の ステップ です。 各ステップは、実行されるシェル スクリプト、または実行される アクション のいずれかです。 ステップは� �番に実行され、相互に依存します。 各ステップは同じランナーで実行されるため、あるステップから別のステップにデータを共有できます。 たとえば、アプリケーションをビルドするステップの後に、ビルドされたアプリケーションをテストするステップを続けることができます。
ジョブと他のジョブとの依存関係を構成できます。既定では、ジョブに依存関係はなく、相互に並列で実行されます。 ジョブが別のジョブに依存する� �合、依存ジョブが完了するまで待ってから実行されます。 たとえば、異なるアーキテクチャ用で依存関係のない複数のビルド ジョブがあり、それらのジョブに依存するパッケージ化ジョブがあるとします。 ビルド ジョブは並列で実行され、それらがすべて正常に完了したら、パッケージ化ジョブが実行されます。
ジョブの詳細については、「Using jobs」 (ジョブの使用) を参照してく� さい。
アクション
アクション は、GitHub Actions 用のカスタ� アプリケーションであり、複雑で� �繁に繰り返されるタスクを実行します。 アクションを使用すると、ワークフロー ファイルに記述する繰り返しコードの量を削減するのに役立ちます。 アクションでは、GitHub からの Git リポジトリのプル、ビルド環境に適したツールチェーンの設定、またはクラウド プロバイダーに対する認証の設定を実行できます。
独自のアクションを記述することも、GitHub Marketplace で、ワークフローで使用するアクションを見つけることもできます。
詳細については、「アクションを作成する」を参照してく� さい。
ランナー
ランナーは、ワークフローがトリガーされると実行されるサーバーです。 各ランナーでは、一度に 1 つのジョブを実行できます。 GitHub Enterprise Server の� �合、独自のランナーをホストする必要があります。 、「自分のランナーをホストする」を参照してく� さい。
サンプルワークフローを作成する
GitHub Actions では、YAML 構文を使用してワークフローを定義します。 各ワークフローは、コード リポジトリ内の .github/workflows
という名前のディレクトリに個別の YAML ファイルとして� �納されます。
コードがプッシュされるたびに一連のコマンドを自動的にトリガーするサンプルワークフローをリポジトリに作成できます。 このワークフローでは、GitHub Actions がプッシュされたコードをチェックアウトし、bats テスト フレー� ワークをインストールし、bats バージョンを出力する基本コマンド bats -v
を実行します。
-
自身のリポジトリで、ワークフロー ファイルを� �納するための
.github/workflows/
ディレクトリを作成します。 -
.github/workflows/
ディレクトリで、learn-github-actions.yml
という名前の新しいファイルを作成し、次のコードを追� します。name: learn-github-actions on: [push] jobs: check-bats-version: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - uses: actions/setup-node@v2 with: node-version: '14' - run: npm install -g bats - run: bats -v
-
これらの変更をコミットして、GitHub リポジトリにプッシュします。
これで、新しい GitHub Actions ワークフローファイルがリポジトリにインストールされ、別のユーザがリポジトリに変更をプッシュするたびに自動的に実行されます。 ワークフローの実行履歴に関する詳細については、「ワークフロー実行時のアクティビティを見る」を参照してく� さい。
ワークフローファイルを理解する
YAML 構文を使用してワークフローファイルを作成する方法を理解しやすくするために、このセクションでは、導入例の各行について説明します。
|
省略可能 - GitHub リポジトリの [アクション] タブに表示されるワークフローの名前。 |
|
このワークフローのトリガーを指定します。 この例では、push イベントを使用しているため、変更がリポジトリにプッシュされるか、pull request がマージされるたびに、ワークフロー実行がトリガーされます。 これは、すべてのブランチへのプッシュによってトリガーされます。特定のブランチ、パス、またはタブへのプッシュでのみ実行される構文の例については、「GitHub Actions のワークフロー構文」を参照してく� さい。
|
|
learn-github-actions ワークフローで実行されるすべてのジョブをグループ化します。
|
|
check-bats-version という名前のジョブを定義します。 子キーは、ジョブのプロパティを定義します。
|
|
Ubuntu Linux ランナーの最新バージョンで実行されるようにジョブを構成します。 これは、ジョブが GitHub によってホストされている新しい仮想マシンで実行されるということです。 他のランナーを使う構文例については、「GitHub Actions のワークフロー構文」を参照してく� さい。 |
|
check-bats-version ジョブで実行されるすべてのステップをグループ化します。 このセクションで入れ子になった各� �目は、個別のアクションまたはシェル スクリプトです。
|
|
uses キーワードは、このステップが actions/checkout アクションの v3 を実行することを指定します。 これは、リポジトリをランナーにチェックアウトするアクションであり、コードに対してスクリプトまたは他のアクション (ビルド ツールやテスト ツールなど) を実行できます。 チェックアウト アクションは、リポジトリのコードに対してワークフローが実行されるたびに使用する必要があります。
|
|
このステップでは、actions/setup-node@v2 アクションを使用して、指定されたバージョン (この例では、v14 を使用) の Node.js をインストールします。 これにより、node と npm の両方のコマンドが PATH にプッシュされます。
|
|
run キーワードは、ランナーでコマンドを実行するようにジョブに指示します。 この� �合は、npm を使用して bats ソフトウェア テスト パッケージをインストールします。
|
|
最後に、ソフトウェアのバージョンを出力するパラメーターを指定して bats を実行します。
|
ワークフローファイルの視覚化
この図では、作成したワークフローファイルと、GitHub Actions コンポーネントが階層にどのように整理されているかを確認できます。 各ステップでは、単一のアクションまたはシェル スクリプトが実行されます。 ステップ 1 と 2 ではアクションが実行され、ステップ 3 と 4 ではシェル スクリプトが実行されます。 ワークフローの事前構築済みアクションの詳細については、「Finding and customizing actions」 (アクションの検出とカスタマイズ) を参照してく� さい。
ワークフロー実行のアクティビティの表示
ワークフローがトリガーされると、 ワークフローを実行するワークフロー実行 が作成されます。 ワークフロー実行の開始後に、実行の進行状況を示す視覚化グラフが表示され、GitHub での各ステップのアクティビティを表示できます。
-
で、リポジトリのメイン ページへ移動します。
-
リポジトリ名の下にある [アクション] をクリックします。
-
左サイドバーで、表示するワークフローをクリックします。
-
[Workflow runs] で、表示する実行の名前をクリックします。
-
[ジョブ] の下、または視覚化グラフ内で、表示するジョブをクリックします。
-
各ステップの結果を表示します。
より複雑な例
GitHub Actions のより複雑な機能を示す例については、「例」を参照してく� さい。 ランナーでコードをテストする方法、GitHub CLI にアクセスする方法、コンカレンシーやテスト マトリックスなどの高度な機能を使用する方法を説明する詳しい例を確認できます。
次の手� �
-
GitHub Actions について引き続き学習するには、「Finding and customizing actions」 (アクションの検出とカスタマイズ) を参照してく� さい。
-
GitHub Actions の課金のしくみについては、「GitHub Actions の課金について」を参照してく� さい。
サポートへの問い合わせ
構文、GitHub ホスト ランナー、アクションの構築など、ワークフローの構成に関して何か支援が必要な� �合は、GitHub Community の GitHub Actions および GitHub Packages カテゴリで既存のトピックを探してみるか、新しいトピックを開始してく� さい。
GitHub Actionsについてのフィードバックもしくは機能リクエストがあるなら、それらをGitHub Actions に関する GitHub コミュニティのディスカッションで共有してく� さい。
あなたの利用方法、もしくは意図する利用方法が利用制限のカテゴリに当てはまるかどうかに関わらず、以下のいずれかの� �合はサイト管理者に連絡してく� さい。
- アカウントに間違った制約が課されていると思われる� �合
- いずれかのアクションを実行すると予期しないエラーが発生する� �合
- 既存の動作が期待される、た� し必ずしもドキュメント化されてはいない動作と矛盾するような状況に遭遇した� �合