mc admin replicate

描述

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

站点复制模拟了主动-主动存储桶复制，但适用于多个MinIO部署。 无论在整个站点集合中的IAM设置、存储桶或对象发生任何更改，这些更改都会在站点复制组中的所有站点之间进行复制。

哪里存储桶复制管理特定存储桶或对象在部署内或跨部署从一个位置到另一个位置的镜像，站点复制持续将整个MinIO站点镜像到其他站点。

mc admin replicate仅支持站点复制功能分布式部署在配置站点复制时。

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

站点复制强制执行bucket versioning在所有存储桶上，包括现有存储桶以及启动站点复制后添加的任何存储桶。 站点复制完全同步版本化对象，相比之下mc mirror仅对对象的最新版本进行操作

Themc admin replicate命令包含以下子命令：

语法

mc admin 复制 添加

创建或扩展站点复制配置。 默认情况下，该配置使用异步站点复制，正如 MinIO 所建议的。

要启用同步站点复制，请使用以下命令创建复制：first然后使用mc admin replicate update --mode sync更新配置。

示例

考虑一个多站点MinIO拓扑，包含三个独立的MinIO部署，使用以下别名: minio1, minio2和minio3所有三个站点都具备完整的双向网络访问能力，且站点间延迟很低。

mc admin replicate add minio1 minio2 minio3

以下命令扩展了包含对等站点的现有站点复制minio1, minio2, minio3和minio4到一个额外的对等站点，minio5. minio5不包含任何数据。 列表全部现有对等站点优先。 将待扩展站点列在最后。

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

mc admin replicate add minio1 minio2 minio3 minio4 minio5

以下命令创建一个新的站点复制配置，支持对等站点间的ILM过期规则同步minio1, minio2和minio3.

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

SYNTAX

该命令具有以下语法：

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

ALIAS

必需

The别名MinIO 部署的配置信息，以便包含在站点复制中。

创建站点复制至少需要两个 MinIO 部署别名。 只有第一个别名可以包含存储桶或对象。 第一个站点也可以为空。

要扩展现有的站点复制以添加一个新的复制站点，请列出所有现有的对等站点。别名在站点复制集中进行扩展。 然后包含一个或多个额外的别名添加到现有的站点复制中。 要添加的对等节点必须为空。

--replicate-ilm-expiry

可选

版本 mc 中的新功能：RELEASE.2023-12-02T02-03-28Z

复制ILM 过期对等节点间的规则。

mc admin 复制 更新

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

Changed in version 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

必需

The别名MinIO 部署的。

--bucket-bandwidth

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

有效单位包括：

• B对于字节

• K对于千字节

• M对于兆字节

• G用于千兆字节

• T对于太字节

• Ki对于千位字节

• Mi对于兆二进制字节

• Gi对于吉比字节

• Ti对于太字节

例如，以下命令限制在myminio部署不超过每秒 2 GB。

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

--deployment-id

必需

要更改的部署的唯一标识符。

部署ID可以通过运行以下命令找到：mc admin replicate info ALIAS

--disable-ilm-expiry-replication

可选

版本 mc 中的新功能：RELEASE.2023-12-02T02-03-28Z

停止在站点之间复制 ILM 过期规则。 已跨站点同步的现有规则不会从任何站点中删除。

--enable-ilm-expiry-replication

可选

版本 mc 中的新功能：RELEASE.2023-12-02T02-03-28Z

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

--endpoint

必需

要与对等站点关联的新端点或 URL。

--mode

可选

指定 MinIO 是同步还是异步执行到对等端的复制操作。 可用值为sync和async.

默认值为async.

--sync

可选

重要

The--syncflag 自以下版本起已被弃用：RELEASE.2023-07-07T05-25-51Z使用--mode相反。

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

mc admin 复制 rm, 移除

Changed in version RELEASE.2023-01-11T03-14-16Z:Themc admin replicate remove子命令已重命名为mc admin replicate rm.

从站点复制配置中移除一个或多个站点。

记住，如果您打算将来将该站点重新添加到站点复制配置中，它必须是空的可复现数据.

示例

移除现有站点复制配置中所有已连接站点的站点复制，该配置包括minio2这将删除所有参与站点的站点复制配置。

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

移除具有别名的站点minio5和minio6从现有的站点复制配置中，该配置包括minio2

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

SYNTAX

该命令具有以下语法：

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

TARGET

必需

The别名参与站点复制的活动 MinIO 部署的目标。 除非要从站点复制中移除所有站点，否则不要使用要移除的部署的别名。

ALIAS

可选

The别名从站点复制配置中移除一个活跃的 MinIO 部署的。 可以重复操作以移除其他站点。

--all

可选

包含此标志可移除所有为站点复制配置的站点并终止站点复制配置。

--force

必需

此标志强制从站点复制配置中移除指定的对等站点。

mc admin 复制 信息

返回站点复制配置中各个站点的相关信息。

EXAMPLE

mc admin replicate info minio1

SYNTAX

mc [GLOBALFLAGS] admin replicate info ALIAS

ALIAS

必需

The别名站点复制配置中活跃 MinIO 部署的

mc admin 复制 状态

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

示例

显示包含该站点的站点复制配置的整体复制状态minio1.

mc admin replicate status minio1

显示包含该站点的站点复制配置中存储桶在站点间的复制状态minio1.

mc admin replicate status     \
                   minio1     \
                   --buckets

显示名为 的存储桶的站点复制状态images跨站点，用于包含该站点的站点复制配置minio1.

mc admin replicate status           \
                    minio1          \
                    --bucket images

显示用户的站点复制状态设置。janedoe跨站点，针对包含站点的站点复制配置minio1.

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)

显示跨站点的站点复制状态，用于规则ID为的ILM过期规则ckok9v5b4dtgofkbi6tg对于包含该站点的站点复制配置minio1.

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

必需

The别名站点复制配置中活跃 MinIO 部署的

--all

可选

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

--buckets

可选

显示所有存储桶的复制状态。

--bucket

可选

通过在该标志后包含存储桶名称来显示特定存储桶的复制状态。

--groups

可选

显示所有组的复制状态。

--group

可选

通过在该标志后包含组名来显示特定组的复制状态。

--ilm-expiry-rules

可选

版本 mc 中的新功能：RELEASE.2023-12-02T02-03-28Z

显示有关 ILM 过期规则的同步信息。

与以下内容互斥--ilm-expiry-rule

--ilm-expiry-rule

可选

版本 mc 中的新功能：RELEASE.2023-12-02T02-03-28Z

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

与以下内容互斥--ilm-expiry-rules

--policies

可选

显示所有策略的复制状态。

--policy

可选

通过在该标志后包含策略名称来显示特定策略的复制状态。

--users

可选

显示所有用户的复制状态。

--user

可选

通过在该标志后包含用户名来显示特定用户的复制状态。

mc admin 复制 重新同步

在发生数据丢失时，将复制配置中一个站点的数据重新同步到复制配置中的第二个站点。

示例

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

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需要重新同步数据的站点别名。

开始

启动一个新的重新同步过程，从一个包含数据的站点同步到需要同步的第二个站点。

状态

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

取消

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

alias1

The别名在站点复制配置中，活动MinIO部署的数据，您希望将其重新同步到另一个站点。

alias2

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

全局标志

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