Organization 内リポジトリのカスタム プロパティの管理

カスタム プロパティについて

カスタム プロパティは構造化されたメタデータ フィールドであり、GitHub のリポジトリと組織に追加して、環境全体の組織、ガバナンス、自動化を向上させることができます。「カスタム プロパティ」を参照してください。

この記事は、 リポジトリのカスタム プロパティに関連しています。

カスタム プロパティの 可視性 は、リポジトリの可視性と一致します。 パブリック リポジトリのカスタム プロパティはだれでも表示できますが、内部リポジトリまたはプライベート リポジトリのカスタム プロパティは、リポジトリに対する read アクセス許可を持つアカウントで表示できます。

使用できる文字

データ再利用可能リポジトリ.カスタムプロパティ許可文字 %}

カスタム プロパティの追加

Organization にカスタム プロパティを追加して、Organization 内リポジトリのこれらのプロパティの値を設定できます。

REST API を使用すると、組織向けのカスタム プロパティを作成して管理できます。 詳細については、「カスタム プロパティの REST API エンドポイント」を参照してください。

1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

2. 組織の隣の [設定] をクリックします。

3. 左側のサイドバーの "Code, planning, and automation" セクションで [ Repository] をクリックしてから、[Custom properties] をクリックします。

   

4. 新しいカスタム プロパティを追加するには、右上隅にある **[新しいプロパティ] ** をクリックします。

5. [名前] フィールドに、カスタム プロパティに使用する名前を入力します。 名前にはスペースを含めることはできません。また、75 文字以下にする必要があります。

6. 必要に応じて、"説明" フィールドにカスタム プロパティの説明を入力します。

7. [種類] で、追加するプロパティの種類を選択します。 これは、テキスト文字列, a single select field, a multi select field, または true/false のブール値 です。

8. 必要に応じて、[リポジトリ アクターがこのプロパティを設定することを許可する] を選択できます。 有効にすると、リポジトリ レベルの "カスタム プロパティ" の詳細に設定されたアクセス許可を持つリポジトリ ユーザーとアプリは、リポジトリのプロパティ値を設定および更新できます。

9. 必要に応じて、[すべてのリポジトリにこのプロパティを必須にする] を選択し、既定値を追加できます。 これを行った場合、Organization 内のすべてのリポジトリにこのプロパティの値が必須になりす。 このプロパティに明示的な値がないリポジトリは、既定値を継承します。

   • 必要に応じて、[ ユーザー指定の明示的な値を要求する] を選択できます。 このオプションを有効にすると、プロパティ値を設定する権限を持つユーザーとアプリは、プロパティの設定、リポジトリの作成、またはリポジトリの転送時に明示的な値を提供する必要があります。 まだ明示的な値を持たないリポジトリは、引き続き既定値を継承します。

10.        **[プロパティの保存]** をクリックします。
    

Organization 内リポジトリの値の設定

ご自身 と、"組織レベルでカスタム プロパティ値を編集する" アクセス許可を持つすべてのユーザーは、 が Organization のリポジトリのカスタム プロパティ値を設定できます。

1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

2. 組織の隣の [設定] をクリックします。

3. 左側のサイドバーの "Code, planning, and automation" セクションで [ Repository] をクリックしてから、[Custom properties] をクリックします。

   

4. [値を設定] タブをクリックします。

5. 一覧でリポジトリを 1 つ以上選んで、 [プロパティを編集] をクリックします。

   

6. 表示されるモーダル ダイアログで、選択したリポジトリに設定する各プロパティの値を選択します。 この値は、長さが 75 文字を超えることはできません。

7. [ 変更の保存] をクリックします。

Organization 内リポジトリの値の表示

リポジトリに対する読み取りアクセス許可を持つユーザーは、そのリポジトリのカスタム プロパティの値を閲覧できますが、それらの値を編集することはできません。

REST API を使用して、組織によってリポジトリに割り当てられたカスタム プロパティを一覧表示することもできます。 詳細については、「カスタム プロパティの REST API エンドポイント」を参照してください。

1. GitHub で、リポジトリのメイン ページに移動します。1. リポジトリ名の下にある [Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

   

2. サイドバーの [コードと自動化] セクションで、 [カスタム プロパティ] をクリックします。

カスタム プロパティ値でのリポジトリの検索とフィルター処理

カスタム プロパティ値を使用して Organization 内のリポジトリを検索できます。

1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。
2. Organizationの名前をクリックしてください。
3. 組織名の下にある [リポジトリ] をクリックします。
4. 検索バーに、Organization 内のすべてのカスタム プロパティのリストを表示するには、「prop」と入力し、検索するプロパティを選択します。