文档

cert-manager

使用 cert-manager 进行 TLS 证书管理

本指南将向您展示如何安装 cert-manager 以进行 TLS 证书管理。本指南假设安装了新的或全新的 MinIO 运算符。

注意

本指南使用自签名Cluster Issuer。您也可以使用cert-manager 支持的其他颁发者

主要区别在于,您必须将该Issuer CA 证书提供给 MinIO,而不是本指南中提到的 CA。

有关更高级的配置,请参阅cert-manager 文档和您自己组织的证书要求。

cert-manager 在 Kubernetes 集群中管理证书。MinIO 运算符支持使用 cert-manager 来管理和供应证书,作为 MinIO 运算符自行管理其自身及其租户证书的替代方案。

cert-manager 从IssuerClusterIssuer 获取有效证书,并且可以在证书过期之前自动续订证书。

ClusterIssuer 为多个命名空间颁发证书。Issuer 仅为其自己的命名空间铸造证书。

下图显示了 cert-manager 如何在 Kubernetes 集群中的命名空间中提供证书。

  • ClusterIssuer 存在于 Kubernetes 集群的根级别,通常是default 命名空间,以向所有其他命名空间提供证书。

  • minio-operator 命名空间接收其自己的本地Issuer

  • 每个租户的命名空间接收其自己的本地Issuer

  • 每个租户命名空间颁发的证书必须让 MinIO 运算符知道并信任。

A graph of the namespaces in a Kubernetes cluster showing the relationship between the root level ClusterIssuer and three other namespaces with their own Issuer.

先决条件

设置 cert-manager

安装 cert-manager

以下命令使用kubectl 安装版本 1.12.13。

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.12.13/cert-manager.yaml

版本 1.12.X LTS 是首选,但您可以安装最新版本。有关安装 cert-manager 的更多详细信息,请参阅其安装说明

为集群创建自签名集群颁发者

Cluster Issuer 是集群中所有其他证书派生的顶级颁发者。

  1. 通过创建ClusterIssuer 资源来请求 cert-manager 生成此资源。

    创建一个名为selfsigned-root-clusterissuer.yaml 的文件,内容如下

    # selfsigned-root-clusterissuer.yaml
    apiVersion: cert-manager.io/v1
    kind: ClusterIssuer
    metadata:
      name: selfsigned-root
    spec:
      selfSigned: {}
    
  2. 将资源应用于集群

    kubectl apply -f selfsigned-root-clusterissuer.yaml
    

后续步骤

设置用于 MinIO 运算符的 cert-manager