Skip to main content

GitHub Actions のクイックスタート

GitHub Actions の機能を 5 分またはそれ以下で試すことができます。

はじめに

GitHub Actions ワークフローを作成して実行するには、GitHub リポジトリのみが必要になります。 このガイドでは、GitHub Actions の重要な機能のいくつかを示すワークフローを追加します。

次の例は、GitHub Actions ジョブを自動的にトリガーする方法、実行する場所、およびリポジトリ内のコードとやり取りする方法を示しています。

最初のワークフローを作成する

  1. .github/workflows ディレクトリがまだ存在しない場合、リポジトリの GitHub でこのディレクトリを作成します。

  2. .github/workflows ディレクトリに github-actions-demo.yml という名前のファイルを作成します。 詳細については、「新しいファイルの作成」を参照してください。

  3. 次の YAML コンテンツを github-actions-demo.yml ファイルにコピーします:

    YAML
    name: GitHub Actions Demo
    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@v2
          - 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 }}."
    
  4. ページの下部までスクロールして、 [このコミットに新しいブランチを作成して pull request を開始] を選択してください。 そして、pull request を作成するために [新しいファイルを提案] をクリックしてください。 ワークフローファイルのコミット

リポジトリ内のワークフローファイルをブランチにコミットすると、push イベントがトリガーされ、ワークフローが実行されます。

ワークフローの結果を表示する

  1. your enterprise で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下の [Actions] (アクション) をクリックします。 メインのリポジトリ ナビゲーション内の [Actions](アクション) タブ

  2. 左サイドバーで、表示するワークフローをクリックします。

    左サイドバーのワークフローのリスト

  3. ワークフローの実行リストから、表示させたい実行の名前をクリックしてください。

    ワークフローの実行の名前

  4. [ジョブ][Explore-GitHub-Actions] ジョブをクリックします。

    ジョブを探す

  5. ログには、各ステップの処理方法が表示されます。 いずれかのステップを展開して、詳細を表示します。

    ワークフロー結果の例

    たとえば、リポジトリ内のファイルのリストを確認できます。アクションの詳細の例

その他のスターターワークフロー

GitHub には、独自の継続的インテグレーション ワークフローを作成するためにカスタマイズできる事前構成済みのスターター ワークフローが用意されています。 GitHub AE はコードを分析し、自分のリポジトリに役立つ可能性のある CI スターターワー クフローを表示します。 たとえばリポジトリにNode.jsのコードが含まれているなら、Node.jsプロジェクトのためのサジェッションが提示されます。 スターター ワークフローは、カスタム ワークフローの構築の出発点として利用することも、そのまま利用することもできます。

スターター ワークフローの完全なリストは、 your enterprise の actions/starter-workflows で参照できます。

より複雑な例

GitHub Actions のより複雑な機能を示す例については、「」を参照してください。 ランナーでコードをテストする方法、GitHub CLI にアクセスする方法、コンカレンシーやテスト マトリックスなどの高度な機能を使用する方法を説明する詳しい例を確認できます。

次の手順

追加したワークフロー例では、コードがブランチにプッシュされるたびに実行され、GitHub Actions がリポジトリのコンテンツを処理できる方法が示されます。 ただし、これは GitHub Actions で可能なことの一部にすぎません。

  • リポジトリには、さまざまなイベントに基づいてさまざまなジョブをトリガーする複数のワークフローを含めることができます。
  • ワークフローを使用してソフトウェアテストアプリをインストールし、GitHub のランナーでコードを自動的にテストすることができます。

GitHub Actions は、アプリケーション開発プロセスのほぼすべての要素を自動化するのに役立ちます。 使い始める準備はできていますか。 GitHub Actions で次のステップに進む際に役立つ、以下のようなリソースを参照してください。

  • 詳しいチュートリアルについては、「GitHub Actions」を参照してください。