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

カスタムプロパティを使用すると、組織内のリポジトリにメタデータを追加できます。これらのプロパティを使用して、ルールセットを含むリポジトリをターゲットにすることができます。

この機能を使用できるユーザーについて

Organization owners and users with the "Manage the organization's custom properties definitions" permission can add and set a custom property schema at the organization level.

この記事の内容

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

カスタムプロパティを使用すると、コンプライアンスフレームワーク、データの機密性、プロジェクトの詳細などの情報でリポジトリを修飾できます。カスタムプロパティはプライベートであり、リポジトリに対する読み取りアクセス許可を持つユーザーのみが閲覧できます。

リポジトリのプロパティを使用して、ルールセットでターゲットにするリポジトリを決定できます。詳しくは、「組織内のリポジトリのルールセットを作成する」を参照してください。

使用できる文字

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

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

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

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

GitHub の右上隅で、プロフィール写真を選択し、 あなたの組織をクリックします。
組織の隣の [設定] をクリックします。
左のサイドバーの [コード、計画、自動化] セクションで、[ リポジトリ] をクリックし、 [カスタムプロパティ] をクリックします。
新しいカスタムプロパティを追加するには、右上隅にある **[新しいプロパティ] ** をクリックします。
"名前" フィールドに、カスタムプロパティに使用する名前を入力します。名前にスペースを含めることはできません。
必要に応じて、"説明" フィールドにカスタムプロパティの説明を入力します。
[種類] で、追加するプロパティの種類を選択します。これは、テキスト文字列、単一選択フィールド、複数選択フィールド、または true/false ブール値のいずれかです。
必要に応じて、[リポジトリアクターがこのプロパティを設定することを許可する] を選択できます。有効にすると、リポジトリレベルの "カスタムプロパティ" 詳細に設定されたアクセス許可を持つリポジトリユーザーとアプリは、リポジトリのプロパティ値を設定および更新できます。
必要に応じて、[すべてのリポジトリにこのプロパティを必須にする] を選択し、既定値を追加できます。こうすると、組織内のすべてのリポジトリにこのプロパティの値が必須になりす。このプロパティに明示的な値がないリポジトリは、既定値を継承します。
[プロパティの保存] をクリックします。

組織内リポジトリの値の設定

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

GitHub の右上隅で、プロフィール写真を選択し、 あなたの組織をクリックします。
組織の隣の [設定] をクリックします。
左のサイドバーの [コード、計画、自動化] セクションで、[ リポジトリ] をクリックし、 [カスタムプロパティ] をクリックします。
[値の設定] タブをクリックします。
リストから 1 つまたは複数のリポジトリを選択し、 [プロパティの編集] をクリックします。
表示されるモーダルダイアログで、選択したリポジトリに設定する各プロパティの値を選択します。
[変更を保存] をクリックします。

組織内リポジトリの値の表示

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

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