部署MinIO操作员

Kubernetes 版本 |k8s-floor|

MinIO 针对|k8s-floor|的 Kubernetes API 底层测试|operator-version-stable|。 MinIO 强烈建议 使用以下工具维护 Kubernetes 基础设施 actively maintained Kubernetes API versions.

MinIO 强烈建议 升级使用以下操作系统运行的 Kubernetes 集群 End-Of-Life API versions

Kustomize 和 kubectl

Kustomize 是一个基于 YAML 的模板工具，允许您以声明性和可重复的方式定义 Kubernetes 资源。 Kustomize 包含在 kubectl 命令行工具中。

此过程假定您的本地主机具有与您的 Kubernetes 集群匹配的 kubectl 版本以及创建新资源所需的该集群的访问权限。

default MinIO Operator Kustomize template 为您的本地环境定制配置提供了一个起点。 您可以修改默认的 Kustomization 文件，也可以应用自己的 patches 为您的 Kubernetes 集群定制 Operator 部署。

Kubernetes TLS 证书 API

对于任何这些情况，MinIO Operator都 要求 Kubernetes kube-controller-manager 配置包括以下 配置设置:

• --集群签名密钥文件 - 指定用于签署集群范围证书的PEM编码的RSA或ECDSA私钥文件。

• --集群签名证书文件 - 请提供用于签发集群范围证书的PEM编码x.509证书颁发机构（CA）证书。

Kubernetes TLS API 使用CA签名算法生成新的TLS证书。 MinIO 推荐使用 ECDSA（例如 NIST P-256 曲线） 或 EdDSA（例如 Curve25519） TLS 私钥/证书，因为与 RSA 相比，它们具有更低的计算要求。 请参考和阅读 支持的 TLS 密码套件 以获取支持的 TLS 密码套件的完整列表。

如果 Kubernetes 集群未配置以响应生成的 CSR，则 Operator 无法完成初始化。 某些 Kubernetes 提供程序默认情况下不会指定这些配置值。

要检查 kube-controller-manager 是否指定了集群签名密钥和证书文件，请使用以下命令：

kubectl get pod kube-controller-manager-$CLUSTERNAME-control-plane \
  -n kube-system -o yaml

• 请将 $CLUSTERNAME 替换为 Kubernetes 集群的名称。

确认输出是否包含突出显示的行。 上面示例命令的输出可能与您的终端输出不同：

 spec:
 containers:
 - command:
     - kube-controller-manager
     - --allocate-node-cidrs=true
     - --authentication-kubeconfig=/etc/kubernetes/controller-manager.conf
     - --authorization-kubeconfig=/etc/kubernetes/controller-manager.conf
     - --bind-address=127.0.0.1
     - --client-ca-file=/etc/kubernetes/pki/ca.crt
     - --cluster-cidr=10.244.0.0/16
     - --cluster-name=my-cluster-name
     - --cluster-signing-cert-file=/etc/kubernetes/pki/ca.crt
     - --cluster-signing-key-file=/etc/kubernetes/pki/ca.key
 ...

使用 cert-manager 进行证书管理

您可以将部署配置为使用 cert-manager ，而不是 MinIO 操作员管理证书。 有关使用 cert-manager 部署 MinIO 操作员和租户的说明，请参阅 cert-manager 页面 。

使用 Kustomize 安装 MinIO Operator

以下步骤使用 kubectl -k``从 MinIO Operator GitHub 存储库安装 Operator。 ``kubectl -k 和 kubectl --kustomize 是执行相同命令的别名。

1. 安装最新版本的 Operator

   以下命令将 Operator 安装到 minio-operator 命名空间:

   kubectl apply -k "github.com/minio/operator?ref=v7.1.1"
   

   该命令输出已安装资源的列表。

2. 验证 Operator pod 是否正在运行:

   kubectl get pods -n minio-operator
   

   输出类似以下内容:

   NAME                              READY   STATUS              RESTARTS   AGE
   minio-operator-6c758b8c45-nkhlx   1/1     Running   0          2m42s
   minio-operator-6c758b8c45-dgd8n   1/1     Running   0          2m42s
   

   在这个例子中， minio-operator pod 是 MinIO Operator， console pod 是 Operator Console。

   您可以通过应用 kubectl 补丁来修改 Operator 部署。 您可以在 Operator GitHub 存储库 中找到常见配置的示例。

3. 验证 Operator 安装

   检查指定命名空间 ( minio-operator ) 的内容，确保所有 pod 和服务都已成功启动。

   kubectl get all -n minio-operator
   

   响应类似于以下内容:

   NAME                                  READY   STATUS    RESTARTS   AGE
   pod/minio-operator-6c758b8c45-nkhlx   1/1     Running   0          5m20s
   pod/minio-operator-6c758b8c45-dgd8n   1/1     Running   0          5m20s
   
   NAME               TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                         AGE
   service/operator   ClusterIP   10.43.135.241   <none>        4221/TCP                        5m20s
   service/sts        ClusterIP   10.43.117.251   <none>        4223/TCP                        5m20s
   
   NAME                             READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/minio-operator   2/2     2            2           5m20s
   
   NAME                                        DESIRED   CURRENT   READY   AGE
   replicaset.apps/minio-operator-6c758b8c45   2         2         2       5m20s
   

4. 下一步

   您可以使用:ref:MinIO CRD and Kustomize. <minio-k8s-deploy-minio-tenant> MinIO 还提供了 Helm chart for deploying Tenants.

   MinIO 建议使用与安装 Operator 相同的租户部署和管理方法。 混合使用 Kustomize 和 Helm 进行操作员或租户管理可能会增加操作复杂性。