升级旧版 MinIO 运算符

租户自定义资源定义更改

以下更改适用于运算符 v5.0.0 或更高版本

• .spec.s3 字段被 .spec.features 字段替换。

• .spec.credsSecret 字段被 .spec.configuration 字段替换。

  .spec.credsSecret 应包含 MinIO 部署的所有包含敏感信息的 环境变量，并且不应在 .spec.env 中显示。此更改会影响租户 CRD，并且只会影响直接编辑租户 YAML 的用户，例如通过 Helm 或 Kustomize。

• 日志搜索 API (.spec.log) 和 Prometheus (.spec.prometheus) 部署均已删除。但是，现有部署会作为独立部署/有状态集保留运行，与租户 CR 没有连接。删除租户 CRD 不会级联到日志或 Prometheus 部署。

  重要

  MinIO 建议您创建 YAML 文件以管理这些部署。

日志搜索和 Prometheus

最新版本的运算符从包含的运算符工具中删除了日志搜索和 Prometheus。以下步骤备份现有的 YAML 文件，执行一些清理工作，并提供继续使用其中一个或两个功能的步骤。

1. 备份 Prometheus 和日志搜索 YAML 文件。

   export TENANT_NAME=myminio
   export NAMESPACE=mynamespace
   kubectl -n $NAMESPACE get secret $TENANT_NAME-log-secret -o yaml > $TENANT_NAME-log-secret.yaml
   kubectl -n $NAMESPACE get cm $TENANT_NAME-prometheus-config-map -o yaml > $TENANT_NAME-prometheus-config-map.yaml
   kubectl -n $NAMESPACE get sts $TENANT_NAME-prometheus -o yaml > $TENANT_NAME-prometheus.yaml
   kubectl -n $NAMESPACE get sts $TENANT_NAME-log -o yaml > $TENANT_NAME-log.yaml
   kubectl -n $NAMESPACE get deployment $TENANT_NAME-log-search-api -o yaml > $TENANT_NAME-log-search-api.yaml
   kubectl -n $NAMESPACE get svc $TENANT_NAME-log-hl-svc -o yaml > $TENANT_NAME-log-hl-svc.yaml
   kubectl -n $NAMESPACE get svc $TENANT_NAME-log-search-api -o yaml > $TENANT_NAME-log-search-api-svc.yaml
   kubectl -n $NAMESPACE get svc $TENANT_NAME-prometheus-hl-svc -o yaml > $TENANT_NAME-prometheus-hl-svc.yaml
   

   • 将 myminio 替换为要升级的运算符部署上的租户名称。

   • 将 mynamespace 替换为要升级的运算符部署上的租户命名空间。

   对每个租户重复此操作。

2. 删除所有备份文件的所有租户的 .metadata.ownerReferences。

3. （可选）要继续使用日志搜索 API 和 Prometheus，请将以下变量添加到租户的 YAML 规范文件中的 .spec.env 下

   使用以下命令来编辑租户

   kubectl edit tenants <TENANT-NAME> -n <TENANT-NAMESPACE>
   

   • 将 <TENANT-NAME> 替换为要修改的租户名称。

   • 将 <TENANT-NAMESPACE> 替换为要修改的租户的命名空间。

   在文件中的 .spec.env 下添加以下值

   - name: MINIO_LOG_QUERY_AUTH_TOKEN
     valueFrom:
       secretKeyRef:
         key: MINIO_LOG_QUERY_AUTH_TOKEN
         name: <TENANT_NAME>-log-secret
   - name: MINIO_LOG_QUERY_URL
     value: http://<TENANT_NAME>-log-search-api:8080
   - name: MINIO_PROMETHEUS_JOB_ID
     value: minio-job
   - name: MINIO_PROMETHEUS_URL
     value: http://<TENANT_NAME>-prometheus-hl-svc:9001
   

   • 在 name 或 value 行中替换 <TENANT_NAME> 为您的租户名称。

步骤

先决条件

此过程需要以下内容

• 您有一个正在运行 4.2.3 到 4.5.7 版本的现有 MinIO 运算符部署。

• 您的 Kubernetes 集群运行 1.19.0 或更高版本。

• 您的本地主机已安装 kubectl，并已配置为访问 Kubernetes 集群

步骤

