/ /

ローカルとクラウドの配置

Docs Home

/ /

Docker を使用したローカル Atlas 配置の作成

このチュートリアルでは、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で利用できます。

推奨:

Install mongosh version 2.0 or later to connect to and interact with the deployment.
Docker Composeワークフローの場合は、Docker Compose v1.27 以降をインストします。

バーチャルプライベートクラウド（VPC）、ファイアウォール、プロキシの構成は必要ありません。配置はローカルネットワーク上で実行されます。

Docker を使用したローカル Atlas 配置の作成

Docker をインストールして起動します。

詳しくは、Docker のドキュメントを参照してください。

`mongodb/mongodb-atlas-local` Docker イメージをプルします。

例:

docker pull mongodb/mongodb-atlas-local:latest

Docker イメージを実行します。

例:

docker run -p 27017:27017 mongodb/mongodb-atlas-local

docker run -e MONGODB_INITDB_ROOT_USERNAME=user -e MONGODB_INITDB_ROOT_PASSWORD=pass -p 27017:27017 mongodb/mongodb-atlas-local

Atlas のコンテナ化された配置を自動化するには、Atlas に接続する前に、コンテナが正常な状態になるまで待機する必要があります。

The following example demonstrates deploying an Atlas image in Docker and polling Docker to check the state of the container. Once the container is in a healthy state, the script automates a connection to your Atlas instance with Mongosh.

mongodb-atlas-local.shというファイルを作成し、次のスクリプトを新しいファイルに貼り付けます。

# Start mongodb-atlas-local container
echo "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=$1
echo "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
      esac
done
echo "container did not get healthy within 120 seconds, quitting"
docker logs mongodb_atlas_local
stop
exit 2
}
wait "$CONTAINER_ID"
EXPOSED_PORT=$(docker inspect --format='{{ (index (index .NetworkSettings.Ports "27017/tcp") 0).HostPort }}' "$CONTAINER_ID")
# Build the connectionstring
CONNECTION_STRING="mongodb://127.0.0.1:$EXPOSED_PORT/test?directConnection=true"
# Example usage of the connection string to connect to mongosh
mongosh "$CONNECTION_STRING"

以下のコマンドを実行して、ファイルを実行可能にします。
chmod +x mongodb-atlas-local.sh
実行可能ファイルを実行します。
./mongodb-atlas-local.sh

Atlas のローカル配置に接続します。

ホスト（コンテナではない）からローカルAtlas配置に接続するには、次のコマンドをコピーして新しいターミナルに貼り付け、{connection_string} 変数を接続文字列に置き換えます。

注意

The following example uses mongosh, but you can use the connection method that you prefer.

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 例を参照してください。

例:

1 services:
2   mongodb:
3     image: mongodb/mongodb-atlas-local
4     environment:
5       - MONGODB_INITDB_ROOT_USERNAME=user
6       - MONGODB_INITDB_ROOT_PASSWORD=pass
7     ports:
8       - 27018:27017

Docker Composer を実行します。

次のコマンドは、 MongoDB Search 機能が有効になっている Atlas のローカル配置を作成します。

例:

docker-compose up

Atlas のローカル配置に接続します。

注意

The following example uses mongosh, but you can use the connection method that you prefer.

mongosh {connection_string}

例:

mongosh "mongodb://user:pass@localhost:27018/?directConnection=true"

（任意）コンテナを停止します。

docker compose down -v

Docker Composer による実行間でのデータの永続化

Docker Compose を使用すると、複数の実行にわたってデータを永続化できます。データを永続化すると、実行間でデータが失われるのを防ぐことができます。Docker Compose の実行全体でデータは引き続き利用できます。

Docker をインストールして起動します。

詳しくは、Docker のドキュメントを参照してください。

Docker Composer をインストールします。

例:

brew install docker-compose

詳しくは、Docker Compose のインストールに関するドキュメントを参照してください。

`docker-compose.yaml` ファイルを作成します。

docker-compose.yamlファイルを更新して、必要なデータディレクトリをボリュームとしてマウントします。

例:

1 services:
2   mongodb:
3     hostname: mongodb
4     image: mongodb/mongodb-atlas-local
5     environment:
6       - MONGODB_INITDB_ROOT_USERNAME=user
7       - MONGODB_INITDB_ROOT_PASSWORD=pass
8     ports:
9       - 27019:27017
10     volumes:
11       - data:/data/db
12       - config:/data/configdb
13 volumes:
14   data:
15   config:

Docker Composer を実行します。

次のコマンドは、 MongoDB Search 機能が有効になっている Atlas のローカル配置を作成します。

例:

docker-compose up

Docker Compose をデプロイメントモードで実行することもできます。

