Atlas CLI会拉取Docker映像并创建容器，以部署本地集群。默认下， Atlas CLI从公共Docker Hub 存储库mongodb/mongodb-atlas-local 中拉取。您可以将其配置为从内部（通常是私有）注册表中提取特定映像。
本页介绍如何拉取并重新标记 mongodb-atlas-local容器映像，将其推送到私有注册表，然后配置Atlas CLI以使用私有映像来部署本地集群。
先决条件
在开始之前，请确保您具备以下内容：
Docker命令行工具
您具有写入权限的私有容器注册表
一个终端
Atlas CLI
步骤
拉取并重新标记MongoDB本地映像以进行本地部署。
要提取并重新标记，请在替换以下占位符值后运行以下命令：
| 标签，指定您要在部署中使用的MongoDB版本。 |
| 您具有写入访问权限的容器注册表命名空间的完全限定路径和名称。 |
docker tag mongodb/mongodb-atlas-local:<tag> <container-registry-namespace>/mongodb-atlas-local:<tag>
注意
Atlas CLI支持部署MongoDB版本7 和8 。为了支持使用Atlas CLI从注册表部署任一版本，您必须对7.0 和8.0 标签重复此步骤。有关可用标签的列表，请参阅 Docker Hub存储库。
将计算机上的映像推送到容器注册表。
替换以下占位符值后运行以下命令，将映像推送到容器注册表：
<tag>标签，指定您要在部署中使用的MongoDB版本。
<container-registry-namespace>您具有写入访问权限的容器注册表命名空间的完全限定路径和名称。
docker push <container-registry-namespace>/mongodb-atlas-local:<tag> 此操作可能需要几分钟才能完成。
注意
Atlas CLI支持部署MongoDB版本 7 和 8。为了支持使用Atlas CLI从注册表部署任一版本，您必须对 7.0 和 8.0 标签重复此步骤。
验证映像是否已成功上传。
您可以通过以下方式进行验证：
登录容器注册表并验证映像是否已成功上传。
运行
docker pull命令以将映像从注册表拉取到计算机。
配置Atlas CLI以使用注册表中的映像。
将
<container-registry-namespace>替换为您在步骤 2 中创建的容器注册表命名空间的完全限定路径和名称，然后设置MONGODB_ATLAS_LOCAL_DEPLOYMENT_IMAGE环境变量。export MONGODB_ATLAS_LOCAL_DEPLOYMENT_IMAGE=<container-registry-namespace>/mongodb-atlas-local 注意
此方法仅为当前终端会话设置环境变量。要在终端会话中保持此设置，请在配置文件中设立此环境变量。
验证环境变量设立是否正确。
echo $MONGODB_ATLAS_LOCAL_DEPLOYMENT_IMAGE
设立环境变量后， Atlas CLI会为所有部署使用该变量的值，而不是默认位置。
使用您的映像部署Atlas 。
将
<deploymentName>替换为部署的名称后，运行以下命令启动部署。atlas deployments setup <deploymentName> 当提示您指定部署类型时，输入
local。根据提示选择适当的设置以完成部署。
要了解更多信息，请参阅创建本地 Atlas 部署。