跳至主要内容

管理组织中代码库的自定义属性

使用自定义属性,您可以向组织中的代码库添加元数据。您可以使用这些属性通过规则集定位代码库。

谁可以使用此功能?

组织所有者可以在组织级别添加和设置自定义属性模式。

关于自定义属性

自定义属性允许您使用合规性框架、数据敏感性或项目详细信息等信息来装饰您的代码库。自定义属性是私有的,只有具有代码库读取权限的人员才能查看。

允许的字符

自定义属性名称和值只能包含某些字符。

  • 名称:a-zA-Z0-9_-$#
  • 值:所有可打印的ASCII字符,除了"

添加自定义属性

您可以向您的组织添加自定义属性,并为组织中的代码库设置这些属性的值。

  1. 在 GitHub 的右上角,选择您的个人资料照片,然后单击 您的组织.

  2. 在组织旁边,单击**设置**。

  3. 在左侧边栏的“代码、规划和自动化”部分,单击** 代码库**,然后单击**自定义属性**。

    Screenshot of an organization's settings page. In the sidebar, a link labeled "Custom properties" is outlined in orange.

  4. 要添加新的自定义属性,请单击右上角的**新建属性**。

  5. 在“名称”字段中,键入您要用于自定义属性的名称。名称不能包含空格。

  6. 或者,在“描述”字段中,填写自定义属性的描述。

  7. 在“类型”下,选择要添加的属性类型。这可以是文本字符串、单选字段、多选字段或真/假布尔值。

  8. 或者,您可以选择**允许代码库参与者设置此属性**。启用后,具有代码库级别“自定义属性”细粒度权限的代码库用户和应用程序将能够为其代码库设置和更新属性值。

  9. 或者,您可以选择**对所有代码库强制要求此属性**并添加默认值。这意味着您要求组织中的所有代码库都为此属性具有值。没有为此属性设置显式值的代码库将继承默认值。

  10. 单击**保存属性**。

设置组织中代码库的值

您可以为组织中的代码库设置自定义属性的值。

  1. 在 GitHub 的右上角,选择您的个人资料照片,然后单击 您的组织.

  2. 在组织旁边,单击**设置**。

  3. 在左侧边栏的“代码、规划和自动化”部分,单击** 代码库**,然后单击**自定义属性**。

    Screenshot of an organization's settings page. In the sidebar, a link labeled "Custom properties" is outlined in orange.

  4. 单击“设置值”选项卡。

  5. 从列表中选择一个或多个代码库,然后单击 编辑属性.

    Screenshot the page to set values for repositories. A button, labeled with a pencil icon and "Edit properties", is highlighted with an orange outline.

  6. 在出现的模态对话框中,为要为选定代码库设置的每个属性选择一个值。

  7. 单击**保存更改**。

查看组织中代码库的值

具有代码库读取权限的人员可以查看该代码库的自定义属性值,但他们无法编辑这些值。

  1. 在 GitHub 上,导航到代码库的主页。

  2. 在您的代码库名称下,单击 **设置**。如果您看不到“设置”选项卡,请选择****下拉菜单,然后单击**设置**。

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. 在侧边栏的“代码和自动化”部分,单击** 自定义属性**。

按自定义属性值搜索和筛选代码库

您可以按自定义属性值搜索组织中的代码库。

  1. 在 GitHub 的右上角,选择您的个人资料照片,然后单击 您的组织.
  2. 单击您的组织名称。
  3. 在您的组织名称下,单击 代码库.
  4. 在搜索栏中,键入prop以查看组织中所有自定义属性的列表,然后选择要按其搜索的属性。