{"meta":{"title":"GitHub Actionsのクイック スタート","intro":"GitHub Actions のコア機能を数分で試すことができます。","product":"GitHub Actions","breadcrumbs":[{"href":"/ja/enterprise-server@3.20/actions","title":"GitHub Actions"},{"href":"/ja/enterprise-server@3.20/actions/get-started","title":"概要"},{"href":"/ja/enterprise-server@3.20/actions/get-started/quickstart","title":"クイック スタート"}],"documentType":"article"},"body":"# GitHub Actionsのクイック スタート\n\nGitHub Actions のコア機能を数分で試すことができます。\n\n> \\[!NOTE]\n> GitHub ホステッド ランナーは、現在 GitHub Enterprise Server ではサポートされていません。\n\n## はじめに\n\nGitHub Actions は、ビルド、テスト、デプロイのパイプラインを自動化できる継続的インテグレーションと継続的デリバリー (CI/CD) のプラットフォームです。 リポジトリに変更をプッシュするたびにテストを実行するワークフロー、またはマージされた pull request を運用環境にデプロイしたりするワークフローを作成できます。\n\nこのクイックスタート ガイドでは、GitHub のユーザー インターフェイスを使用して、GitHub Actions の重要な機能の一部を示すワークフローを追加する方法について説明します。\n\n事前構成済みワークフローの使用を開始するには、 [actions/starter-workflows](https://github.com/actions/starter-workflows) リポジトリ内のテンプレートの一覧を参照します。 詳しくは、「[ワークフロー テンプレートの使用](/ja/enterprise-server@3.20/actions/writing-workflows/using-starter-workflows)」をご覧ください。\n\nGitHub Actions ワークフローの概要については、「[ワークフロー](/ja/enterprise-server@3.20/actions/using-workflows/about-workflows)」をご覧ください。 GitHub Actions を構成するさまざまなコンポーネントについては、「[GitHub Actionsについて](/ja/enterprise-server@3.20/actions/learn-github-actions/understanding-github-actions)」をご覧ください。\n\n## ワークフロー テンプレートの使用\n\nGitHub には、独自のワークフローを作成するためにそのまま使える、もしくはカスタマイズできる事前構成済みのワークフロー テンプレートが用意されています。 GitHub を使うと、コードを分析し、自分のリポジトリに役立つ可能性のあるワークフロー テンプレートを表示することができます。 たとえばリポジトリにNode.jsのコードが含まれているなら、Node.jsプロジェクトのためのサジェッションが提示されます。\n\nこれらのワークフロー テンプレートは、すぐに起動して実行できるように設計されており、次のようなさまざまな構成が提供されます。\n\n* CI: [継続的インテグレーション ワークフロー](https://github.com/actions/starter-workflows/tree/main/ci)\n* デプロイ: [デプロイ ワークフロー](https://github.com/actions/starter-workflows/tree/main/deployments)\n* 自動化: [自動ワークフロー](https://github.com/actions/starter-workflows/tree/main/automation)\n* コード スキャン: [Code スキャン ワークフロー](https://github.com/actions/starter-workflows/tree/main/code-scanning)\n* ページ: [ページ ワークフロー](https://github.com/actions/starter-workflows/tree/main/pages)\n\nこれらのワークフローを、カスタム ワークフローの構築の出発点として使用するか、そのまま利用します。 ワークフロー テンプレートの詳細な一覧は、[actions/starter-workflows](https://github.com/actions/starter-workflows) リポジトリで参照できます。\n\n## 前提条件\n\nこのガイドは、以下の読者を対象としています。\n\n* GitHub の使用方法について少なくとも基本的な知識があること。 まだお読みになっていない場合、リポジトリと pull request (プル リクエスト) に関するドキュメントの記事を最初にお読みになると役に立ちます。 たとえば、「[リポジトリのクイック スタート](/ja/enterprise-server@3.20/repositories/creating-and-managing-repositories/quickstart-for-repositories)」、「[ブランチの概要](/ja/enterprise-server@3.20/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches)」、「[pull requests について](/ja/enterprise-server@3.20/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)」をご覧ください。\n* ファイルを追加できるリポジトリが GitHub にあります。\n* GitHub Actions にアクセスできます。\n\n > \\[!NOTE]\n > **\\[ Actions]** タブが GitHub のリポジトリ名の下に表示されない場合、これはリポジトリでActionsが無効になっている可能性があります。 詳しくは、「[リポジトリのGitHub Actions設定の管理](/ja/enterprise-server@3.20/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)」をご覧ください。\n\n## 最初のワークフローを作成する\n\n1. GitHub のリポジトリで、`github-actions-demo.yml` ディレクトリに `.github/workflows` というワークフロー ファイルを作成します。 手順は次のとおりです。\n \\*\n `.github/workflows` ディレクトリが既に存在する場合は、GitHub のそのディレクトリに移動し、**\\[ファイルの追加]** をクリックし、**\\[新しいファイルの作成]** をクリックして、ファイルに「`github-actions-demo.yml`」という名前を付けます。\n * リポジトリに `.github/workflows` ディレクトリがない場合は、GitHub のリポジトリのメイン ページに移動し、**\\[ファイルの追加]** をクリックして、**\\[新しいファイルの作成]** をクリックし、ファイルに「`.github/workflows/github-actions-demo.yml`」という名前を付けます。 これにより、 1 つの手順で `.github` および `workflows` ディレクトリと `github-actions-demo.yml` ファイルが作成されます。\n > \\[!NOTE]\n > GitHub でリポジトリ内の GitHub Actions ワークフローを検出するには、ワークフロー ファイルを「`.github/workflows`」という名前のディレクトリに保存する必要があります。\n >\n > ワークフロー ファイルには任意の名前を付けることができますが、ファイル名の拡張子として `.yml` または `.yaml` を使用する必要があります。 YAML は、構成ファイルでよく使用されるマークアップ言語です。\n\n2. 次の YAML コンテンツを `github-actions-demo.yml` ファイルにコピーします。\n\n ```yaml copy\n name: GitHub Actions Demo\n run-name: ${{ github.actor }} is testing out GitHub Actions 🚀\n on: [push]\n jobs:\n Explore-GitHub-Actions:\n runs-on: ubuntu-latest\n steps:\n - run: echo \"🎉 The job was automatically triggered by a ${{ github.event_name }} event.\"\n - run: echo \"🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!\"\n - run: echo \"🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}.\"\n - name: Check out repository code\n uses: actions/checkout@v5\n - run: echo \"💡 The ${{ github.repository }} repository has been cloned to the runner.\"\n - run: echo \"🖥️ The workflow is now ready to test your code on the runner.\"\n - name: List files in the repository\n run: |\n ls ${{ github.workspace }}\n - run: echo \"🍏 This job's status is ${{ job.status }}.\"\n ```\n\n この段階では、このワークフローの詳細を理解する必要はありません。 ここでは、内容をコピーしてファイルに貼り付けることができます。 このクイックスタートガイドを完了した後、[ワークフロー](/ja/enterprise-server@3.20/actions/using-workflows/about-workflows#understanding-the-workflow-file)におけるワークフローファイルの構文を学ぶことができます。「`${{ github.actor }}`」や「`${{ github.event_name }}`」のようなGitHub Actionsのコンテキストについての説明は、「[コンテキスト リファレンス](/ja/enterprise-server@3.20/actions/learn-github-actions/contexts)」をご覧ください。\n\n3. ```\n **[Commit changes]** をクリックします。\n ```\n\n4. \\[変更の提案] ダイアログで、既定のブランチにコミットするオプション、または新しいブランチを作成して pull request を開始するオプションを選択します。 次に、**\\[変更のコミット]** または **\\[変更の提案]** をクリックします。\n\n ![言及されている領域がオレンジ色の枠で強調表示されている \\[変更の提案\\] ダイアログのスクリーンショット。](/assets/images/help/repository/actions-quickstart-commit-new-file.png)\n\nリポジトリ内のワークフローファイルをブランチにコミットすると、`push` イベントがトリガーされ、ワークフローが実行されます。\n\npull request を開始することを選択した場合は、引き続きプル要求を作成できますが、コミットはブランチに対してまだ行われ、新しいワークフローがトリガーされるため、このクイックスタートの目的では必要ありません。\n\n## ワークフローの結果を表示する\n\n1. GitHub で、リポジトリのメイン ページに移動します。\n\n2. リポジトリ名の下にある **\\[ Actions]** をクリックします。\n\n ![\"github/docs\" リポジトリのタブのスクリーンショット。 \\[アクション\\] タブがオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/actions-tab-global-nav-update.png)\n\n3. 左側のサイドバーで、表示するワークフローをクリックします。この例では、\"GitHub Actions デモ\" です。\n\n ![\\[アクション\\] ページのスクリーンショット。 サンプル ワークフローの名前 \"GitHub Actions Demo\" は、濃いオレンジ色のアウトラインで強調表示されています。](/assets/images/help/repository/actions-quickstart-workflow-sidebar.png)\n\n4. ワークフロー実行の一覧から、確認したい実行の名前をクリックします。この例では、「USERNAMEがGitHub Actionsをテストしています。」\n\n5. ワークフロー実行ページの左側のサイドバーの **Jobs** で、**Explore-GitHub-Actions** ジョブをクリックします。\n\n ![\\[ワークフローの実行\\] ページのスクリーンショット。 左側のサイドバーで、\"Explore-GitHub-Actions\" ジョブが濃いオレンジ色のアウトラインで強調表示されています。](/assets/images/help/repository/actions-quickstart-job.png)\n\n6. ログには、各ステップの処理方法が表示されます。 いずれかのステップを展開して、詳細を表示します。\n\n \n\n たとえば、リポジトリ内のファイルのリストを確認できます。\n\n \n\n追加したワークフロー例では、コードがブランチにプッシュされるたびにトリガーされ、GitHub Actions がリポジトリのコンテンツを処理できる方法が示されます。 詳しいチュートリアルについては、「[GitHub Actionsについて](/ja/enterprise-server@3.20/actions/learn-github-actions/understanding-github-actions)」をご覧ください。\n\n## 次のステップ\n\nGitHub Actions は、アプリケーション開発プロセスのほぼすべての要素を自動化するのに役立ちます。 使い始める準備はできていますか。 GitHub Actions で次のステップに進む際に役立つ、以下のようなリソースを参照してください。\n\n* GitHub Actions ワークフローを作成するには、「[ワークフロー テンプレートの使用](/ja/enterprise-server@3.20/actions/learn-github-actions/using-starter-workflows)」を参照してください。\n* 継続的インテグレーション (CI) ワークフローについては、「[コードのビルドとテスト](/ja/enterprise-server@3.20/actions/automating-builds-and-tests)」を参照してください。\n* パッケージのビルドと公開については、「[パッケージを公開する](/ja/enterprise-server@3.20/actions/publishing-packages)」を参照してください。\n* プロジェクトの配置については、「[サード パーティ製プラットフォームへのデプロイ](/ja/enterprise-server@3.20/actions/deployment)」を参照してください。\n* GitHub でタスクとプロセスを自動化する方法については、「[GitHub Actions を使って作業を管理する](/ja/enterprise-server@3.20/actions/managing-issues-and-pull-requests)」を参照してください。\n* GitHub Actions のより複雑な機能を示す例については、「[GitHub Actions を使って作業を管理する](/ja/enterprise-server@3.20/actions/examples)」を参照してください。 これらの詳細な例では、ランナーでコードをテストする方法、GitHub CLI にアクセスする方法、コンカレンシーやテスト マトリックスなどの高度な機能を使用する方法を説明しています。"}