启用多站点服务端存储桶复制

本页中的过程用于在多个 MinIO 部署之间配置自动化的服务端存储桶复制。多站点 Active-Active 复制基于启用双向服务端存储桶复制过程，并增加了额外注意事项，以确保所有站点上的复制行为可预测。

如需在任意 S3 兼容服务之间配置复制，请使用 mc mirror。
如需在两个 MinIO 部署之间配置单向 “active-active” 复制，请参阅启用双向服务端存储桶复制。
如需在 MinIO 部署之间配置单向 “active-passive” 复制，请参阅启用服务端单向存储桶复制。

多站点 Active-Active 复制配置可以跨越多个机架、数据中心或地理位置。多站点配置的部署与维护复杂度通常会随着站点数量和每个站点规模的增加而提高。计划实施多站点复制的企业应考虑借助 MinIO SUBNET 支持，以获取应对此类用例所需的专业知识、规划能力和工程资源。

要求

你必须满足 Bucket Replication Requirements 中描述的所有存储桶复制基础要求。

此外，要创建多站点存储桶复制配置，你还必须满足以下额外要求：

访问所有集群

要设置多站点 Active-Active 存储桶复制，你必须具备访问所有部署的网络连通性，以及具有正确权限的登录凭证。

你可以通过安装 mc 并使用命令行访问这些部署。使用 mc alias set 命令为每个 MinIO 部署创建别名。

创建别名时，需要指定该部署上某个用户的 access key。该用户**必须**具有在该部署上创建和管理用户及策略的权限。

具体来说，请确保该用户*至少*具有以下权限：

注意事项

点击展开以下任意条目：

过程

对于参与多站点复制配置的每个 MinIO 部署，都需要重复执行本过程中的步骤。根据部署数量的不同，该过程在实施时可能需要投入大量时间并格外谨慎。MinIO 建议在尝试执行文档中的步骤之前，先完整阅读本过程。

使用命令行配置多站点存储桶复制
- 创建新的存储桶复制规则
- 验证复制配置

使用命令行 `mc` 配置多站点存储桶复制

本过程使用占位符 ALIAS 来引用每个被配置为复制端点的 MinIO 部署的 alias。请将这些值替换为各个 MinIO 部署对应的实际别名。

本过程假设每个别名都对应一个具备 necessary replication permissions 的用户。

Changed in version RELEASE.2022-12-24T15-21-38Z: mc replicate add 会自动创建所需的复制目标，因此不再需要使用已弃用的 mc admin remote bucket add 命令。本过程仅记录该版本及之后的操作方式。

1) 创建新的存储桶复制规则

使用 mc replicate add 命令，为每个 MinIO 部署添加新的复制规则。

mc replicate add ALIAS/BUCKET \
   --remote-bucket 'https://USER:PASSWORD@HOSTNAME:PORT/BUCKET' \
   --replicate "delete,delete-marker,existing-objects"

将 ALIAS 替换为源 MinIO 部署的别名。该名称必须与上一步创建远端目标时指定的存储桶名称一致。
将 BUCKET 替换为源部署上要作为复制源的存储桶名称。
使用 --remote-bucket 指定 ALIAS/BUCKET 要复制到的远端 MinIO 部署和存储桶。

USER:PASSWORD 必须对应远端部署上具有所需复制权限的用户。

HOSTNAME:PORT 必须能解析到远端部署上可访问的 MinIO 实例。 BUCKET 必须已存在，并满足其他所有复制要求。
--replicate "delete,delete-marker,existing-objects" 标志会启用以下复制功能：
- 删除复制
- 现有对象复制
有关更完整的文档，请参阅 mc replicate add --replicate。省略任意字段即可禁用对应组件的复制。

可按需为 mc replicate add 指定其他受支持的可选参数。

对于参与多站点复制配置的每个远程 MinIO 部署，都要重复执行这些命令。例如，一个由 MinIO 部署 minio1、minio2 和 minio3 组成的多站点复制配置，需要在每个部署上针对每个远程端重复执行此步骤。

具体来说，在这种场景下，需要在每个部署上执行两次此步骤：

在 minio1 部署上，为 minio2 创建一条规则，再为 minio3 单独创建另一条规则。
在 minio2 部署上，为 minio1 创建一条规则，再为 minio3 单独创建另一条规则。
在 minio3 部署上，为 minio1 创建一条规则，再为 minio2 单独创建另一条规则。

2) 验证复制配置

在其中一个部署上，使用 mc cp 将新对象复制到已启用复制的存储桶中。

mc cp ~/foo.txt ALIAS/BUCKET

使用 mc ls 验证目标存储桶中存在该对象：

mc ls ALIAS/BUCKET

在每个部署上重复执行此测试：复制一个新的唯一文件，并检查该文件是否已复制到其他每个部署。

你也可以使用 mc stat 检查该文件，以查看对象当前的 replication stage。