このチュートリアルでは、Docker を使用してローカル Atlas 配置を作成する方法を説明します。このチュートリアルでは、Docker を使用して単一ノードのレプリカセットを配置する方法を説明します。完全で詳細な Docker Compose の例については、Docker Compose 例を参照してください。
始める前に
必須:
Docker がローカルコンピューターにインストールされ、実行されていること。
MacOS または Windows の場合は、Docker Desktop v4.31 以降をインストールします。
Linux の場合は、Docker エンジン v27.0 以降をインストールします。
コンピュータには、少なくとも 2 GB の空き RAM と 2 個の CPU コアがあります。
使用するポート（デフォルト：27017）は
localhostで利用できます。
推奨:
配置に接続して交流するには、mongosh バージョン 2.0 以降をインストールします。
Docker Composeワークフローの場合は、Docker Compose v1.27 以降をインストします。
バーチャルプライベートクラウド（VPC）、ファイアウォール、プロキシの構成は必要ありません。配置はローカルネットワーク上で実行されます。
Docker を使用したローカル Atlas 配置の作成
Docker をインストールして起動します。
詳しくは、Docker のドキュメント を参照してください。
Docker イメージを実行します。
例:
docker run -p 27017:27017 mongodb/mongodb-atlas-localdocker run -e MONGODB_INITDB_ROOT_USERNAME=user -e MONGODB_INITDB_ROOT_PASSWORD=pass -p 27017:27017 mongodb/mongodb-atlas-localAtlas のコンテナ化された配置を自動化するには、Atlas に接続する前に、コンテナが正常な状態になるまで待機する必要があります。
次の例では、Docker に Atlas イメージを配置し、Docker をポーリングしてコンテナの状態を確認する方法を示します。 コンテナが正常な状態になると、スクリプトはMongosh を使用して Atlas インスタンスへの接続を自動化します。
mongodb-atlas-local.shというファイルを作成し、次のスクリプトを新しいファイルに貼り付けます。# Start mongodb-atlas-local containerecho "Starting the container"CONTAINER_ID=$(docker run --rm -d -P mongodb/mongodb-atlas-local:latest) echo "waiting for container to become healthy..."function wait() {CONTAINER_ID=$1echo "waiting for container to become healthy..."for _ in $(seq 120); do STATE=$(docker inspect -f '{{ .State.Health.Status }}' "$CONTAINER_ID") case $STATE in healthy) echo "container is healthy" return 0 ;; unhealthy) echo "container is unhealthy" docker logs "$CONTAINER_ID" stop exit 1 ;; *) sleep 1 esacdone echo "container did not get healthy within 120 seconds, quitting"docker logs mongodb_atlas_localstopexit 2} wait "$CONTAINER_ID"EXPOSED_PORT=$(docker inspect --format='{{ (index (index .NetworkSettings.Ports "27017/tcp") 0).HostPort }}' "$CONTAINER_ID") # Build the connectionstringCONNECTION_STRING="mongodb://127.0.0.1:$EXPOSED_PORT/test?directConnection=true" # Example usage of the connection string to connect to mongoshmongosh "$CONNECTION_STRING"以下のコマンドを実行して、ファイルを実行可能にします。
chmod +x mongodb-atlas-local.sh実行可能ファイルを実行します。
./mongodb-atlas-local.sh
Atlas のローカル配置に接続します。
ホスト（コンテナではない）からローカルAtlas配置に接続するには、次のコマンドをコピーして新しいターミナルに貼り付け、{connection_string} 変数を接続文字列に置き換えます。
注意
次の例ではmongoshを使用していますが、お好みの接続方法を使用できます。
mongosh {connection_string}例:
mongosh "mongodb://localhost:27017/?directConnection=true"mongosh "mongodb://user:pass@localhost:27017/?directConnection=true"Docker Composer を使用したローカル Atlas 配置の作成
Docker Compose を使用してローカル Atlas 配置を作成します。完全で詳細な例については、Docker Compose 例を参照してください。
注意
公式のMongoDB Dockerイメージを使用してビルドした、既存の Docker-Compose ベースの Atlas実装があり、Atlas ローカル Dev イメージを使用するように変換する場合は、以下の「 ローカル Dev 実装への変換 」を参照してください。
Docker をインストールして起動します。
詳しくは、Docker のドキュメント を参照してください。
Docker Composer をインストールします。
例:
brew install docker-compose詳しくは、Docker Compose のインストールに関するドキュメント を参照してください。
docker-compose.yaml ファイルを作成します。
Docker Composer を実行するのと同じディレクトリに docker-compose.yamlファイルを作成します。完全で詳細な例については、Docker Compose 例を参照してください。
例:
services: mongodb: image: mongodb/mongodb-atlas-local environment: - MONGODB_INITDB_ROOT_USERNAME=user - MONGODB_INITDB_ROOT_PASSWORD=pass ports: - 27018:27017Atlas のローカル配置に接続します。
ホスト（コンテナではない）からローカルAtlas配置に接続するには、次のコマンドをコピーして新しいターミナルに貼り付け、{connection_string} 変数を接続文字列に置き換えます。
注意
次の例ではmongoshを使用していますが、お好みの接続方法を使用できます。
mongosh {connection_string}例:
mongosh "mongodb://user:pass@localhost:27018/?directConnection=true"Docker Composer による実行間でのデータの永続化
Docker Compose を使用すると、複数の実行にわたってデータを永続化できます。データを永続化すると、実行間でデータが失われるのを防ぐことができます。Docker Compose の実行全体でデータは引き続き利用できます。
Docker をインストールして起動します。
詳しくは、Docker のドキュメント を参照してください。
Docker Composer をインストールします。
例:
brew install docker-compose詳しくは、Docker Compose のインストールに関するドキュメント を参照してください。
docker-compose.yaml ファイルを作成します。
docker-compose.yamlファイルを更新して、必要なデータディレクトリをボリュームとしてマウントします。
例:
services: mongodb: hostname: mongodb image: mongodb/mongodb-atlas-local environment: - MONGODB_INITDB_ROOT_USERNAME=user - MONGODB_INITDB_ROOT_PASSWORD=pass ports: - 27019:27017 volumes: - data:/data/db - config:/data/configdbvolumes: data: config:Docker Composer を実行します。
次の コマンドは、 MongoDB Search 機能が有効になっている Atlas のローカル配置を作成します。
例:
docker-compose upDocker Compose を デプロイメントモードで実行することもできます。
例:
docker-compose up -dAtlas のローカル配置に接続します。
ホスト（コンテナではない）からローカルAtlas配置に接続するには、次のコマンドをコピーして新しいターミナルに貼り付け、{connection_string} 変数を接続文字列に置き換えます。
注意
次の例ではmongoshを使用していますが、お好みの接続方法を使用できます。
mongosh {connection_string}例:
mongosh "mongodb://user:pass@localhost:27019/?directConnection=true"依存関係のリストの生成
mongodb/mongodb-atlas-local Docker イメージの依存関係のリストを生成できます。
イメージ署名の検証
mongodb/mongodb-atlas-local Docker イメージの署名を検証できます。
Githubアクションでイメージを実行
Githubアクションで mongodb/mongodb-atlas-local Dockerイメージを実行するには、 ワークフローファイルを作成します。 詳細については、Github Actions クイックスタート を参照してください。
例:
.github/workflowsディレクトリに次のmongodb.ymlファイルを作成します。
on: push: branches: - main pull_request:jobs: run: runs-on: ubuntu-latest services: mongodb: image: mongodb/mongodb-atlas-local ports: - 27017:27017 steps: - name: install mongosh run: | curl --output mongosh.deb https://downloads.mongodb.com/compass/mongodb-mongosh_2.2.1_amd64.deb sudo dpkg -i mongosh.deb mongosh --version - run: mongosh 'mongodb://localhost/?directConnection=true' --eval 'show dbs'公式イメージをローカル Atlas デプロイメントに変換
公式の実装 mongo Dockerイメージを使用して構築したDocker Compose で実装実行中の既存の Atlas がある場合は、次のチェックリストを参照して、 mongodb-atlas-local イメージへの変換を簡素化できます。
既存の
commandをdocker-compose.yamlファイルから削除します。 Docker複合定義のcommandはmongodb-atlas-localイメージで定義されたENTRYPOINTを上書きするため、mongodb-atlas-localイメージが設計どおりに実行されるようにするには、既存のcommandを削除する必要があります。この機能は
mongodb-atlas-localイメージに組み込まれているため、Atlas 配置のヘルスチェックを定義する必要はありません。
Dockerによる更新の例
次の例は、 Docker Compose YAMLファイルに対して必要になる可能性のある変更を示しています。
services: self_built_atlas_implementation: image: mongo:8.0 ports: - 27017:27017 command: ["./entrypoint.sh"] # You may have defined a health check for the database in the entrypoint script.services: local_dev_atlas: image: mongodb/mongodb-atlas-local:8.0 hostname: local_dev_atlas ports: - 27017:27017 environment: - MONGODB_INITDB_ROOT_USERNAME=user - MONGODB_INITDB_ROOT_PASSWORD=pass volumes: - data:/data/db - config:/data/configdbvolumes: - data: - config:配置を確認します
コンテナを起動した後、配置が実行されていること、接続できることを確認します。
チェックポイント | 検証ステップ |
|---|---|
イメージが引き出されました |
|
コンテナの実行中 |
|
コンテナの健康状態 |
|
接続に成功しました | 接続文字列（例： |
データ ボリュームが存在します (任意) |
|
次のステップ
Docker を使用してローカル Atlas 配置を作成して検証した後、次の操作を行うことができます。
アプリケーションを接続する: アプリケーションの構成で接続文字列を使用します。
データの永続性を構成する: Docker ボリュームをマップして、コンテナの再起動後もデータを保持します。詳細については、Docker を使用してローカル Atlas 配置を作成するを参照してください。
Docker Compose ワークフローを使用する: 複数のサービスアプリケーションの場合は、配置を
docker-compose.yamlファイルに統合します。完全な例については、Docker Compose の例を参照してください。データの検索: MongoDB Search を使用して、ローカル配置で検索インデックスを作成およびテストします。詳細な手順については、 「MongoDB Search インデックスの作成とクエリの実行」を参照してください。
代わりに Atlas CLI を使用します。CLI マネージドのローカル配置については、「ローカル Atlas 配置の作成」を参照してください。