创建TLS Secret需满足三条件:证书和私钥须base64编码后存入Data,键名为"tls.crt"和"tls.key",Type设为v1.SecretTypeTLS;CN须与Ingress hosts完全一致;Secret的Namespace、Name及Certificate资源中secretName必须严格匹配。

直接用 client-go 创建 TLS 类型的 Secret,核心就三件事:证书和私钥必须是 base64 编码后的 []byte,Data 字段里键名必须是 "tls.crt" 和 "tls.key",Type 必须设为 v1.SecretTypeTLS。漏掉任一条件,Ingress 就无法识别或 cert-manager 拒绝续签。
生成自签名证书文件时注意 CN 和有效期
OpenSSL 命令本身不复杂,但字段填错会导致证书被浏览器或 Ingress controller 拒绝:
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout tls.key -out tls.crt -subj "/CN=api.example.com"- CN 必须与 Ingress 中
hosts字段完全一致(大小写敏感),比如api.example.com不能写成API.EXAMPLE.COM -
-nodes是必须的,否则私钥带密码,Kubernetes 无法读取 - 有效期别设太短(如 7 天),cert-manager 自动续签前会提前 30 天触发,太短容易断连
v1.Secret.Data 的值必须是 base64 编码字节切片
这是 Go 代码里最常踩的坑:很多人直接把原始证书字符串塞进 Data,Kubernetes 不报错,但 Ingress 会静默失败,日志里只显示 “no TLS certificate found”。
- 证书内容要先读取为
[]byte,再用base64.StdEncoding.EncodeToString()编码成字符串,最后转回[]byte - 正确写法:
data["tls.crt"] = []byte(base64.StdEncoding.EncodeToString(certBytes)) - 错误写法:
data["tls.crt"] = certBytes(原始二进制)或data["tls.crt"] = []byte(string(certBytes))(强制 UTF-8 转换,会损坏数据) - 两个 key 缺一不可:
"tls.crt"和"tls.key",拼错(比如写成"cert")会导致 Secret 创建成功但无效
创建 Secret 时必须显式指定 Namespace 和 Type
空 namespace、默认 namespace 或类型写错,都会让 Secret 创建成功但无法被 Ingress 引用:
-
Namespace字段不能为空字符串,必须明确传入,比如"default"或"production" -
Type必须设为v1.SecretTypeTLS,不是v1.SecretTypeOpaque—— 后者虽然也能存,但 cert-manager 和 nginx-ingress 不认 - Ingress 中的
secretName必须和这里创建的Name完全一致,且在同一个 namespace 下 - 如果要用 cert-manager 自动管理,这个 Secret 名必须和你后续定义的
Certificate资源中spec.secretName保持一致
真正难的不是写几行 Go 代码,而是证书链、命名空间、Ingress 配置、cert-manager 的 Certificate 资源这四者之间必须严丝合缝——任何一个地方大小写、路径、字段名对不上,HTTPS 就会变成 503 或连接被重置,而且错误日志往往只提示“no secret”,不会告诉你哪一层断了。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











