如何使用decK向Kong上传新证书？解决id必填报错

核心原因与解决思路 #

出现该错误是因为开启_transform: true时，decK的声明式管理模式要求每个资源必须有唯一标识id；而Kong Admin API属于命令式操作，会自动生成id，因此无需手动指定。你可以通过以下两种方式解决：

方案1：手动添加自定义ID #

在kong.yml的证书条目里添加唯一的id字段（字符串格式，只要不重复即可），修改后的配置如下：

_format_version: "2.1"
_transform: true

certificates:
  - id: "example-local-cert"  # 自定义唯一ID，可自行命名
    cert: |
      -----BEGIN CERTIFICATE-----
      ...你的证书内容...
      -----END CERTIFICATE-----
    key: |
      -----BEGIN RSA PRIVATE KEY-----
      ...你的密钥内容...
      -----END RSA PRIVATE KEY-----
    snis:
      - example.local
    tags:
      - example

添加ID后，decK会用这个标识管理证书资源，后续同步时不会重复创建，符合声明式管理的要求。

方案2：关闭_transform模式 #

如果不想手动指定ID，直接将_transform: true改为_transform: false，让decK以命令式模式同步（和Admin API行为一致），Kong会自动生成ID：

_format_version: "2.1"
_transform: false

certificates:
  - cert: |
      -----BEGIN CERTIFICATE-----
      ...你的证书内容...
      -----END CERTIFICATE-----
    key: |
      -----BEGIN RSA PRIVATE KEY-----
      ...你的密钥内容...
      -----END RSA PRIVATE KEY-----
    snis:
      - example.local
    tags:
      - example

注意：关闭_transform后，decK的声明式特性（如资源依赖检查、状态对比）会受限，适合快速创建资源的场景。

验证同步结果 #

执行同步命令后，用以下API检查证书是否成功创建：

curl http://localhost:8001/certificates?tags=example

返回结果中包含你的证书信息，即说明同步成功。

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