例:

docker-compose up -d

Atlas のローカル配置に接続します。

注意

The following example uses mongosh, but you can use the connection method that you prefer.

mongosh {connection_string}

例:

mongosh "mongodb://user:pass@localhost:27019/?directConnection=true"

依存関係のリストの生成

mongodb/mongodb-atlas-local Docker イメージの依存関係のリストを生成できます。

Install syft.

例:

brew install syft

詳しくは、 syft README を参照してください。

Run syft.

syft mongodb/mongodb-atlas-local

イメージ署名の検証

mongodb/mongodb-atlas-local Docker イメージの署名を検証できます。

cosign をインストールします。

例:

brew install cosign

詳細については、cosign のインストールを参照してください。

次のコマンドを実行します。

例:

curl -O https://cosign.mongodb.com/mongodb-atlas-local.pem

COSIGN_REPOSITORY="docker.io/mongodb/signatures" cosign verify --private-infrastructure --key=./mongodb-atlas-local.pem "mongodb/mongodb-atlas-local";

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/configdb
volumes:
  - data:
  - config:

配置を確認します

コンテナを起動した後、配置が実行されていること、接続できることを確認します。

チェックポイント	検証ステップ
イメージが引き出されました	`docker images \| grep mongodb-atlas-local` を実行する。画像が出力に表示されます。
コンテナの実行中	`docker ps` を実行する。コンテナはステータス `Up` で表示されます。
コンテナの健康状態	`docker inspect <container-id> \| grep Health` を実行する。ステータスは `healthy` を示します。
接続に成功しました	Connect with `mongosh` using the connection string (for example, `mongodb://localhost:27017/?directConnection=true`).
データボリュームが存在します (任意)	`docker volume ls` を実行する。データボリュームが出力に表示されます。

次のステップ

Docker を使用してローカル Atlas 配置を作成して検証した後、次の操作を行うことができます。

アプリケーションを接続する: アプリケーションの構成で接続文字列を使用します。
Configure data persistence: Map Docker volumes to retain data across container restarts. See Create a Local Atlas Deployment with Docker for details.
Docker Compose ワークフローを使用する: 複数のサービスアプリケーションの場合は、配置を docker-compose.yaml ファイルに統合します。完全な例については、Docker Compose の例を参照してください。
|fts|の使用: ローカル配置で検索インデックスを作成してテストします。詳細な手順については、「MongoDB Search インデックスの作成とクエリの実行」を参照してください。
代わりに Atlas CLI を使用します。CLI マネージドのローカル配置については、「ローカル Atlas 配置の作成」を参照してください。

戻る

ローカル配置の作成

Docker Composeの例

1	services:
2	mongodb:
3	image: mongodb/mongodb-atlas-local
4	environment:
5	- MONGODB_INITDB_ROOT_USERNAME=user
6	- MONGODB_INITDB_ROOT_PASSWORD=pass
7	ports:
8	- 27018:27017

1	services:
2	mongodb:
3	hostname: mongodb
4	image: mongodb/mongodb-atlas-local
5	environment:
6	- MONGODB_INITDB_ROOT_USERNAME=user
7	- MONGODB_INITDB_ROOT_PASSWORD=pass
8	ports:
9	- 27019:27017
10	volumes:
11	- data:/data/db
12	- config:/data/configdb
13	volumes:
14	data:
15	config:

Docker を使用したローカル Atlas 配置の作成

始める前に

Docker を使用したローカル Atlas 配置の作成

Docker をインストールして起動します。

mongodb/mongodb-atlas-local Docker イメージをプルします。

Docker イメージを実行します。

Atlas のローカル配置に接続します。

Docker Composer を使用したローカル Atlas 配置の作成

Docker をインストールして起動します。

Docker Composer をインストールします。

docker-compose.yaml ファイルを作成します。

Docker Composer を実行します。

Atlas のローカル配置に接続します。

（任意） コンテナを停止します。

Docker Composer による実行間でのデータの永続化

Docker をインストールして起動します。

Docker Composer をインストールします。

docker-compose.yaml ファイルを作成します。

Docker Composer を実行します。

Atlas のローカル配置に接続します。

依存関係のリストの生成

Install syft.

Run syft.

イメージ署名の検証

cosign をインストールします。

次のコマンドを実行します。

Githubアクションでイメージを実行

公式イメージをローカル Atlas デプロイメントに変換

Dockerによる更新の例

配置を確認します

次のステップ

`mongodb/mongodb-atlas-local` Docker イメージをプルします。

`docker-compose.yaml` ファイルを作成します。

（任意）コンテナを停止します。

`docker-compose.yaml` ファイルを作成します。