Skip to main content

自定义属性

自定义属性允许向存储库和组织添加结构化元数据,从而在 GitHub 环境中实现更好的组织、治理和自动化。

谁可以使用此功能?

Repository custom properties can be managed by organization owners and users with admin permissions to the repository. Organization custom properties can be managed by enterprise owners and users with the "Manage the Enterprise's custom properties definitions" permission.

什么是自定义属性?

自定义属性是可附加到 GitHub.com 中的存储库或组织的结构化元数据字段。 它们允许你使用合规性框架、数据敏感度或项目详细信息等信息来修饰存储库或组织。

一个企业最多可以有 100 个属性定义。 一个允许值列表最多可以有 200 个项目。

有两种类型的自定义属性:

  •         **存储库自定义属性**:附加到单个存储库的元数据。
    
  •         **组织自定义属性**:附加到企业内组织的元数据。
    

注意

组织自定义属性以公共预览版提供,可能会更改。 对于 GitHub Enterprise Server,此功能仅从版本 3.22 开始适用。

使用自定义属性有什么好处?

自定义属性提供改进的发现、自动化工作流、合规性跟踪、有针对性的策略强制实施和更好的报告功能,还可通过 规则集集成实现强大的治理。

存储库和组织自定义属性都可用作规则集的目标准则,允许基于元数据进行细粒度的策略实施。

如何添加和管理自定义属性?

通过 GitHub 的 REST API 可以完全支持自定义属性,从而实现编程管理和与外部系统的集成。 请参阅“自定义属性”。

可以通过 GitHub的 UI 添加自定义属性。 请参阅“管理组织中存储库的自定义属性”和“管理组织的自定义属性”。