# GitHub Actionsのクイック スタート GitHub Actions のコア機能を数分で試すことができます。 ## はじめに GitHub Actions は、ビルド、テスト、デプロイのパイプラインを自動化できる継続的インテグレーションと継続的デリバリー (CI/CD) のプラットフォームです。 リポジトリに変更をプッシュするたびにテストを実行するワークフロー、またはマージされた pull request を運用環境にデプロイしたりするワークフローを作成できます。 このクイックスタート ガイドでは、GitHub のユーザー インターフェイスを使用して、GitHub Actions の重要な機能の一部を示すワークフローを追加する方法について説明します。 事前構成済みワークフローの使用を開始するには、 [actions/starter-workflows](https://github.com/actions/starter-workflows) リポジトリ内のテンプレートの一覧を参照します。 詳しくは、「[ワークフロー テンプレートの使用](/ja/actions/how-tos/write-workflows/use-workflow-templates)」をご覧ください。 GitHub Actions ワークフローの概要については、「[ワークフロー](/ja/actions/using-workflows/about-workflows)」をご覧ください。 GitHub Actions を構成するさまざまなコンポーネントについては、「[GitHub Actionsについて](/ja/actions/learn-github-actions/understanding-github-actions)」をご覧ください。 ## ワークフロー テンプレートの使用 GitHub には、独自のワークフローを作成するためにそのまま使える、もしくはカスタマイズできる事前構成済みのワークフロー テンプレートが用意されています。 GitHub を使うと、コードを分析し、自分のリポジトリに役立つ可能性のあるワークフロー テンプレートを表示することができます。 たとえばリポジトリにNode.jsのコードが含まれているなら、Node.jsプロジェクトのためのサジェッションが提示されます。 これらのワークフロー テンプレートは、すぐに起動して実行できるように設計されており、次のようなさまざまな構成が提供されます。 * CI: [継続的インテグレーション ワークフロー](https://github.com/actions/starter-workflows/tree/main/ci) * デプロイ: [デプロイ ワークフロー](https://github.com/actions/starter-workflows/tree/main/deployments) * 自動化: [自動ワークフロー](https://github.com/actions/starter-workflows/tree/main/automation) * コード スキャン: [Code スキャン ワークフロー](https://github.com/actions/starter-workflows/tree/main/code-scanning) * ページ: [ページ ワークフロー](https://github.com/actions/starter-workflows/tree/main/pages) これらのワークフローを、カスタム ワークフローの構築の出発点として使用するか、そのまま利用します。 ワークフロー テンプレートの詳細な一覧は、[actions/starter-workflows](https://github.com/actions/starter-workflows) リポジトリで参照できます。 ## 前提条件 このガイドは、以下の読者を対象としています。 * GitHub の使用方法について少なくとも基本的な知識があること。 まだお読みになっていない場合、リポジトリと pull request (プル リクエスト) に関するドキュメントの記事を最初にお読みになると役に立ちます。 たとえば、「[リポジトリのクイック スタート](/ja/repositories/creating-and-managing-repositories/quickstart-for-repositories)」、「[Branches](/ja/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches)」、「[Pull Request](/ja/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)」をご覧ください。 * ファイルを追加できるリポジトリが GitHub にあります。 * GitHub Actions にアクセスできます。 > \[!NOTE] > **\[ Actions]** タブが GitHub のリポジトリ名の下に表示されない場合、これはリポジトリでActionsが無効になっている可能性があります。 詳しくは、「[リポジトリのGitHub Actions設定の管理](/ja/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)」をご覧ください。 ## 最初のワークフローを作成する 1. GitHub のリポジトリで、`github-actions-demo.yml` ディレクトリに `.github/workflows` というワークフロー ファイルを作成します。 手順は次のとおりです。 * `.github/workflows` ディレクトリが既に存在する場合は、GitHub のそのディレクトリに移動し、**\[ファイルの追加]** をクリックし、**\[新しいファイルの作成]** をクリックして、ファイルに「`github-actions-demo.yml`」という名前を付けます。 * リポジトリに `.github/workflows` ディレクトリがない場合は、GitHub のリポジトリのメイン ページに移動し、**\[ファイルの追加]** をクリックして、**\[新しいファイルの作成]** をクリックし、ファイルに「`.github/workflows/github-actions-demo.yml`」という名前を付けます。 これにより、 1 つの手順で `.github` および `workflows` ディレクトリと `github-actions-demo.yml` ファイルが作成されます。 > \[!NOTE] > GitHub でリポジトリ内の GitHub Actions ワークフローを検出するには、ワークフロー ファイルを「`.github/workflows`」という名前のディレクトリに保存する必要があります。 > > ワークフロー ファイルには任意の名前を付けることができますが、ファイル名の拡張子として `.yml` または `.yaml` を使用する必要があります。 YAML は、構成ファイルでよく使用されるマークアップ言語です。 2. 次の YAML コンテンツを `github-actions-demo.yml` ファイルにコピーします。 ```yaml copy 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@v6 - 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 }}." ``` この段階では、このワークフローの詳細を理解する必要はありません。 ここでは、内容をコピーしてファイルに貼り付けることができます。 このクイックスタートガイドを完了した後、[ワークフロー](/ja/actions/using-workflows/about-workflows#understanding-the-workflow-file)におけるワークフローファイルの構文を学ぶことができます。「`${{ github.actor }}`」や「`${{ github.event_name }}`」のようなGitHub Actionsのコンテキストについての説明は、「[コンテキスト リファレンス](/ja/actions/learn-github-actions/contexts)」をご覧ください。 3. **\[Commit changes]** をクリックします。 4. \[変更の提案] ダイアログで、既定のブランチにコミットするオプション、または新しいブランチを作成して pull request を開始するオプションを選択します。 次に、**\[変更のコミット]** または **\[変更の提案]** をクリックします。 ![言及されている領域がオレンジ色の枠で強調表示されている \[変更の提案\] ダイアログのスクリーンショット。](/assets/images/help/repository/actions-quickstart-commit-new-file.png) リポジトリ内のワークフローファイルをブランチにコミットすると、`push` イベントがトリガーされ、ワークフローが実行されます。 pull request を開始することを選択した場合は、引き続きプル要求を作成できますが、コミットはブランチに対してまだ行われ、新しいワークフローがトリガーされるため、このクイックスタートの目的では必要ありません。 ## ワークフローの結果を表示する 1. GitHub で、リポジトリのメイン ページに移動します。 2. リポジトリ名の下にある **\[ Actions]** をクリックします。 !["github/docs" リポジトリのタブのスクリーンショット。 \[アクション\] タブがオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/actions-tab-global-nav-update.png) 3. 左側のサイドバーで、表示するワークフローをクリックします。この例では、"GitHub Actions デモ" です。 ![\[アクション\] ページのスクリーンショット。 サンプル ワークフローの名前 "GitHub Actions Demo" は、濃いオレンジ色のアウトラインで強調表示されています。](/assets/images/help/repository/actions-quickstart-workflow-sidebar.png) 4. ワークフロー実行の一覧から、確認したい実行の名前をクリックします。この例では、「USERNAMEがGitHub Actionsをテストしています。」 5. ワークフロー実行ページの左側のサイドバーの **Jobs** で、**Explore-GitHub-Actions** ジョブをクリックします。 ![\[ワークフローの実行\] ページのスクリーンショット。 左側のサイドバーで、"Explore-GitHub-Actions" ジョブが濃いオレンジ色のアウトラインで強調表示されています。](/assets/images/help/repository/actions-quickstart-job.png) 6. ログには、各ステップの処理方法が表示されます。 いずれかのステップを展開して、詳細を表示します。 ![ワークフローによって実行されるステップのスクリーンショット。](/assets/images/help/repository/actions-quickstart-logs.png) たとえば、リポジトリ内のファイルのリストを確認できます。 !["List files in the repository"(リポジトリ内のファイルの一覧表示) の手順が展開され、ログ出力が表示されているクリーンショット。 ステップの出力は、オレンジ色の枠で強調表示されています。](/assets/images/help/repository/actions-quickstart-log-detail.png) 追加したワークフロー例では、コードがブランチにプッシュされるたびにトリガーされ、GitHub Actions がリポジトリのコンテンツを処理できる方法が示されます。 詳しいチュートリアルについては、「[GitHub Actionsについて](/ja/actions/learn-github-actions/understanding-github-actions)」をご覧ください。 ## 次のステップ GitHub Actions は、アプリケーション開発プロセスのほぼすべての側面を自動化するのに役立ちます。 使い始める準備はできていますか。 GitHub Actionsで次の手順を実行するために役立つリソースを次に示します。 * GitHub Actionsワークフローを作成するには、「[ワークフロー テンプレートの使用](/ja/actions/how-tos/write-workflows/use-workflow-templates)」を参照してください。 * 継続的インテグレーション (CI) ワークフローについては、「[コードのビルドとテスト](/ja/actions/tutorials/build-and-test-code)」を参照してください。 * パッケージのビルドと公開については、「[パッケージを公開する](/ja/actions/tutorials/publish-packages)」を参照してください。 * プロジェクトの配置については、「[サード パーティ製プラットフォームへのデプロイ](/ja/actions/how-tos/deploy/deploy-to-third-party-platforms)」を参照してください。 * GitHubでのタスクとプロセスの自動化については、[GitHub Actions を使って作業を管理する](/ja/actions/tutorials/manage-your-work) を参照してください。 * GitHub Actionsのより複雑な機能を示す例については、[AUTOTITLE を](/ja/actions/how-tos/write-workflows/choose-what-workflows-do)参照してください。 これらの詳細な例では、ランナーでコードをテストし、 GitHub CLI にアクセスし、コンカレンシーやテスト マトリックスなどの高度な機能を使用する方法について説明します。 * GitHub Actionsを使用してワークフローを自動化し、開発を加速する能力を認定するには、GitHub ActionsでGitHub Certifications証明書を取得します。 詳細については、 [AUTOTITLE を](/ja/get-started/showcase-your-expertise-with-github-certifications/about-github-certifications)参照してください。