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

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

          カスタム プロパティは構造化されたメタデータ フィールドであり、GitHub のリポジトリと組織に追加して、環境全体の組織、ガバナンス、自動化を向上させることができます。
          
          [「AUTOTITLE」を](/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/custom-properties)参照してください。

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

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

使用できる文字

カスタム プロパティの名前と値には、特定の文字のみを含めることができます。

• 名前: a-z、 A-Z、 0-9、 _、 -、 $、 #
• 値: 印刷可能なすべての ASCII 文字 (ただし、 "

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

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

          REST API を使用して、組織のカスタム プロパティを作成および管理することもできます。 詳細については、 [AUTOTITLE を](/rest/orgs/custom-properties)参照してください。

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

2. 組織をクリックして選択します。

3. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

   

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

   

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

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

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

8. [種類] で、追加するプロパティの種類を選択します。 これは、テキスト文字列、1 つの選択フィールド、複数選択フィールド、 または true/false ブール値のいずれかです。

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

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

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

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

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

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

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

2. 組織をクリックして選択します。

3. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

   

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

   

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

6. 一覧から 1 つ以上のリポジトリを選択し、[プロパティの編集] クリックします。

   

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

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

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

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

          REST API を使用して、組織によってリポジトリに割り当てられたカスタム プロパティを一覧表示することもできます。 詳細については、 [AUTOTITLE を](/rest/repos/custom-properties)参照してください。

1. GitHub で、リポジトリのメイン ページに移動します。

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

   

3. サイドバーの[コードとオートメーション]セクションで、[カスタムプロパティ クリックします。

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

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

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