升级 MinIO 租户

以下步骤使用 Kustomize 或 Helm 升级单个 MinIO 租户。在升级生产租户之前，MinIO 建议您在较低的环境（例如开发或 QA 租户）中测试升级。

重要

对于使用早于 RELEASE.2024-03-30T09-41-56Z 的 MinIO 镜像并启用了 AD/LDAP 的租户，您**必须**在开始此过程之前通读 RELEASE.2024-04-18T19-09-19Z 的发行说明。您必须将链接的发行说明中记录的额外步骤作为升级过程的一部分。

使用 Kustomize 升级租户

以下步骤使用 Kustomize 和 kubectl CLI 升级 MinIO 租户。如果您使用 Helm 部署了租户，请改用使用 MinIO Helm 图表升级租户步骤。

要使用 Kustomize 升级租户

如果租户是使用 Operator 控制台部署的，则在升级之前需要执行其他步骤来创建基本配置文件。

如果租户是使用 Kustomize 部署的，则基本配置是您来自原始租户部署的现有 kustomization 文件。

根据租户的部署方式，选择下面的选项卡

Operator 控制台部署的租户

创建基本配置文件
1. 在一个方便的目录中，使用 kubectl get 将当前租户配置保存到文件中
  kubectl get tenant/my-tenant -n my-tenant-ns -o yaml > my-tenant-base.yaml
  将 my-tenant 和 my-tenant-ns 替换为要升级的租户的名称和命名空间。
  
  编辑该文件以删除以下行
  - creationTimestamp
  - resourceVersion
  - uid
  - selfLink:（如果存在）
  例如，删除突出显示的行
  metadata: creationTimestamp: "2024-05-29T21:22:20Z" generation: 1 name: my-tenant namespace: my-tenant-ns resourceVersion: "4699" uid: d5b8e468-3bed-4aa3-8ddb-dfe1ee0362da
2. 在同一目录中，创建一个 kustomization.yaml 文件，其内容类似于以下内容
```
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization

resources:
- my-tenant-base.yaml

patches:
- path: upgrade-minio-tenant.yaml
```
  如果您在上一步中为 kubectl get 输出使用了不同的文件名，请将 my-tenant-base.yaml 替换为该文件的名称。

现有 Kustomized 部署的租户

您可以使用原始部署中的 kustomization 文件作为基本配置来升级租户。如果您不再拥有这些文件，请按照 Operator 控制台部署的租户选项卡中的说明进行操作。

创建一个 upgrade-minio-tenant.yaml 文件，其内容类似于以下内容

apiVersion: minio.min.io/v2
kind: Tenant

metadata:
  name: my-tenant
  namespace: my-tenant-ns

spec:
  image: minio/minio:RELEASE.2024-10-29T16-01-48Z

此文件指示 Kustomize 使用指定的镜像升级租户。此文件的名称 upgrade-minio-tenant.yaml 必须与在上一步中创建的 kustomization.yaml 文件中指定的 patches.path 文件名匹配。

将 my-tenant 和 my-tenant-ns 替换为要升级的租户的名称和命名空间。在 image: 中指定要升级到的 MinIO 版本。

或者，您可以根据本地流程直接更新基础配置。有关更多信息，请参阅 Kustomize 文档。

从上述文件所在的同一目录中，使用 kubectl apply 将更新后的配置应用到租户。

kubectl apply -f ./

输出类似如下所示

tenant.minio.min.io/my-tenant configured

使用 MinIO Helm Chart 升级租户

此过程使用 Helm Chart 升级现有的 MinIO 租户。

如果您使用 Kustomize 部署了租户，请改用使用 Kustomize 升级租户过程。

验证现有的 MinIO 租户安装。

使用 kubectl get all -n TENANT_NAMESPACE 验证所有租户 Pod 和服务的健康状况和状态。

使用 helm list 命令查看命名空间中安装的图表

helm list -n TENANT_NAMESPACE

结果应类似如下所示

NAME            NAMESPACE         REVISION        UPDATED                                 STATUS          CHART           APP VERSION
CHART_NAME      TENANT_NAMESPACE  1               2023-11-01 15:49:58.810412732 -0400 EDT deployed        tenant-5.0.x   v5.0.x

更新 Operator 仓库

使用 helm repo update minio-operator 更新 MinIO Operator 仓库。如果您为 MinIO Operator 仓库设置了不同的别名，请将其指定给命令。您可以使用 helm repo list 查看已安装的仓库。

更新 Operator 仓库后，使用 helm search 检查最新的可用图表版本

helm search repo minio-operator

响应应类似如下所示

NAME                            CHART VERSION   APP VERSION     DESCRIPTION
minio-operator/minio-operator   4.3.7           v4.3.7          A Helm chart for MinIO Operator
minio-operator/operator         6.0.4          v6.0.4         A Helm chart for MinIO Operator
minio-operator/tenant           6.0.4          v6.0.4         A Helm chart for MinIO Operator

minio-operator/minio-operator 是一个旧版图表，在正常情况下**不应**安装。

运行 helm upgrade

Helm 使用最新的图表来升级租户
```
helm upgrade -n minio-tenant \
  CHART_NAME minio-operator/tenant
```
命令结果应返回成功，并且 REVISION 值会增加。
验证租户升级

检查所有服务和 Pod 是否在线并正常运行。