Atlas CLI は、 Dockerイメージをプルし、ローカルクラスターを配置するためのコンテナを作成します。デフォルトでは 、Atlas CLI はパブリックDockerハブ リポジトリmongodb/mongodb-atlas-local
からプルします。これを構成して、内部レジストリ(通常はプライベート)から特定のイメージをプルすることができます。
このページでは、mongodb-atlas-local
コンテナイメージをプルして再タグ付けし、プライベート レジストリにプッシュして、がローカルクラスターを配置するためにプライベートイメージを使用するように Atlas CLI を構成する方法について説明します。
前提条件
始める前に、以下のものを必ず用意してください。
Dockerコマンドラインツール
書込み (write) 権限を持つプライベートコンテナレジストリ
ターミナル
Atlas CLI
手順
ローカル配置用のMongoDBローカル イメージを取得して再タグ付けします。
プルして再タグ付けするには、次のプレースホルダー値を置き換えた後、次のコマンドを実行します。
| 配置で使用するMongoDBバージョンを指定する タグ。 |
| 書込み (write) アクセス権を持つコンテナレジストリ名前空間の完全修飾パスと名前。 |
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>
書込み (write) アクセス権を持つコンテナレジストリ名前空間の完全修飾パスと名前。
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 配置のローカル配置の作成 」を参照してください。