注: GitHub ホステッド ランナーは、現在 GitHub Enterprise Server でサポートされていません。 GitHub public roadmap で、今後の計画的なサポートの詳細を確認できます。
はじめに
GitHub Actions ワークフローを作成して実行するには、GitHub リポジトリのみが必要になります。 このガイドでは、GitHub Actions の重要な機能のいくつかを示すワークフローを追加します。
次の例は、GitHub Actions ジョブを自動的にトリガーする方法、実行する場所、およびリポジトリ内のコードとやり取りする方法を示しています。
最初のワークフローを作成する
-
.github/workflows
ディレクトリがまだ存在しない場合、リポジトリの GitHub でこのディレクトリを作成します。 GitHub が含まれている GitHub Actions ワークフローを識別には、ディレクトリにこの正確な名前が必要です。 -
.github/workflows
ディレクトリで、.yml
または.yaml
拡張子を持つファイルを作成します。 このチュートリアルでは、ファイルにgithub-actions-demo.yml
という名前を使います。 詳しくは、「新しいファイルの作成」を参照してください。 -
次の YAML コンテンツを
github-actions-demo.yml
ファイルにコピーします。YAML name: GitHub Actions Demo run-name: ${{ github.actor }} is testing out GitHub Actions 🚀 on: [push] jobs: Explore-GitHub-Actions: runs-on: ubuntu-latest steps: - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event." - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!" - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}." - name: Check out repository code uses: actions/checkout@v4 - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner." - run: echo "🖥️ The workflow is now ready to test your code on the runner." - name: List files in the repository run: | ls ${{ github.workspace }} - run: echo "🍏 This job's status is ${{ job.status }}."
name: GitHub Actions Demo run-name: ${{ github.actor }} is testing out GitHub Actions 🚀 on: [push] jobs: Explore-GitHub-Actions: runs-on: ubuntu-latest steps: - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event." - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!" - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}." - name: Check out repository code uses: actions/checkout@v4 - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner." - run: echo "🖥️ The workflow is now ready to test your code on the runner." - name: List files in the repository run: | ls ${{ github.workspace }} - run: echo "🍏 This job's status is ${{ job.status }}."
-
ページの下部までスクロールして、 [このコミットに新しいブランチを作成して pull request を開始] を選択してください。 そして、pull request を作成するために [新しいファイルを提案] をクリックしてください。
リポジトリ内のワークフローファイルをブランチにコミットすると、push
イベントがトリガーされ、ワークフローが実行されます。
ワークフローの結果を表示する
-
お使いの GitHub Enterprise Server インスタンス で、リポジトリのメイン ページへ移動します。
-
リポジトリ名の下にある [アクション] をクリックします。
-
左側のサイドバーで、表示するワークフローをクリックします。この例では、"GitHub Actions デモ" です。
-
ワークフローの実行の一覧から、表示する実行の名前をクリックします。この例では、"USERNAME が GitHub Actions を試しています" です。
-
ワークフローの実行ページの左側のサイドバーの [ジョブ] で、Explore-GitHub-Actions ジョブをクリックします。
-
ログには、各ステップの処理方法が表示されます。 いずれかのステップを展開して、詳細を表示します。
たとえば、リポジトリ内のファイルの一覧を表示できます。
追加したワークフロー例では、コードがブランチにプッシュされるたびにトリガーされ、GitHub Actions がリポジトリのコンテンツを処理できる方法が示されます。 詳しいチュートリアルについては、「GitHub Actions を理解する」をご覧ください。
その他のスターターワークフロー
GitHub には、独自の継続的インテグレーション ワークフローを作成するためにカスタマイズできる事前構成済みのスターター ワークフローが用意されています。 GitHub Enterprise Server はコードを分析し、自分のリポジトリに役立つ可能性のある CI スターター ワークフローを表示します。 たとえばリポジトリにNode.jsのコードが含まれているなら、Node.jsプロジェクトのためのサジェッションが提示されます。 スターター ワークフローは、カスタム ワークフローの構築の出発点として利用することも、そのまま利用することもできます。
スターター ワークフローの完全な一覧については、 お使いの GitHub Enterprise Server インスタンス の actions/starter-workflows
を参照してください。
次の手順
GitHub Actions は、アプリケーション開発プロセスのほぼすべての要素を自動化するのに役立ちます。 使い始める準備はできていますか。 GitHub Actions で次のステップに進む際に役立つ、以下のようなリソースを参照してください。
- GitHub Actions ワークフローを簡単に作成する方法については、「スターター ワークフローの使用」を参照してください。
- コードをビルドし、テストするための継続的インテグレーション (CI) ワークフローについては、「ビルドとテストの自動化」を参照してください。
- パッケージのビルドと発行については、「パッケージを公開する」を参照してください。
- プロジェクトの配置については、「デプロイ」を参照してください。
- GitHub でタスクとプロセスを自動化する方法については、「Issue と Pull Request の管理」を参照してください。
- 上記のたくさんのユース ケースを含む、GitHub Actions のより複雑な機能を示す例については、「例」を参照してください。 ランナーでコードをテストする方法、GitHub CLI にアクセスする方法、コンカレンシーやテスト マトリックスなどの高度な機能を使用する方法を説明する詳しい例を確認できます。