一、命名
当前 PR 的涉及的 changelog 日志,应该提交在.changelog目录下,名称为{PR-NUMBER}.txt。例如,PR 的 Number 是1326,则应该有一个名为.changelog/1326.txt的变更日志。
二、格式
changelog.txt格式如下,其中{HEADER}为对应 changelog 类别,{ENTRY} 为对应 changelog 的详细内容。
“`release-note:{HEADER}{ENTRY}“`
如果一个拉取请求应该包含多个变更日志条目,那么可以将多个块添加到同一个变更日志文件中。例如:
“`release-note:bugresource/tencentcloud_teo_zone: change tag description from zoneName to zoneId.“`“`release-note:enhancementresource/tencentcloud_redis_instance: support update `security_groups`.“`
三、变更日志规则分类
CHANGELOG 旨在显示对特定版本的代码库影响操作员的更改。如果对代码的每一次更改或提交都会导致一个条目,那么 CHANGELOG 对操作员的用处就会降低。以下列表是需要做出决定以决定更改是否应具有条目的一般准则和示例。
四、新资源
一个新的资源,它的变更日志应该只包含资源的名称,并使用 release-note:new-resource 标题。
“`release-note:new-resourcetencentcloud_postgresql_instance“`
五、新数据源
一个新的数据源,它的变更应该只包含数据源的名称,并使用 release-note:new-data-source 标题。
“`release-note:new-data-sourcetencentcloud_sqlserver_zone_config“`
六、问题修复
一个新的问题修复,它的变更应该使用 release-note:bug 标题,并有一个前缀指示它对应的资源或数据源,一个冒号,然后是一个简短的摘要。
注意:说明:
注意:如果是 Provider 级别的修复,使用 provider 前缀。
“`release-note:bugresource/tencentcloud_cdn_domain: Fix `https_config` inconsistency after apply“`
七、功能增强
一个新的功能增强,它的变更应该使用release-note:enhancement标题,并有一个前缀指示它对应的资源或数据源,一个冒号,然后是一个简短的摘要。
注意:说明:
注意:如果是 Provider 级别的功能增强,使用 provider 前缀。
“`release-note:enhancementresource/tencentcloud_cdn_domain: Support follow redirect and authentication“`
八、功能弃用
一个功能弃用,它的变更应该使用release-note:deprecation标题,并有一个前缀指示它对应的资源或数据源,一个冒号,然后是一个简短的摘要。
注意:说明:
注意:如果是 Provider 级别的功能弃用,需要使用 provider 前缀。
“`release-note:deprecationresource/tencentcloud_kubernetes_cluster: The `as_enabled` attribute is being deprecated.“`
九、不需要提交变更日志的情况
·资源和提供者文档更新
·测试更新
·代码重构