`mc admin replicate`

在 RELEASE.2023-01-11T03-14-16Z 版本发生变更:

mc admin replicate edit 重命名为 mc admin replicate update
mc admin replicate remove 重命名为 mc admin replicate rm

描述

mc admin replicate 命令用于创建和管理一组 MinIO 对等站点的站点复制。

站点复制模拟了 active-active 的存储桶复制，但是它是针对多个 MinIO 部署的。无论在哪里对 IAM 设置、存储桶或对象进行更改，只要这些更改跨越了站点复制组中的所有站点，这些更改都会在站点复制组中的所有站点上进行复制。

存储桶复制负责管理将特定存储桶或对象从一处复制到另一处，这可以在部署内部或跨部署进行。而站点复制则是将整个 MinIO 站点持续复制到其他站点。

mc admin replicate 命令仅在配置站点复制时支持对分布式部署进行站点复制。

在初始化新的站点复制配置时，只能有一个部署包含任何数据。

站点复制对所有存储桶强制实施桶版本控制，包括在初始化站点复制之前已存在的存储桶以及在此之后添加的任何存储桶。站点复制完全同步版本化对象，而 mc mirror 命令仅操作对象的最新版本。

Use mc admin on MinIO Deployments Only

MinIO 不支持与其他声称与 MinIO 部署兼容的 S3 兼容服务一起使用 mc admin 命令。

mc admin replicate 命令具有以下子命令：

Subcommand	描述
`mc admin replicate add`	创建一个新的站点复制配置或扩展现有的配置。
`mc admin replicate info`	返回站点复制配置的信息。
`mc admin replicate resync`	如果第二个站点丢失了数据，则从第一个站点重新同步内容到第二个站点。
`mc admin replicate rm`	删除整个站点复制配置或一个或多个对等站点，使其不再参与站点复制。
`mc admin replicate status`	显示参与站点之间可复制的数据的状态。
`mc admin replicate update`	修改站点复制配置中指定对等站点的端点。

语法

mc admin replicate add

创建或扩展一个站点复制配置。默认情况下，该配置使用异步站点复制，因为MinIO推荐这样做。

为了启用同步站点复制，首先使用这个命令创建复制。要启用同步站点复制，首先使用此命令创建复制。然后使用命令 mc admin replicate update --mode sync 更新配置。

EXAMPLES

考虑一个多站点MinIO拓扑，其中包含三个独立的MinIO部署，使用以下 aliases: minio1 ， minio2 和 minio3 。三个站点之间具有完整的双向网络访问和低延迟。

mc admin replicate add minio1 minio2 minio3

以下命令将包括对等站点 minio1 、 minio2 、 minio3 和 minio4 的现有站点复制扩展为附加对等站点 minio5 。 minio5 不包含任何数据。首先列出所有现有的对等站点。列出要扩展至最后的站点。

如果任何现有站点无法访问，请首先使用 mc admin replicate rm 删除无法访问的站点，然后继续进行站点复制扩展。

mc 管理员复制添加 minio1 minio2 minio3 minio4 minio5

以下命令创建了一个新的站点复制配置，其中包括在对等站点 minio1 、 minio2 和 minio3 之间同步ILM过期规则。

mc admin replicate add minio1 minio2 minio3 --replicate-ilm-expiry

SYNTAX

该命令具有以下语法：

mc [GLOBALFLAGS] admin replicate add      \
                            ALIAS1        \
                            ALIAS2        \
                            [ALIAS3 ...]  \
                            [--replicate-ilm-expiry]

ALIAS

Required

MinIO部署的 alias，用于包括在站点复制中。

创建站点复制至少需要两个MinIO部署的别名。在站点复制中，只有第一个别名可以包含存储桶（buckets）或对象（objects）。第一个站点也可以是空的。

要将现有站点复制扩展到一个或多个新的复制站点，请列出要扩展的站点复制集中所有现有的对等站点 aliases 。然后包括一个或多个额外的 aliases，以添加到现有的站点复制中。正在添加的对等点必须为空。

--replicate-ilm-expiry: Optional

在 mc 版本加入: RELEASE.2023-12-02T02-03-28Z

将在对等站点之间复制 ILM expiration 规则。

mc admin replicate update

修改参与站点复制的现有对等站点的端点。

在 RELEASE.2023-01-11T03-14-16Z 版本发生变更: mc admin replicate edit 重命名为 mc admin replicate update .

