# ワークフロー状態バッジの追加
リポジトリにステータスバッジを表示して、ワークフローのステータスを示すことができます。
> \[!NOTE]
> GitHub Enterprise Server ホステッド ランナーは、現在 GitHub ではサポートされていません。
> \[!NOTE]
> プライベート リポジトリ内のワークフロー バッジには外部からアクセスできないため、外部サイトからそれらを埋め込んだり、リンクしたりすることはできません。
ステータスバッジは、ワークフローが現在失敗しているかパスしているかを示します。 ステータス バッジは、リポジトリの `README.md` ファイル内に追加するのが一般的ですが、どの Web ページにも追加することができます。 デフォルトでは、バッジはデフォルトブランチのステータスを示します。 既定のブランチでワークフローの実行がない場合は、すべてのブランチで最新の実行状態が表示されます。 特定のブランチやイベントのワークフロー実行のステータスを、URL 内の `branch` および `event` クエリ パラメーターを使用して表示することもできます。
ワークフロー状態バッジを `README.md` ファイルに追加するには、最初に表示したい状態バッジの URL を見つけます。 その後、Markdown を使って、`README.md` ファイル内に画像としてバッジを表示できます。 Markdown での画像のマークアップについては、「[基本的な書き込みと書式設定の構文](/ja/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images)」を参照してください。
## UI を使用する
ワークフロー ファイル名、ブランチ パラメーター、イベント パラメーターを使って、UI 上でワークフロー状態バッジを直接作成できます。
1. GitHub で、リポジトリのメイン ページに移動します。1. リポジトリ名の下にある **\[ Actions]** をクリックします。
!["github/docs" リポジトリのタブのスクリーンショット。 \[アクション\] タブがオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/actions-tab-global-nav-update.png)1. 左サイドバーで、表示するワークフローをクリックします。
![\[アクション\] タブの左側のサイド バーのスクリーンショット。ワークフロー "CodeQL" が濃いオレンジ色の枠線で囲まれています。](/assets/images/help/actions/superlinter-workflow-sidebar.png)
2. ページの右側に \[Filter workflow runs] フィールドがあり、その横にある をクリックしてドロップダウン メニューを表示し、**\[Create status badge]** をクリックします。
3. 既定のブランチとは異なるブランチの状態バッジを表示する場合は、必要に応じてブランチを選びます。
4. 必要に応じて、ワークフローをトリガーするイベントを選びます。
5. ** ステータスバッジのMarkdownをコピー**をクリックしてください。
6. Markdown を `README.md` ファイルにコピーします。
## ワークフローファイル名を使用する
ワークフロー ファイルの名前を使用して、ワークフロー状態バッジの URL を作成できます。
```text
HOSTNAME/OWNER/REPOSITORY/actions/workflows/WORKFLOW-FILE/badge.svg
```
`README.md` ファイル内にワークフロー状態バッジを表示するには、Markdown マークアップを使用して画像を埋め込みます。 Markdown での画像のマークアップについては、「[基本的な書き込みと書式設定の構文](/ja/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images)」を参照してください。
たとえば、次の Markdown を `README.md` ファイルに追加して、ファイル パスが `.github/workflows/main.yml` であるワークフローの状態バッジを追加します。 リポジトリの `OWNER` は `github` Organization であり、`REPOSITORY` 名は `docs` です。
```markdown
```
## `branch` パラメーターの使用
特定のブランチに関するワークフロー実行の状態を表示するには、状態バッジ URL の末尾に `?branch=BRANCH-NAME` を追加します。
たとえば、次の Markdown を `README.md` ファイルに追加して、`feature-1` という名前のブランチの状態バッジを表示します。
```markdown
```
## `event` パラメーターの使用
`push` イベントによってトリガーされるワークフロー実行の状態を表示するには、状態バッジ URL の末尾に `?event=push` を追加します。
たとえば、次の Markdown を `README.md` ファイルに追加して、`push` イベントによってトリガーされるワークフロー実行の状態を含むバッジを表示します。これにより、そのブランチの現在の状態に対してビルドの状態が表示されます。
```markdown
```