cert-manager

cert-manager 是一种自动执行证书管理的工具， 它可以与 Istio Gateway 集成以管理 TLS 证书。

配置

查阅 cert-manager 安装文档来快速开始， 它无需特殊配置即可与 Istio 一起使用。

使用

Istio Gateway

cert-manager 可用于向 Kubernetes 写入 Secret 秘钥，Gateway 可以引用该秘钥。 首先，请按照 cert-manager 文档中的说明配置 Certificate 资源。Certificate 应该创建在与 istio-ingressgateway Deployment 相同的命名空间。例如，一个 Certificate 可能看起来像下边这样：

apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: ingress-cert
  namespace: istio-system
spec:
  secretName: ingress-cert
  commonName: my.example.com
  dnsNames:
  - my.example.com
  ...

一旦创建了 Certificate 资源，我们就能在 istio-system 命名空间中看到创建的秘钥，接着就可以在 Gateway 的 tls 配置下的 cresentialName 字段中引用它：

apiVersion: networking.istio.io/v1alpha3
kind: Gateway
metadata:
  name: gateway
spec:
  selector:
    istio: ingressgateway
  servers:
  - port:
      number: 443
      name: https
      protocol: HTTPS
    tls:
      mode: SIMPLE
      credentialName: ingress-cert # 这应该与证书的 Secret 名称相匹配
    hosts:
    - my.example.com # 这应该与证书中的 DNS 名称相匹配

Kubernetes Ingress

cert-manager 通过 在 Ingress 对象上配置注解， 做到与 Kubernetes Ingress 的直接集成。如果使用此方法，则 Ingress 必须与 istio-ingressgateway Deployment 位于同一命名空间中，因为 Secret 只能在同一命名空间中被读取。

或者，也可以按照 Istio Gateway 部分的描述创建 Certificate，然后在 Ingress 对象中引用它：

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: ingress
  annotations:
    kubernetes.io/ingress.class: istio
spec:
  rules:
  - host: my.example.com
    http: ...
  tls:
  - hosts:
    - my.example.com # 这应该与证书中的 DNS 名称相匹配
    secretName: ingress-cert # 这应该与证书的 Secret 名称相匹配