实时迁移（推送）MongoDB 6 。 0 。 13 + 或7 。 0 。 8 + 由 Cloud Manager 在 Atlas 中监控的集群

启动迁移过程。

1. 在组织页面的左侧面板中，单击Live Migration 。

2. 单击 Migrate from Ops Manager or Cloud Manager（连接）。

   注意

   用户界面标签提到了 Ops Manager，但在此过程中，您只能迁移到 Atlas MongoDB 部署6 。 0 。 Cloud Manager 监控的13或更高版本。

3. 单击 I'm Ready to Start（连接）。

Atlas 显示实时迁移向导，其中包含如何继续此进程的说明。 此进程将数据从源集群推送到新的目标集群。 在完成向导步骤后，您可以将应用程序指向新集群。

与 Atlas 链接。

1. 单击 Generate Link-Token。Atlas 显示用于生成链接令牌的页面。

2. 单击Next可查看包含生成的链接令牌的页面。

3. 复制链接令牌，将其存储在安全位置。 Atlas 从不显示链接令牌的内容。 Atlas 在生成链接令牌后也不显示其内容。请勿 公开分享。

   注意

   使用一个唯一的链接令牌（Link-Token）将一个 Cloud Manager 组织中的所有项目实时迁移到 Atlas。

4. 单击 Done（连接）。

将链接令牌（Link-Token）粘贴到 Cloud Manager 中。

1. 在 Cloud Manager 中访问组织：

   打开 Cloud Manager， 导航到您要将其项目集群实时迁移到 Atlas 的组织。

2. 单击左侧导航面板中的 Settings。

3. 在Live Migration: Connect to Atlas部分中，单击Connect to Atlas 。 Connect to Atlas对话框打开。

4. 粘贴“实时迁移”向导上一步生成的链接令牌（Link-Token），然后单击Connect to Atlas 。Cloud Manager 建立与 Atlas 的连接。如有需要，请使用Refresh按钮将更新发送到 Atlas。

创建目标 Atlas 集群。

如果还没有，请在 Atlas 中创建目标集群。请参阅所需的访问权限。

启动从目标集群的迁移。

1. 单击 Select Target Cluster from Projects（连接）。

2. 转到目标 Atlas 集群的项目，找到目标集群。

3. 单击然后从下拉列表中选择Migrate Data to this Cluster以开始迁移。 Migrate Data to This Cluster页面打开。