此步骤将 MinIO 运算符版本从 4.2.3 到 4.5.7 升级到 4.5.8。然后，您可以从 4.5.8 升级到 5.0.15。

1. (可选) 将每个 MinIO 租户更新到最新的稳定 MinIO 版本。

   定期升级 MinIO 可确保您的租户拥有最新的功能和性能改进。

   在将升级应用到生产租户之前，请在较低的环境（例如开发或测试租户）中测试升级。

   有关升级 MinIO 租户的步骤，请参见 升级 MinIO 租户。

2. 验证现有的运算符安装。

   使用 kubectl get all -n minio-operator 验证所有运算符 pod 和服务的运行状况和状态。

   如果您将运算符安装到自定义命名空间，请指定该命名空间作为 -n <NAMESPACE>。

   您可以通过检索命名空间中运算符 pod 的对象规范来验证当前安装的运算符版本。以下示例使用 jq 工具从 kubectl 中过滤必要的信息

   kubectl get pod -l 'name=minio-operator' -n minio-operator -o json | jq '.items[0].spec.containers'
   

   输出类似于以下内容

   {
      "env": [
         {
            "name": "CLUSTER_DOMAIN",
            "value": "cluster.local"
         }
      ],
      "image": "minio/operator:v4.5.1",
      "imagePullPolicy": "IfNotPresent",
      "name": "minio-operator"
   }
   

3. 下载最新的稳定版本的 MinIO Kubernetes 插件

   您可以使用 Kubernetes Krew 插件管理器或通过手动下载和安装插件二进制文件到本地主机来安装 MinIO 插件

   Krew 插件管理器

   Krew 是由 Kubernetes SIG CLI 小组 开发的 kubectl 插件管理器。有关特定说明，请参见 krew 安装文档。您可以将 Krew 插件用于 Linux、macOS 和 Windows 操作系统。

   您可以使用 Krew 使用以下命令安装 MinIO kubectl 插件

   kubectl krew update
   kubectl krew install minio
   

   如果要使用 Krew 更新 MinIO 插件，请使用以下命令

   kubectl krew upgrade minio
   

   手动（Linux、MacOS）

   您可以将 MinIO kubectl 插件下载到本地系统路径。 kubectl CLI 会自动发现并运行兼容的插件。

   以下代码将下载最新版本的 MinIO Kubernetes 插件，并将其安装到系统路径

   curl https://github.com/minio/operator/releases/download/v5.0.14/kubectl-minio_5.0.14_linux_amd64 -o kubectl-minio
   chmod +x kubectl-minio
   mv kubectl-minio /usr/local/bin/
   

   上面的 mv 命令可能需要 sudo 提升，具体取决于经过身份验证的用户的权限。

   运行以下命令验证插件安装

   kubectl minio version
   

   输出应显示运算符版本为 5.0.14。

   手动（Windows）

   您可以将 MinIO kubectl 插件下载到本地系统路径。 kubectl CLI 会自动发现并运行兼容的插件。

   以下 PowerShell 命令将下载最新版本的 MinIO Kubernetes 插件，并将其安装到系统路径

   Invoke-WebRequest -Uri "https://github.com/minio/operator/releases/download/v5.0.14/kubectl-minio_5.0.14_windows_amd64.exe" -OutFile "C:\kubectl-plugins\kubectl-minio.exe"
   

   确保插件文件夹的路径包含在 Windows PATH 中。

   运行以下命令验证插件安装

   kubectl minio version
   

   输出应显示运算符版本为 5.0.14。

4. 运行初始化命令以升级运算符

   使用 kubectl minio init 命令升级现有的 MinIO 运算符安装

   kubectl minio init
   

