{"meta":{"title":"ワークフロー状態バッジの追加","intro":"リポジトリにステータスバッジを表示して、ワークフローのステータスを示すことができます。","product":"GitHub Actions","breadcrumbs":[{"href":"/ja/enterprise-cloud@latest/actions","title":"GitHub Actions"},{"href":"/ja/enterprise-cloud@latest/actions/how-tos","title":"方法"},{"href":"/ja/enterprise-cloud@latest/actions/how-tos/monitor-workflows","title":"ワークフローを監視する"},{"href":"/ja/enterprise-cloud@latest/actions/how-tos/monitor-workflows/add-a-status-badge","title":"状態バッジを追加する"}],"documentType":"article"},"body":"# ワークフロー状態バッジの追加\n\nリポジトリにステータスバッジを表示して、ワークフローのステータスを示すことができます。\n\n> \\[!NOTE]\n> プライベート リポジトリ内のワークフロー バッジには外部からアクセスできないため、外部サイトからそれらを埋め込んだり、リンクしたりすることはできません。\n\nステータスバッジは、ワークフローが現在失敗しているかパスしているかを示します。 ステータス バッジは、リポジトリの `README.md` ファイル内に追加するのが一般的ですが、どの Web ページにも追加することができます。 デフォルトでは、バッジはデフォルトブランチのステータスを示します。 既定のブランチでワークフローの実行がない場合は、すべてのブランチで最新の実行状態が表示されます。 特定のブランチやイベントのワークフロー実行のステータスを、URL 内の `branch` および `event` クエリ パラメーターを使用して表示することもできます。\n\n![ワークフローの状態バッジのスクリーンショット。 右から左に、GitHub のロゴ、ワークフロー名 (\"GitHub Actions Demo\")、状態 (\"passing\") が表示されています。](/assets/images/help/repository/actions-workflow-status-badge.png)\n\nワークフロー状態バッジを `README.md` ファイルに追加するには、最初に表示したい状態バッジの URL を見つけます。 その後、Markdown を使って、`README.md` ファイル内に画像としてバッジを表示できます。 Markdown での画像のマークアップについては、「[基本的な書き込みと書式設定の構文](/ja/enterprise-cloud@latest/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images)」を参照してください。\n\n## UI を使用する\n\nワークフロー ファイル名、ブランチ パラメーター、イベント パラメーターを使って、UI 上でワークフロー状態バッジを直接作成できます。\n\n1. GitHub で、リポジトリのメイン ページに移動します。1. リポジトリ名の下にある **\\[<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-play\" aria-label=\"play\" role=\"img\"><path d=\"M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z\"></path></svg> Actions]** をクリックします。\n\n   ![\"github/docs\" リポジトリのタブのスクリーンショット。 \\[アクション\\] タブがオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/actions-tab-global-nav-update.png)1. 左サイドバーで、表示するワークフローをクリックします。\n\n   ![\\[アクション\\] タブの左側のサイド バーのスクリーンショット。ワークフロー \"CodeQL\" が濃いオレンジ色の枠線で囲まれています。](/assets/images/help/actions/superlinter-workflow-sidebar.png)\n2. ページの右側に \\[Filter workflow runs] フィールドがあり、その横にある <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-kebab-horizontal\" aria-label=\"Show workflow options\" role=\"img\"><path d=\"M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path></svg> をクリックしてドロップダウン メニューを表示し、**\\[Create status badge]** をクリックします。\n3. 既定のブランチとは異なるブランチの状態バッジを表示する場合は、必要に応じてブランチを選びます。\n4. 必要に応じて、ワークフローをトリガーするイベントを選びます。\n5. **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copy\" aria-label=\"copy\" role=\"img\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"></path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"></path></svg> ステータスバッジのMarkdownをコピー**をクリックしてください。\n6. Markdown を `README.md` ファイルにコピーします。\n\n## ワークフローファイル名を使用する\n\nワークフロー ファイルの名前を使用して、ワークフロー状態バッジの URL を作成できます。\n\n```text\nhttps://github.com/OWNER/REPOSITORY/actions/workflows/WORKFLOW-FILE/badge.svg\n```\n\n`README.md` ファイル内にワークフロー状態バッジを表示するには、Markdown マークアップを使用して画像を埋め込みます。 Markdown での画像のマークアップについては、「[基本的な書き込みと書式設定の構文](/ja/enterprise-cloud@latest/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images)」を参照してください。\n\nたとえば、次の Markdown を `README.md` ファイルに追加して、ファイル パスが `.github/workflows/main.yml` であるワークフローの状態バッジを追加します。 リポジトリの `OWNER` は `github` Organization であり、`REPOSITORY` 名は `docs` です。\n\n```markdown\n![example workflow](https://github.com/github/docs/actions/workflows/main.yml/badge.svg)\n```\n\n## `branch` パラメーターの使用\n\n特定のブランチに関するワークフロー実行の状態を表示するには、状態バッジ URL の末尾に `?branch=BRANCH-NAME` を追加します。\n\nたとえば、次の Markdown を `README.md` ファイルに追加して、`feature-1` という名前のブランチの状態バッジを表示します。\n\n```markdown\n![example branch parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?branch=feature-1)\n```\n\n## `event` パラメーターの使用\n\n`push` イベントによってトリガーされるワークフロー実行の状態を表示するには、状態バッジ URL の末尾に `?event=push` を追加します。\n\nたとえば、次の Markdown を `README.md` ファイルに追加して、`push` イベントによってトリガーされるワークフロー実行の状態を含むバッジを表示します。これにより、そのブランチの現在の状態に対してビルドの状態が表示されます。\n\n```markdown\n![example event parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?event=push)\n```"}