4. 单击 Migrate from Ops Manager or Cloud Manager（连接）。

   注意

   用户界面标签提到了 Ops Manager，但在此过程中，您只能迁移到 Atlas MongoDB 部署6 。 0 。 Cloud Manager 监控的13或更高版本。

   填写字段，如下所示：

   • 在 Cloud Manager 中选择源项目（如果尚未选择）。

   • 从下拉列表中选择源集群。

   • 如果要将副本集迁移到分片集群：

     • 如果您想对集合进行分片，请单击Include sharding parameters中的复选标记，然后将分片配置 JSON 粘贴到使用分片示例的文本框中。将此配置保存在外部文件中，以备日后参考。

       分片配置 JSON 定义了shardingEntries数组，该数组指定要分片的集合以及用于分片的键。 MongoDB 仅对包含在该数组中的那些集合进行分片。要了解更多信息，请参阅分片。

       如果省略指定分片配置，则可以在将集群迁移到 Atlas 后对目标集群上的集合进行分片。

     • 除了分片配置之外，正在使用的目标集群上还必须存在指定分片键的兼容索引。

       单击Create supporting indexes中的复选标记，以便 MongoDB 自动在 Atlas 中的目标集群上创建支持分片键索引。

   • 选择用于处理迁移的迁移主机。

   • 如果没有使用私有端点， 请查看 IP 地址访问列表， 并检查迁移主机的外部 IP 地址是否包含在此列表中。如果没有添加， 现在添加：

     • 单击 Set Network Access for Host

     • 单击 + Add IP Address

     • 返回实时迁移向导。 从下拉列表中选择源集群，然后在Migrate data to this cluster 。

   • 从下拉列表中选择源集群。

   • 如果源集群强制执行身份验证，请在提供的文本框中输入用户名和密码。

     有关 Atlas 实时迁移所需的用户权限的指导，请参阅源集群安全性。

   • 如果在 Cloud Manager 中暂停源集群的自动化，但继续使用监控代理监控源集群，则会显示Username和Password 。如果您的部署需要用户身份验证，请在这些字段中提供用户名和密码。您提供的档案的数据库用户必须至少在管理员数据库上具有备份角色，并且必须使用SCRAM-SHA- 1和 SCRAM-SHA- 256进行身份验证。

   • 如果源集群使用TLS / SSL ，请切换Is encryption in transit enabled?按钮。

   • 如果源集群使用带有自定义根证书颁发机构的 TLS/SSL，请从迁移主机复制 CA 文件的路径，并将此路径粘贴到所提供的文本框。此文件必须保存在迁移主机上，确保迁移主机可以读取证书。ATLAS 检查证书是否存在且可读。

   • 如果目标集群有数据，而您想保留这些数据，请保持Clear any existing data on your destination cluster选项处于未选中状态。 如果实时迁移服务发现重复的命名空间，则会向您发出警告。 如果要删除现有数据，请选中此选项。

   • 选择用于连接到集群的连接。 Standard connection在用户界面中始终显示为可用。 但是，仅当您之前为集群配置了 VPC 对等互连或私有端点时，才会启用其他连接选项。 如果 Atlas 检测到您没有配置 VPC 连接或私有端点，这些选项将灰显。

     • 如果您未使用 VPC 对等互连或私有端点，请单击Standard connection并继续执行此步骤的Validation阶段。

     • 如果您在迁移主机和 Atlas 副本集之间配置了VPC 对等互连，则VPC Peering选项处于活动状态。单击VPC Peering以使用 VPC 对等互连进行连接，以实现实时迁移。如果VPC Peering选项显示为灰色，请在开始此过程之前配置 VPC 对等连接。要了解更多信息，请参阅对 VPC 对等互连和私有端点的支持。

     • 如果您在迁移主机和 Atlas 集群之间配置了私有端点，则Private Endpoint选项处于活动状态。单击Private Endpoint （与私有端点连接），然后从下拉列表中选择之前配置的私有端点。只有处于AVAILABLE状态的私有端点才有效。如果Private Endpoint选项显示为灰色，请在开始此过程之前配置私有端点。要了解更多信息，请参阅对 VPC 对等互连和私有端点的支持。

       注意

       对于源集群和目标集群运行 MongoDB 6的推送实时迁移。 0 。 13或更高版本，仅支持部署在单个云提供商和单个区域内的集群。

   • 单击 Validate。验证进程将验证迁移主机是否可访问，并执行以下验证检查，确保您可以启动到 Atlas 的实时迁移。

     要利用以下验证检查，请将 Cloud Manager 中的 MongoDB 助手升级到最新版本。实时迁移期间会运行以下验证检查：

     • 迁移主机可以连接到目标集群。

     • 如果源集群使用带有自定义根证书颁发机构的 TLS/SSL，则迁移主机可以使用 TLS/SSL 访问源集群。

     • 数据库用户凭证有效。只有 在 Cloud Manager 中暂停源集群的自动化， 但继续使用“监控代理”监控源集群时， 才会运行此验证检查。

     • 迁移进程会根据压缩数据的存储大小，验证目标集群是否具有足够的磁盘空间。要了解有关数据和存储大小的更多信息，请参阅dbStats。

   • 如果验证失败，请检查迁移主机、外部 IP 地址或 CIDR 块以及链路令牌的有效性。另请检查数据库用户凭据、TLS/SSL 证书以及目标集群的磁盘存储大小。

   • 如果验证成功，请单击Next 。

开始迁移。

1. 查看列出源组织、项目和集群以及实时迁移进程 将使用的迁移主机的报告。

2. 单击 Start the Migration（连接）。

准备切换。

当延迟计时器和Prepare to Cutover按钮变为绿色时，单击以继续下一步。

执行切换。

当 Atlas 检测到源集群和目标集群几乎同步时，它会启动一个可延长的 120 小时（5 天）定时器，以开始实时迁移过程的切换阶段。120 小时后，Atlas 将停止与源集群同步。您可以通过点击 <time> left to cut over 计时器下方的 Extend time 将剩余时间延长 24 小时。

1. 单击Prepare to Cutover 。 Atlas 显示一个演练屏幕，其中说明： Your migration is almost complete!演练屏幕显示以下有关如何继续切换进程的说明：

   1. 停止您的应用程序。此举可确保不对源集群执行其他写入操作。

   2. 等待 ops/sec 间隙归零。当计数器归零时， 源集群和目标集群同步。

   3. 选中以下复选框： I confirm that I am ready to cut over the application to the destination cluser. By proceeding, Atlas will finalize the migration. This process will take a few seconds. Once it is complete you can point your application at the destination cluster and begin writing to it.

2. 单击Cutover 。 Atlas 完成迁移并显示Connect页面。

3. 决定何时恢复对目标集群的写入。您可以执行以下操作之一：

   • 等待集群卡上的横幅显示： Your cluster migration is complete ，然后恢复对目标集群的写入。 如果选择等待迁移完成，则在完成迁移所需的时间段内，应用程序的写入会暂时暂停。

     或

   • 无需等待迁移完成即可开始将应用程序写入目标集群，而您的集群卡片横幅状态： Your destination cluster in Atlas is ready to accept writes, but we are still finalizing the migration.在最后一个阶段并发出错误时，您必须将写入重定向回源集群并重新启动实时迁移进程。

4. 当您准备好将写入重定向到 Atlas 中的目标集群时：

   1. 使用目标集群的连接字符串连接到您的应用程序。

   2. 确认您的应用程序正在与目标 Atlas 集群一起工作。

Atlas 执行以下操作来完成此进程：

• 从目标群集的 IP 访问列表中 删除MongoDB 实时迁移服务器子网。

• 删除实时迁移用于将数据导入到目标集群的数据库用户。

• 将迁移过程标记为已完成。