5. 验证运算符升级

   您可以通过查看使用上一步操作的运算符 Pod 的对象规范来检查运算符版本。

   端口转发

   运算符控制台服务 不会自动绑定或公开自身以供 Kubernetes 集群外部访问。相反，请配置网络控制平面组件（例如负载均衡器或入口）来授予外部访问权限。

   出于测试目的或短期访问，可以使用以下补丁通过 NodePort 公开运算符控制台服务

   kubectl patch service -n minio-operator console -p '
   {
       "spec": {
           "ports": [
               {
                   "name": "http",
                   "port": 9090,
                   "protocol": "TCP",
                   "targetPort": 9090,
                   "nodePort": 30090
               },
               {
                   "name": "https",
                   "port": 9443,
                   "protocol": "TCP",
                   "targetPort": 9443,
                   "nodePort": 30433
               }
           ],
           "type": "NodePort"
       }
   }'
   

   补丁命令应输出 service/console patched。您现在可以通过 Kubernetes 工作节点上的端口 30433（HTTPS）或 30090（HTTP）访问该服务。

   例如，具有以下运算符节点的 Kubernetes 集群可能可以通过 https://172.18.0.2:30443 访问

   kubectl get nodes -o custom-columns=IP:.status.addresses[:]
   IP
   map[address:172.18.0.5 type:InternalIP],map[address:k3d-MINIO-agent-3 type:Hostname]
   map[address:172.18.0.6 type:InternalIP],map[address:k3d-MINIO-agent-2 type:Hostname]
   map[address:172.18.0.2 type:InternalIP],map[address:k3d-MINIO-server-0 type:Hostname]
   map[address:172.18.0.4 type:InternalIP],map[address:k3d-MINIO-agent-1 type:Hostname]
   map[address:172.18.0.3 type:InternalIP],map[address:k3d-MINIO-agent-0 type:Hostname]
   

   使用以下命令获取登录操作员控制台所需的 JWT 令牌

   kubectl get secret/console-sa-secret -n minio-operator -o json | jq -r '.data.token' | base64 -d
   

   如果您的本地主机未安装 jq 实用程序，您可以运行此命令的 kubectl 部分（在 | jq 之前），并找到输出的 data.token 部分。

先决条件

此过程假设

• 您有一个运行 4.0.0 到 4.2.2 之间任何版本的 MinIO Operator 部署

• 您的 Kubernetes 集群运行 1.19.0 或更高版本。

• 您的本地主机已安装 kubectl，并已配置为访问 Kubernetes 集群

程序

此过程涵盖将运行 4.0.0 到 4.2.2 之间任何版本的 MinIO Operator 部署升级到 4.2.3 所需的步骤。然后，您可以执行 将 MinIO Operator 从 5.0.15 升级到 6.0.4 以完成升级到 6.0.4。

4.0.0 到 4.2.2 安装程序没有直接升级到 6.0.4 的路径。

1. (可选) 将每个 MinIO 租户更新到最新的稳定 MinIO 版本。

   定期升级 MinIO 可确保您的租户拥有最新的功能和性能改进。在应用到生产租户之前，请在较低的环境（例如开发或 QA 租户）中测试升级。

   有关升级 MinIO 租户的步骤，请参见 升级 MinIO 租户。

2. 检查每个租户池的安全性上下文

   使用以下命令验证每个托管 MinIO 租户的规范

   kubectl get tenants <TENANT-NAME> -n <TENANT-NAMESPACE> -o yaml
   

   如果 spec.pools.securityContext 字段对于租户不存在，则租户 pod 可能以 root 身份运行。

   作为 4.2.3 及更高版本系列的一部分，pod 以受限的权限集运行，该权限集在操作员升级时实施。但是，由于安全上下文不匹配，以 root 身份运行 pod 的租户可能无法启动。您可以设置一个显式安全上下文，以允许 pod 以 root 身份运行这些租户

   securityContext:
     runAsUser: 0
     runAsGroup: 0
     runAsNonRoot: false
     fsGroup: 0
   

   您可以使用以下命令编辑租户并应用更改

   kubectl edit tenants <TENANT-NAME> -n <TENANT-NAMESPACE>
   # Modify the securityContext as needed
   

   有关 Kubernetes 安全上下文的更多信息，请参阅 Pod 安全标准。

3. 升级到 Operator 4.2.3

   下载 MinIO Kubernetes 插件 4.2.3 并使用它来升级操作员。在浏览器中打开 https://github.com/minio/operator/releases/tag/v4.2.3 并下载与您本地主机操作系统相对应的二进制文件。

   例如，运行 Intel 或 AMD 处理器的 Linux 主机可以运行以下命令

   wget https://github.com/minio/operator/releases/download/v4.2.3/kubectl-minio_4.2.3_linux_amd64 -o kubectl-minio_4.2.3
   chmod +x kubectl-minio_4.2.3
   ./kubectl-minio_4.2.3 init
   

