使用自定义属性可以利用合规性框架、数据敏感度或项目详细信息等信息修饰存储库。 自定义属性属于私有属性,只有对存储库具有读取权限的人员才能查看。 企业最多可以有 100 个属性定义。 允许值列表最多可以有 200 项。
通过在企业级定义自定义属性,可以创建用户可应用于仓库的一致值。 有了自定义属性,你就可以通过创建具有特定属性的仓库为目标仓库的规则集或仓库策略,对企业中的仓库应用一致的治理。
允许的字符
可重用数据.存储库.自定义属性允许的字符 %}
谁可以设置和查看我定义的自定义属性的值?
定义自定义属性后,用户就可以在企业的仓库中设置该属性的值。 请参阅“管理组织中存储库的自定义属性”。
- 企业所有者可以为所需的属性设置默认值。
- 组织所有者可以在其组织内在所有仓库或在单个仓库级别设置值。
- 如果启用,则具有仓库访问权限或
custom properties细化权限的人员就可以设置和更新其仓库的属性值。
对仓库具有读取权限的人员可以查看该仓库的自定义属性值。
此外,组织所有者还可以通过自定义属性值在其组织中搜索仓库。 请参阅“管理组织中存储库的自定义属性”。
添加自定义属性
可以将自定义属性添加到企业,使这些属性在所有组织中都可用。
-
导航到您的企业。 例如,从 GitHub.com 上的 公司 页面。
-
在左侧边栏中的“Policies”下,单击“Custom properties”****。
-
若要添加新的自定义属性,请单击右上角的“New property”****。
-
输入自定义属性的名称、描述和类型。 名称在所有组织中必须是唯一的,不能包含空格,并且长度不能超过 75 个字符。
-
(可选)选择允许存储库参与者设置此属性。 启用后,具有仓库级
custom properties细化权限的仓库用户和应用将能够设置和更新其仓库的属性值。 此外,任何创建仓库的行为者都可以在仓库上设置属性。 -
(可选)选择“将此属性应用于所有存储库”,并添加默认值。 这意味着你要求企业中的所有代码仓库都必须具有该属性的值。 若存储库此属性没有显式值,则继承默认值。
- (可选)可以选择 “需要显式用户指定的值”。 启用此选项后,有权设置属性值的用户和应用必须在设置属性、创建存储库或传输存储库时提供显式值。 尚未具有显式值的存储库仍将继承默认值。
-
单击“保存属性”****。
后续步骤
根据存储库的自定义属性将策略应用到存储库。 请参阅“为企业中的存储库定义策略”。