EXAMPLE

mc admin replicate update                                                   \
                   minio2                                                 \
                   --deployment-id c1758167-4426-454f-9aae-5c3dfdf6df64   \
                   --endpoint https://minio2:9000

SYNTAX

该命令具有以下语法：

mc [GLOBALFLAGS] admin replicate update                     \
                            ALIAS                           \
                            --deployment-id [deploymentID]  \
                            --endpoint [newEndpoint]        \
                            --mode ["sync" | "async"]       \
                            --enable-ilm-expiry-replication \
                            --disable-ilm-expiry-replication

ALIAS: Required
MinIO部署的 alias。

--bucket-bandwidth

设置桶的默认带宽限制，以每秒比特数为单位。

有效单位包括：

B for bytes
K for kilobytes
M for megabytes
G for gigabytes
T for terabytes
Ki for kibibytes
Mi for mibibytes
Gi for gibibytes
Ti for tebibytes

例如，以下命令将 myminio 部署上的复制带宽限制为每秒不超过 2 Gigabytes。

mc admin replicate update myminio --deployment-id c1758167-4426-454f-9aae-5c3dfdf6df64 --bucket-bandwidth "2G"

--deployment-id

Required

要更改的部署的唯一ID。

部署ID可以通过运行 mc admin replicate info ALIAS 命令来查找。

--disable-ilm-expiry-replication: Optional

在 mc 版本加入: RELEASE.2023-12-02T02-03-28Z

停止在站点之间的ILM过期规则复制。已经同步到各个站点之间的现有规则不会从任何站点移除。

--enable-ilm-expiry-replication: Optional

在 mc 版本加入: RELEASE.2023-12-02T02-03-28Z

开始在站点之间的ILM过期规则复制。

--endpoint: Required
与对等站点关联的新端点或URL。

--mode

Optional

指定MinIO是否以同步方式对等执行复制操作，还是以异步方式执行。可用的值有 sync 和 async 。

默认为 async 。

--sync: Optional

重要

从 RELEASE.2023-07-07T05-25-51Z 版本开始， --sync 标志已被弃用。请使用 --mode 命令。

启用或禁用同步站点复制。可用的值有 enable 和 disable 。如果未定义，MinIO 将使用异步站点复制。

mc admin replicate rm, remove

在 RELEASE.2023-01-11T03-14-16Z 版本发生变更: mc admin replicate remove 子命令已重命名为 mc admin replicate rm 。

该命令用于从站点复制配置中移除一个或多个站点。

请记住，如果您打算将来重新将站点添加到站点复制配置中，它必须不包含可复制的数据。

EXAMPLES

删除包含 minio2 的所有已连接站点的站点复制配置。这将删除所有参与站点的站点复制配置。

mc admin replicate rm      \
                   minio2  \
                   --all   \
                   --force

从包含 minio2 的现有站点复制配置中删除别名为 minio5 和 minio6 的站点。

mc admin replicate rm      \
                   minio2  \
                   minio5  \
                   minio6  \
                   --force

SYNTAX

该命令具有以下语法：

mc [GLOBALFLAGS] admin rm          \
                       TARGET      \
                       ALIAS1      \
                       [ALIAS2...] \
                       --all       \
                       --force

TARGET: Required
活动的 MinIO 部署参与站点复制的目标的 alias。除非要删除所有站点，否则不要使用要删除的部署的别名。

ALIAS: Optional
要从站点复制配置中删除的活动的 MinIO 部署的 alias。可以重复使用以删除其他站点。

--all: Optional
包含此标志以删除所有配置为站点复制的站点，并结束站点复制配置。

--force: Required
这个标志强制从站点复制配置中删除指定的对等站点（s）。

mc admin replicate info

返回有关站点复制配置中的站点的信息。

EXAMPLE

mc admin replicate info minio1

SYNTAX

mc [GLOBALFLAGS] admin replicate info ALIAS

ALIAS: Required
站点复制配置中活动的 MinIO 部署的 alias。

mc admin replicate status

显示站点复制配置中站点、存储桶、用户、组或策略的状态。

EXAMPLES

显示包括站点 minio1 的站点复制配置的整体复制状态。

mc admin replicate status minio1

显示包括站点 minio1 的站点复制配置中存储桶跨站点复制的状态。

mc admin replicate status     \
                   minio1     \
                   --buckets

