Skip to main content

此版本的 GitHub Enterprise Server 将于以下日期停止服务 2026-08-25. 已停止发布的版本不受支持。 即使针对重大安全问题,也不会发布补丁。 若要获得更好的性能、改进的安全性和 GitHub Enterprise Server 中的新功能,请参阅升级过程的 Overview。 如需升级帮助,请联系 GitHub Enterprise 支持。

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

借助自定义属性,可将元数据添加到组织中的存储库。 可以使用这些属性将包含规则集的存储库作为目标。

谁可以使用此功能?

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.

关于自定义属性

自定义属性是结构化元数据字段,你可以添加到 GitHub 中的存储库和组织,以便在整个环境中实现更好的组织、治理和自动化。

本文与 存储库自定义属性相关。

自定义属性的 可见性 与存储库的可见性匹配。 公共存储库上的自定义属性可由任何人查看,而具有 read 存储库权限的帐户可以查看内部或专用存储库上的自定义属性。

允许的字符

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

  • 名称:a-z、、A-Z0-9``_``-、、$#
  • 值:除 " 之外的所有可打印 ASCII 字符

添加自定义属性

可以将自定义属性添加到组织,并为组织中的存储库设置属性值。

  1. 在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。

  2. 单击以选择一个组织。

  3. 在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  4. 在左边栏的“Code, planning, and automation”部分,单击“ Repository”,然后单击“Custom properties”********。

    组织的设置页面的屏幕截图。 在边栏中,标有“自定义属性”的链接以橙色标出。

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

  6. 在“名称”字段中键入要用于自定义属性的名称。 名称不能包含空格,长度不能超过 75 个字符。

  7. (可选)在“描述”字段中填写自定义属性的描述。

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

  9. (可选)可以选择“允许存储库执行者设置此属性”****。 启用后,具有存储库级别“自定义属性”细化权限的存储库用户和应用将能够为其存储库设置和更新属性值。

  10. (可选)可以选择“所有存储库均需具有此属性”****,并添加默认值。 这意味着组织中的所有存储库此属性均需具有值。 若存储库此属性没有显式值,则继承默认值。

  11. 单击“保存属性”****。

为组织中的存储库设置值

你和具有“在组织级别编辑自定义属性值”权限 的任何用户都可以为组织中的存储库设置自定义属性的值。

  1. 在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。

  2. 单击以选择一个组织。

  3. 在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  4. 在左边栏的“Code, planning, and automation”部分,单击“ Repository”,然后单击“Custom properties”********。

    组织的设置页面的屏幕截图。 在边栏中,标有“自定义属性”的链接以橙色标出。

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

  6. 从列表中选择一个或多个存储库,然后单击“ 编辑属性”。

    存储库设置值的页面屏幕截图。 标有铅笔图标和“编辑属性”的按钮以橙色边框突出显示。

  7. 在出现的模式对话框中选择要为选定存储库设置的属性值。 此值长度不能超过 75 个字符。

  8. 单击“保存更改”。

查看组织中存储库的值

对存储库具有读取权限的人员可以查看存储库自定义属性的值但无法对其进行编辑。

  1. 在 GitHub 上,导航到存储库的主页面。

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

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

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

按自定义属性值搜索和筛选存储库

可以按自定义属性值搜索组织中的存储库。

  1. 在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。
  2. 单击您的组织名称。
  3. 在组织名称下,单击“ 存储库”。
  4. 在搜索栏中键入 prop 查看组织自定义属性的完整列表,然后选择要作为搜索条件的属性。