升级旧版 MinIO 运算符

租户自定义资源定义更改

以下更改适用于 5.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 替换为要升级的 Operator 部署中租户的命名空间。

   对每个租户重复此操作。

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
   

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

步骤

先决条件

此过程需要以下条件

• 您有一个运行 4.2.3 至 4.5.7 的现有 MinIO Operator 部署

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

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

步骤

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

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

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

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

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

2. 验证现有的 Operator 安装。

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

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

   您可以通过检索命名空间中 Operator Pod 的对象规范来验证当前安装的 Operator 版本。以下示例使用 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
   

   输出应显示 Operator 版本为 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
   

   输出应显示 Operator 版本为 5.0.14。

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

   使用 kubectl minio init 命令升级现有的 MinIO Operator 安装

   kubectl minio init
   

5. 验证 Operator 升级

   您可以通过查看使用上一步的 Operator Pod 的对象规范来检查 Operator 版本。

   端口转发

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

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

   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）访问该服务。

   例如，具有以下 Operator 节点的 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]
   

   使用以下命令检索登录 Operator 控制台所需的 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 可确保您的租户拥有最新的功能和性能改进。在应用于生产租户之前，请在较低的环境（例如开发或测试租户）中测试升级。

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

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

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

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

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

   作为 4.2.3 及更高版本系列的一部分，Pod 以有限的权限集运行，该权限集作为 Operator 升级的一部分强制执行。但是，由于安全上下文不匹配，以 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 并使用它来升级 Operator。在浏览器中打开 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. 验证所有租户和 Operator Pod

   检查 Operator 和 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 中的步骤升级到最新的稳定版 Operator 版本。

前提条件

此过程假设

• 您已有一个正在运行 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 可确保您的租户拥有最新的功能和性能改进。

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

   有关升级 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 并使用它来升级 Operator。在浏览器中打开 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. 验证所有租户和 Operator Pod

   检查 Operator 和 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。