GitHub リポジトリに状態バッジを追加する

[アーティクル]
02/01/2025

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Markdown 構文を GitHub リポジトリ README.md ファイルに追加して、そのリポジトリにボードの状態を表示できます。ボード設定から選択した構文を追加して、状態を表示します。

Note

Azure DevOps Server 2019 Update 1 以降のバージョンが必要です。

表示される構文は、プロジェクトを GitHub.com または GitHub Enterprise Server リポジトリに接続したかどうかに関係なく機能します。 GitHub Enterprise Server の場合、Azure DevOps Services からサーバーにネットワークアクセスできる必要があります。

前提条件

カテゴリ	必要条件
アクセス許可	変更するチームの設定のチーム管理者またはプロジェクト管理者グループのメンバー。
GitHub との統合	プロジェクトを GitHub リポジトリ (リンクするコミットとプルリクエストが存在する) に接続します。
ボードの構成	構成したいボード。チームを追加するときは、そのチームのボードを追加します。詳細については、「チームとアジャイルツールについて」を参照してください。
リポジトリアクセス	GitHub.com リポジトリに状態バッジを追加するには: リポジトリへの共同作成者。

状態バッジを追加する

Azure Boards にサインインし、ボード開きます。
歯車アイコンを選び、ボードの構成と一般的なチーム設定を行います。
[状態バッジ] を選び、[匿名ユーザーにステータスバッジへのアクセスを許可する] をオンまたはオフにします。チェックを外しても、サインインしていないユーザーでも状態バッジを表示できます。
目的のバッジの種類を選び、コピーアイコンを選んでバッジの Markdown 構文をコピーします。
- [[進行中] 列のみを表示する] は、最初と最後の列を無視します。
- [すべての列を含める] は、ボードの最初と最後の列を含めます。
- また、columnOptions に 2 を指定し、表示するボード列のコンマ区切りリストを指定することで、列のセットをカスタマイズすることもできます。次の構文では、?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review という例が示されています。列ラベルにスペースが含まれる場合は、%20 でスペースをエンコードする必要があります。たとえば、In%20Progress のようにします。
```
 [![Board Status](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/_apis/work/boardbadge/6fa7b56f-d27c-4e96-957d-f9e7b0f56705?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review)](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/_boards/board/t/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/Microsoft.RequirementCategory/)
```
次のようなバッジが表示されます。
完了後、保存を選択します。

構成できる設定は、[匿名ユーザーに状態バッジへのアクセスを許可します] だけです。 [設定] のバッジの種類では、[サンプル Markdown] と [画像の URL] の値からコピーするための Markdown 構文が切り替わるだけです。
バッジを表示するには、GitHub リポジトリで README ファイルを開いて、コピーした構文を貼り付けます。

ボードに対応する値で選択したのと同じプレビューイメージが表示されます。