4. 验证所有租户和操作员 pod

   检查操作员和 MinIO 租户命名空间以确保所有 pod 和服务都已成功启动。

   例如

   kubectl get all -n minio-operator
   kubectl get pods -l "v1.min.io/tenant" --all-namespaces
   

5. 升级到 6.0.4

   按照 将 MinIO Operator 从 5.0.15 升级到 6.0.4 过程升级到最新的稳定操作员版本。

先决条件

此过程假设

• 您有一个运行 3.X.X 的 MinIO Operator 部署

• 您的 Kubernetes 集群运行 1.19.0 或更高版本。

• 您的本地主机已安装 kubectl，并已配置为访问 Kubernetes 集群

程序

此过程涵盖将运行 3.0.0 到 3.2.9 之间任何版本的 MinIO Operator 部署升级到 4.2.2 所需的步骤。然后，您可以执行 将 MinIO Operator 从 4.0.0 到 4.2.2 升级到 4.2.3，然后执行 将 MinIO Operator 从 5.0.15 升级到 6.0.4。

从 3.X.X 系列安装程序没有直接升级到 6.0.4 的路径。

1. （可选）将每个 MinIO 租户更新到最新的稳定 MinIO 版本。

   定期升级 MinIO 可确保您的租户拥有最新的功能和性能改进。

   在将升级应用到生产租户之前，请在较低的环境（例如开发或测试租户）中测试升级。

   有关升级 MinIO 租户的步骤，请参见 升级 MinIO 租户。

2. 验证租户 tenant.spec.zones 值

   使用以下命令验证每个托管 MinIO 租户的规范

   kubectl get tenants <TENANT-NAME> -n <TENANT-NAMESPACE> -o yaml
   

   • 确保每个 tenant.spec.zones 元素都具有设置为该区域名称的 name 字段。每个区域必须对该租户具有唯一的名称，例如 zone-0 和 zone-1 分别用于第一个和第二个区域。

   • 确保每个 tenant.spec.zones 都有一个明确的 securityContext，描述 pod 在集群中运行的权限集。

   以下示例租户 YAML 片段设置了指定的字段

   image: "minio/minio:$(LATEST-VERSION)"
   ...
   zones:
   - servers: 4
     name: "zone-0"
     volumesPerServer: 4
     volumeClaimTemplate:
        metadata:
        name: data
        spec:
        accessModes:
           - ReadWriteOnce
        resources:
           requests:
              storage: 1Ti
     securityContext:
        runAsUser: 0
        runAsGroup: 0
        runAsNonRoot: false
        fsGroup: 0
   - servers: 4
     name: "zone-1"
     volumesPerServer: 4
     volumeClaimTemplate:
        metadata:
        name: data
        spec:
        accessModes:
           - ReadWriteOnce
        resources:
           requests:
              storage: 1Ti
     securityContext:
        runAsUser: 0
        runAsGroup: 0
        runAsNonRoot: false
        fsGroup: 0
   

   您可以使用以下命令编辑租户并应用更改

   kubectl edit tenants <TENANT-NAME> -n <TENANT-NAMESPACE>
   

3. 升级到 Operator 4.2.2

   下载 MinIO Kubernetes 插件 4.2.2 并使用它来升级操作员。在浏览器中打开 https://github.com/minio/operator/releases/tag/v4.2.2 并下载与您本地主机操作系统相对应的二进制文件。例如，运行 Intel 或 AMD 处理器的 Linux 主机可以运行以下命令

   wget https://github.com/minio/operator/releases/download/v4.2.3/kubectl-minio_4.2.2_linux_amd64 -o kubectl-minio_4.2.2
   chmod +x kubectl-minio_4.2.2
   
   ./kubectl-minio_4.2.2 init
   

4. 验证所有租户和操作员 pod

   检查操作员和 MinIO 租户命名空间以确保所有 pod 和服务都已成功启动。

   例如

   kubectl get all -n minio-operator
   
   kubectl get pods -l "v1.min.io/tenant" --all-namespaces
   

5. 升级到 4.2.3

   按照 将 MinIO Operator 从 4.0.0 到 4.2.2 升级到 4.2.3 过程升级到 Operator 4.2.3。然后，您可以升级到 6.0.4。