如何通过Bitbucket Datacenter REST API创建签名标签？

问题说明 #

使用Bitbucket Server的REST API创建Tag时，收到错误提示：

Signed commits and tags are enforced for this repository.

官方文档未提及如何通过API实现Tag签名，且无法用完整Git客户端克隆仓库的方式进行大规模批量操作。

已验证的解决方法 #

1. 在API请求体中直接传入签名后的Tag数据 #

Bitbucket的REST API其实支持接收已签名的Tag对象，只是文档未明确说明。步骤如下：

• 本地按照Git规范构造Tag内容，包含目标提交哈希、Tag名称、标签信息等，然后用GPG对这段内容签名。
• 将完整的签名Tag数据（包含object、type、tag、tagger、message、signature字段）作为JSON请求体发送到创建Tag的API端点。

示例请求体：

{
  "object": "a1b2c3d4e5f67890abcdef1234567890abcdef12",
  "type": "commit",
  "tag": "v2.1.0",
  "tagger": {
    "name": "John Doe",
    "email": "john.doe@company.com",
    "date": "2024-05-20T14:30:00Z"
  },
  "message": "Production release v2.1.0",
  "signature": "-----BEGIN PGP SIGNATURE-----\nVersion: GnuPG v2\n\n...（完整签名内容）\n-----END PGP SIGNATURE-----"
}

2. 利用Bitbucket内部非公开API（需注意版本兼容） #

部分开发者测试发现，Bitbucket Server存在未公开的内部端点，可直接提交已签名的Tag对象。但这类端点不属于官方支持范围，不同Bitbucket版本可能存在差异，使用前需在测试环境验证适配性。

3. 临时放宽仓库签名要求（应急方案） #

如果是短期大规模操作，可临时关闭仓库的「强制签名提交和标签」设置，完成Tag创建后立即重新开启。此方法仅适合应急，操作期间需注意仓库的提交安全。

关键注意点 #

• 确保GPG签名符合Git的格式规范，Bitbucket会严格验证签名的有效性，包括签名者的公钥是否已在Bitbucket中配置。
• 非公开API无官方维护，升级Bitbucket版本后需重新测试可用性。

内容的提问来源于stack exchange，提问作者aboukhal