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

[アーティクル]
11/22/2024

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 からサーバーにネットワークアクセスできる必要があります。

前提条件

アクセス許可: 変更するチームの設定のチーム管理者または Project Administrators グループのメンバーになります。
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 ファイルを開いて、コピーした構文を貼り付けます。

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