升级旧版 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
   

   • 将 <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 的 安装文档。您可以对 Linux、macOS 和 Windows 操作系统使用 Krew 插件。

   您可以使用 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 集群外部访问。相反，请配置网络控制平面组件（如负载均衡器或 Ingress）以授予外部访问权限。

   出于测试目的或短期访问，请通过使用以下补丁将 Operator 控制台服务公开到 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）访问该服务。

   例如，可以从 https://172.18.0.2:30443 访问具有以下 Operator 节点的 Kubernetes 集群

   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 可确保您的租户拥有最新的功能和性能改进。在应用到生产租户之前，请在较低的环境（如 Dev 或 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. 升级到操作员 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 操作员 5.0.15 升级到 6.0.4 过程升级到最新的稳定操作员版本。

先决条件

此步骤假定：

• 您有一个运行 3.X.X 的现有 MinIO 操作员部署

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

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

过程

此过程涵盖将运行 3.0.0 到 3.2.9 之间任何版本的 MinIO 操作员部署升级到 4.2.2 所需的步骤。然后，您可以执行 将 MinIO 操作员 4.0.0 到 4.2.2 升级到 4.2.3，然后执行 将 MinIO 操作员 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. 升级到操作员 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 操作员 4.0.0 到 4.2.2 升级到 4.2.3 过程升级到操作员 4.2.3。然后，您可以升级到 6.0.4。