升级 MinIO 部署

重要

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

MinIO 使用先更新后重启的方法将部署升级到较新版本。

使用较新版本更新容器 MinIO 镜像。
重启容器。

此过程不需要停机，并且不会中断正在进行的操作。

注意事项

升级不会中断服务

MinIO 的先更新后重启过程**不需要**停机或安排维护时间。MinIO 重启速度很快，因此并行重启所有服务器进程通常只需几秒钟。MinIO 操作是原子且严格一致的，因此使用 MinIO 或 S3 SDK 的应用程序可以依靠内置的透明重试，而无需额外的客户端逻辑。这确保了升级不会中断正在进行的操作。

查看发行说明

MinIO 发布了发行说明供您参考，以了解每个版本中应用的更改。查看您当前 MinIO 版本和较新版本之间关联的发行说明，以便全面了解所有更改。

特别注意任何**不**向后兼容的发行版。您无法简单地从任何此类版本降级。

步骤

您可以运行 podman container inspect 或 docker inspect 命令检查容器并验证当前容器镜像。

# For docker, use docker inspect
podman container inspect --format='{{.Config.Image}}' CONTAINER_NAME

以下输出表示容器是使用最新的稳定镜像标签创建的。

quay.io/minio/minio:latest

使用使用最新镜像标签升级容器中的步骤来升级您的容器。

以下输出表示容器是使用特定镜像标签创建的。

quay.io/minio/minio:RELEASE.2023-07-21T21-12-44Z

使用使用特定镜像标签升级容器中的步骤来升级您的容器。

使用最新镜像标签升级容器

更新您的镜像注册表。

为配置的镜像仓库拉取最新的稳定 MinIO 镜像。
```
# For docker, use docker pull
podman pull quay.io/minio/minio:latest
```
重启容器。

您必须重启容器才能加载新的镜像二进制文件以供 MinIO 使用。
```
# For docker, use docker restart
podman container restart CONTAINER_NAME
```
验证升级。

使用 mc admin info 命令检查 MinIO 容器是否联机、正在运行，并反映已安装的 MinIO 版本。
更新 MinIO 客户端。

您应该升级您的 mc 二进制文件以匹配或紧跟 MinIO 服务器版本。您可以使用 mc update 命令将二进制文件更新到最新的稳定版本。
```
mc update
```

使用特定镜像标签升级容器

更新您的本地镜像注册表。

拉取您想要用于更新容器的镜像。以下示例使用 MinIO 的最新稳定版本
```
# For docker, use docker pull
podman pull quay.io/minio/minio:RELEASE.2024-10-29T16-01-48Z
```
修改容器启动脚本或配置

在容器启动脚本或配置中指定新的 MinIO 标签。对于 Docker，这可能是用于启动 MinIO 的 Compose 文件。对于 Podman，这可能是用于创建容器或 Pod 的 YAML 文件。

确保image: <VALUE>与新拉取的镜像标签匹配。
重启或重新创建容器

如果您使用 CLI 命令启动了容器，则可能需要完全停止、删除并重新创建容器。使用脚本执行此过程以最大程度地减少潜在的停机时间。

对于 Docker，这可能需要运行docker compose restart。
验证升级。

使用 mc admin info 命令检查 MinIO 容器是否联机、正在运行，并反映已安装的 MinIO 版本。
更新 MinIO 客户端。

您应该升级您的 mc 二进制文件以匹配或紧跟 MinIO 服务器版本。您可以使用 mc update 命令将二进制文件更新到最新的稳定版本。
```
mc update
```