跳至主要内容

管理组织中存储库的自定义属性

使用自定义属性,可以向组织中的存储库添加元数据。你可以使用这些属性使用规则集定位存储库。

谁可以使用此功能?

组织所有者可以在组织级别添加和设置自定义属性模式。对存储库具有读取权限的人员可以查看该存储库的自定义属性值。

关于自定义属性

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

允许的字符

自定义属性名称和值只能包含特定字符

  • 名称: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.com 上,导航到存储库的主页。

  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 以查看组织中所有自定义属性的列表,然后选择要按其进行搜索的属性。