容器与云原生 / 系统课时

配置 HTTPS 证书

配置 HTTPS 证书

这一节完成一条可验证的 HTTPS 入口:为 app.example.com 准备证书与私钥,创建 Kubernetes TLS Secret,把证书绑定到 Ingress,并从客户端确认实际返回的证书确实覆盖该域名。

学习目标

  • 创建类型为 kubernetes.io/tls 的 Secret,并理解证书与私钥的对应关系。
  • 在 Ingress 的 spec.tls 中完成 HTTPS 终止配置。
  • 验证证书 SAN、Ingress 主机名和客户端访问域名三者是否一致。

前置检查

示例假设命名空间为 demo,其中已经存在名为 web、端口为 80 的 Service,并且集群中已经安装可处理该 Ingress 的控制器。域名 app.example.com 最终需要解析到 Ingress 控制器的入口地址;实验时也可以用 curl --resolve 临时指定地址。

先确认 Service 与 IngressClass:

bash
kubectl get service web -n demo
kubectl get ingressclass

预期输出:

text
NAME   TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
web    ClusterIP   <IP>         <none>        80/TCP    <TIME>

NAME    CONTROLLER                      PARAMETERS   AGE
nginx   k8s.io/ingress-nginx            <none>       <TIME>

实际的 IP、AGE 和 IngressClass 名称可能不同,后续清单中的 ingressClassName 必须填写你集群真实存在的类。

生成证书并创建 TLS Secret

实验环境可以先生成一张自签名证书。关键点不是 Common Name,而是证书的 Subject Alternative Name 必须包含客户端实际访问的域名。

bash
openssl req -x509 -nodes -newkey rsa:2048 -keyout tls.key -out tls.crt -days 30 -subj "/CN=app.example.com" -addext "subjectAltName=DNS:app.example.com"
kubectl create secret tls app-tls --cert=tls.crt --key=tls.key -n demo

预期输出:

text
secret/app-tls created

kubectl create secret tls 会校验证书和私钥能否作为 TLS 材料读取。生产环境通常由受信任 CA 或证书控制器签发证书,不应长期使用这里的自签名证书。

配置 Ingress 的 HTTPS 终止

TLS 终止发生在 Ingress 控制器:客户端与控制器建立 HTTPS,控制器解密后再把请求转发给后端 Service。secretName 引用的 Secret 必须与 Ingress 位于同一命名空间。

Ingress HTTPS 终止中的证书与流量关系

创建 ingress-https.yaml:

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: web-https
  namespace: demo
spec:
  ingressClassName: nginx
  tls:
    - hosts:
        - app.example.com
      secretName: app-tls
  rules:
    - host: app.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web
                port:
                  number: 80

应用并查看状态:

bash
kubectl apply -f ingress-https.yaml
kubectl get ingress web-https -n demo

预期输出:

text
ingress.networking.k8s.io/web-https created
NAME        CLASS   HOSTS             ADDRESS   PORTS     AGE
web-https   nginx   app.example.com   <IP>      80, 443   <TIME>

ADDRESS 可能需要一段时间才出现,也可能显示主机名而不是 IP。出现 443 说明对象声明了 TLS,但仍应继续验证控制器实际返回的证书。

验证证书和域名匹配

先直接检查本地证书的 SAN:

bash
openssl x509 -in tls.crt -noout -subject -ext subjectAltName

预期输出:

text
subject=CN = app.example.com
X509v3 Subject Alternative Name:
    DNS:app.example.com

再取得 Ingress 地址,并让 curl 在不修改 DNS 的情况下把域名解析到该地址。把 <IP> 替换成 kubectl get ingress 得到的入口 IP:

bash
curl --resolve app.example.com:443:<IP> --cacert tls.crt https://app.example.com/health

预期输出:

text
<BACKEND_RESPONSE>

只要 TLS 握手成功且没有出现主机名不匹配错误,就说明客户端访问域名与证书 SAN 匹配;响应正文由后端 /health 接口决定,因此这里用 <BACKEND_RESPONSE> 表示实际内容可能不同。

常见失败怎么定位

若出现 secret not found,先检查 Ingress 与 Secret 是否在同一命名空间;若控制器返回默认证书,检查 secretName 拼写和控制器事件;若浏览器提示域名不匹配,优先查看证书 SAN,而不是只看 CN。

bash
kubectl describe ingress web-https -n demo
kubectl get secret app-tls -n demo -o jsonpath='{.type}{"\n"}'

预期输出:

text
<INGRESS_DETAILS>
kubernetes.io/tls

<INGRESS_DETAILS> 中应能看到 TLS 主机、Secret 引用和控制器事件。完成这些检查后,HTTPS 是否可用就能被拆成三个独立问题:证书内容是否正确、Secret 是否被正确引用、入口域名是否真正到达该 Ingress。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 HTTPS 证书

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通