显示包括站点 minio1 的站点复制配置中名为 images 的存储桶跨站点复制的状态。

mc admin replicate status           \
                    minio1          \
                    --bucket images

显示包括站点 minio1 的站点复制配置中用户 janedoe 的设置跨站点复制的状态。

mc admin replicate status         \
                   minio1         \
                   --user janedoe

上述示例的输出类似于以下内容：

Bucket replication status:
●  30/30 Buckets in sync

Policy replication status:
●  5/5 Policies in sync

User replication status:
●  3/3 Users in sync

Group replication status:
No Groups present

ILM Expiry Rules replication status:
●  5/5 ILM Expiry Rules in sync

Object replication status:
Replication status since 1 day
Summary:
Replicated:    0 objects (0 B)
Queued:        - 0 objects, (0 B) (avg: 0 objects, 0 B; max: 0 objects, 0 B)
Received:      0 objects (0 B)

显示包括站点 minio1 的站点复制配置中具有规则 ID ckok9v5b4dtgofkbi6tg 的ILM过期规则跨站点复制的状态。

mc admin replicate status minio1 --ilm-expiry-rule ckok9v5b4dtgofkbi6tg

输出类似于以下内容：

●  ILM Expiry Rule replication summary for: ckok9v5b4dtgofkbi6tg

ILMExpiryRule   | MINIO1          | MINIO2
ILM Expiry Rule | ✔               | ✔

SYNTAX

mc [GLOBALFLAGS] admin replicate status          \
                   TARGET                        \
                   [--all]                       \
                   [--buckets]                   \
                   [--bucket nameOfBucket]       \
                   [--groups]                    \
                   [--group nameOfGroup]         \
                   [--ilm-expiry-rules]          \
                   [--ilm-expiry-rule <rule ID>] \
                   [--policies]                  \
                   [--policy nameOfPolicy]       \
                   [--users]                     \
                   [--user accessKey]

TARGET: Required
站点复制配置中活动MinIO部署的 alias。

--all: Optional
显示所有可用的站点复制状态信息。

--buckets: Optional
显示所有存储桶的复制状态。

--bucket: Optional
通过在标志后包含存储桶名称，显示特定存储桶的复制状态。

--groups: Optional
显示所有组的复制状态。

--group: Optional
通过在标志后包含组名称，显示特定组的复制状态。

--ilm-expiry-rules

Optional

在 mc 版本加入: RELEASE.2023-12-02T02-03-28Z

显示关于ILM（Index Lifecycle Management）过期规则的同步信息。

与 --ilm-expiry-rule 相互排斥

--ilm-expiry-rule

Optional

在 mc 版本加入: RELEASE.2023-12-02T02-03-28Z

显示有关指定ILM过期规则的复制状态信息。

与 --ilm-expiry-rules 相互排斥

--policies: Optional
显示所有策略的复制状态。

--policy: Optional
通过在标志后包含策略名称，显示特定策略的复制状态。

--users: Optional
显示所有用户的复制状态。

--user: Optional
通过在标志后包含用户名称，显示特定用户的复制状态。

mc admin replicate resync

在数据丢失的情况下，将复制配置中的一个站点的数据重新同步到复制配置中的另一个站点。

EXAMPLES

以下命令启动一个重新同步过程，以从 minio1 恢复 minio2

mc admin replicate resync start minio1 minio2

以下命令显示正在进行的重新同步的状态。

mc admin replicate resync status minio1 minio2

以下命令停止正在进行的重新同步。

mc admin replicate resync cancel minio1 minio2

SYNTAX

mc [GLOBALFLAGS] admin replicate resync start|status|cancel ALIAS1 ALIAS2

将 ALIAS1 替换为拥有要恢复数据的站点的别名。
将 ALIAS2 替换为需要重新同步数据的站点的别名。

start: 启动一个新的重新同步过程，从具有数据的第一个站点到需要同步的第二个站点。

status: 显示两个配置为站点复制的站点之间的现有重新同步过程的状态。

cancel: 结束两个配置为站点复制的站点之间正在进行的重新同步过程。

alias1: 在站点复制配置中，活动的MinIO部署的 alias ，用于指定您想要重新同步到另一个站点的数据。

alias2: 在站点复制配置中，需要从另一个站点重新同步数据的活动的MinIO部署的 alias 。

全局标记

此命令支持任何全局标志。

商业支持购买咨询