AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu
Docs Home
/ /
ローカルとクラウドの配置
Docs Home
/ /
Atlas の管理
/
ローカルとクラウドの配置
Docs Home
/
ツール
/
Atlas CLI
/
Atlas の管理
/
ローカルとクラウドの配置

Atlas のローカル配置の作成

重要

Atlas CLI バージョン 1.52.0 以降、atlas deployments コマンドは非推奨です。代わりに atlas local コマンドを使用してください。このチュートリアルを atlas local コマンドを使用するように更新しました。

このチュートリアルでは、atlas local コマンドを使用してローカル Atlas 配置を作成する方法を説明します。このチュートリアルでは、ローカル コンピューターに単一ノードのレプリカセットを配置します。その後に配置を管理し、 MongoDB Search とMongoDB ベクトル検索 を使用できるようになります。

Atlas のローカル配置でサポートされている OS

オペレーティング システム
オペレーティング システムのバージョン
アーキテクチャ
最小 CPU コア
最小無料 RAM（GB）

MacOS

最新

x86-64、ARM

2

2

Red Hat Enterprise Linux / CentOS

8, 9

x86-64、ARM

2

2

Ubuntu

22.04, 24.04

x86-64、ARM

2

2

Debian

11, 12

x86-64、ARM

2

2

Amazon Linux

2023

x86-64、ARM

2

2

Windows

10, 11

x86

2

2

前提条件を完了する

始める前に、次の前提条件を完了してください。

重要

依存関係リスト内の各製品の互換性情報については、製品のインストール ドキュメントを参照してください。

1

依存関係をインストールします。

  1. Atlas CLI をインストールします。

    Homebrew を使用する場合は、ターミナルで次のコマンドを実行できます。

    brew install mongodb-atlas-cli

    その他のオペレーティング システムへのインストール手順については、「 Atlas CLI のインストールまたは更新 」を参照してください。

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

    Docker では、MongoDB イメージをプルしてキャッシュするためにネットワーク接続が必要です。

  3. （任意） mongoshバージョン 2.0 以降をインストールします。

    brew install mongosh

    その他のオペレーティング システムへのインストール手順については、 mongosh のインストール を参照してください。

  4. (Optional) Install Compass version 1.39.4 or later.

    brew install mongodb-compass

    その他のオペレーティング システムでのインストール手順については、Compass のダウンロードとインストール を参照してください。

  5. （任意）Visual Studio Code とMongoDB for VS Code拡張機能をインストールします。

    詳しくは、 MongoDB for VS Codeのインストール を参照してください。

2

Atlas アカウントを作成します。

Atlasatlas setup アカウントがまだない場合は、ターミナルで を実行するか、新しいアカウントを作成してください。

Atlas のローカル配置の作成

Atlas のローカル配置を作成するには、 atlas localコマンドを使用します。

このコマンドは、次の方法で実行できます。

  • インタラクティブ モード（デフォルト） : コマンドは配置設定を要求し、デフォルト値を提供します。

  • インタラクティブ モード（カスタム） : コマンドは配置設定を要求し、カスタム値を指定できるようにします。

  • 非対話型モード: 指定されたオプションを指定して コマンドを実行します。コマンドでは、それ以上の値を指定するように求められません。atlas local がサポートするすべてのアクションについては、 atlas-local を参照してください。

次のいずれかのタブをクリックすると、ご希望モードのコマンドが表示されます。

1

atlas localコマンドを 対話モードで実行します。

atlas local setup

設定時にMongoDBサンプルデータをロードするには:

  1. 次のコマンドを実行します:

    atlas local setup --loadSampleData true

Atlas のローカル配置を独自のデータとインデックスを使用して初期化するには:

  1. 次のコマンドをコピーします。

    atlas local setup --initdb {folder}

  2. {folder} プレースホルダーを、ローカルコンテナ内で英数字順に実行するための .js ファイルと .sh ファイルを含むディレクトリに置き換えます。

  3. コマンドを実行します。

2

配置する対象を指定します。

例:

local - Local DatabaseEnterを指定し、 を押します。

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database
[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017
3

ローカル Atlas データベースを設定する方法を指定します。

例:

default - With default settingsEnterを指定し、 を押します。

? How do you want to setup your local MongoDB database?  [Use arrows to move, type to filter]
> default - With default settings
  custom - With custom settings
  cancel - Cancel set up
Creating your deployment local50 [this might take several minutes]
1/4: Downloading and completing configuration...
2/4: Starting your local environment...
3/4: Downloading MongoDB binaries to your local environment...
4/4: Creating your deployment local50...
Deployment created!
Connection string: mongodb://localhost:27017/?directConnection=true
1

atlas localコマンドを 対話モードで実行します。

atlas local setup

設定時にMongoDBサンプルデータをロードするには:

  1. 次のコマンドを実行します:

    atlas local setup --loadSampleData true

Atlas のローカル配置を独自のデータとインデックスを使用して初期化するには:

  1. 次のコマンドをコピーします。

    atlas local setup --initdb {folder}

  2. {folder} プレースホルダーを、ローカルコンテナ内で英数字順に実行するための .js ファイルと .sh ファイルを含むディレクトリに置き換えます。

  3. コマンドを実行します。

2

配置する対象を指定します。

local - Local DatabaseEnterを指定し、 を押します。

例:

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database
[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017
3

ローカル Atlas データベースを設定する方法を指定します。

例:

custom - With custom settingsEnterを指定し、 を押します。

? How do you want to setup your local MongoDB database?  [Use arrows to move, type to filter]
  default - With default settings
> custom - With custom settings
  cancel - Cancel set up
4

配置名を指定します。

例:

myLocalRsEnterを指定し、 を押します。

? Deployment Name [This can't be changed later] (local3612) myLocalRs
5

MongoDB のバージョンを指定します。

例:

7.0Enterを指定し、 を押します。

? MongoDB Version  [Use arrows to move, type to filter]
> 7.0
  6.0
6

ポートを指定します。

例:

37018Enterを指定し、 を押します。

? Specify a port (49469) 37018
Creating your deployment myLocalRs
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs...
Deployment created!
Connection string: mongodb://localhost:37018/?directConnection=true
1

atlas localオプションを指定して コマンドを実行します。

例:

atlas local setup myLocalRs1 --force
[Default Settings]
Deployment Name      myLocalRs1
MongoDB Version   7.0
Port              49684
Creating your deployment myLocalRs1
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs1...
Deployment created!
Connection string: mongodb://localhost:49684/?directConnection=true
connection skipped

Atlas のローカル配置を独自のデータとインデックスを使用して初期化するには:

  1. 次のコマンドをコピーします。

    atlas local setup myLocalRs1 --force --initdb {folder}

  2. {folder} プレースホルダーを、ローカルコンテナ内で英数字順に実行するための .js ファイルと .sh ファイルを含むディレクトリに置き換えます。

  3. コマンドを実行します。

Python の代替案: ローカル Atlas 配置の作成

Atlas CLI の代わりに、atlas-local-lib-py Python ライブラリを使用して、ローカル Atlas データベース配置をプログラムで作成および管理できます。このアプローチは、Python ベースのワークフロー、自動テスト、Python アプリケーションとの統合に役立ちます。

前提条件

開始する前に、次のものをお持ちであることを確認してください。

  • Python 3.10 以降

  • Docker Desktop または Docker エンジンがインストールされて実行されていること

ライブラリのインストール

pip を使用して atlas-local-lib-py をインストールします。

pip install atlas-local-lib-py

配置の作成または再利用

次の Python コードを使用して新しいローカルデータベース配置を作成するか、一致する配置で既存のものを再利用します。

from atlas_local import LocalDeployment
# Create or reuse a deployment named "my-local-deployment"
deployment = LocalDeployment.get_or_create(
    name="my-local-deployment"
)
# Get the connection string
connection_string = deployment.connection_string()
print(f"Connection string: {connection_string}")

get_or_create()メソッド:

  • 指定された名前の配置が存在しない場合は、新しい配置を作成します

  • 指定された名前の配置が既に存在する場合は、既存の配置を再利用します

  • LocalDeployment オブジェクトを返します。これを使用して配置を管理できます

  • Docker コンテナのライフサイクルを自動的に取り扱います

サンプル データのロード

次の Python メソッドを使用して MongoDB サンプル データを配置にロードします。

from atlas_local import LocalDeployment
deployment = LocalDeployment.get_or_create(
    name="my-local-deployment"
)
# Load sample data
deployment.load_sample_data()

Pythonライブラリの詳細については、 atlas-local-lib-pyリポジトリ を参照してください。

Atlas のローカル配置の管理

Atlas のローカル配置を管理するには、 atlas localコマンドを使用します。

1

利用可能な配置を一覧表示します。

例:

atlas local list
NAME        TYPE    MDB VER   STATE
local50     LOCAL   7.0.1     IDLE
local62     LOCAL   7.0.1     IDLE
myLocalRs   LOCAL   7.0.1     IDLE
myLocalRs1  LOCAL   7.0.1     IDLE
2

サンプル データをロードします。

注意

また、atlas local setup と --loadSampleData true オプションを併用して、配置設定中にサンプルデータを読み込むこともできます。上記の 設定例 を参照してください。

サンプルデータを既存の配置にロードするには、以下を行います。

  1. サンプル データをダウンロードするには、次のコマンドを実行します。

    curl  https://atlas-education.s3.amazonaws.com/sampledata.archive -o sampledata.archive

  2. 次のコマンドを実行し、配置を選択して、配置のポート番号を取得します。

    atlas local connect --connectWith connectionString

    接続文字列にはポート番号が含まれます。例、接続文字列mongodb://localhost:27017/?directConnection=true では、ポート番号は 27017 です。

  3. 配置のポート番号を取得します。

    1. 次のコマンドをコピーします。

      atlas local connect <deployment name> --connectWith connectionString

    2. <deployment name> を配置名に置き換えます。

    3. コマンドを実行します。

      接続文字列にはポート番号が含まれます。例、接続文字列mongodb://localhost:27017/?directConnection=true では、ポート番号は 27017 です。

  4. 次のコマンドをコピーしてターミナルに貼り付け、 {port-number}を配置用のポートに置き換えます。

    mongorestore --archive=sampledata.archive --port={port-number}
3

配置に接続します。

  1. 配置に接続するには、次のコマンドを実行します。

    atlas local connect

  2. 接続する配置を指定し、 Enterを押します。

  3. 配置に接続する方法を指定し、 Enterを押します。

    接続文字列を取得したり、次のクライアントに接続したりできます。接続文字列:

4

配置を一時停止します。

  1. 配置を一時停止するには、次のコマンドを実行します。

    atlas local stop

  2. 一時停止する配置を指定し、 Enterを押します。

5

配置を開始する

  1. 配置を開始するには、次のコマンドを実行します。

    atlas local start

  2. 開始する配置を指定し、Enterを押します。

6

配置のログを返します。

  1. 配置ログを返すには、次のコマンドを実行します。

    atlas local logs

  2. ログを返す配置を指定し、Enterを押します。

Atlas 配置を削除する

  1. 次のコマンドを実行して、配置を削除します。

    atlas local delete

  2. 削除する配置を指定し、Enter を押します。

  3. を指定し、y Enterを押します。をクリックして確認します。

Atlas のローカル配置のクラウド Atlas 配置への移行

DockerとMongoDB Database Toolsを使用して、ローカル Atlas 配置をクラウドAtlas 配置に移動できます。

1

Atlas のクラウド配置を作成します。

atlas setup
2

Atlas のローカル配置の作成。

atlas local setup

Atlas のローカル配置を独自のデータとインデックスを使用して初期化するには:

  1. 次のコマンドをコピーします。

    atlas local setup --initdb {folder}

  2. {folder} プレースホルダーを、ローカルコンテナ内で英数字順に実行するための .js ファイルと .sh ファイルを含むディレクトリに置き換えます。

  3. コマンドを実行します。

3

データのバイナリファイルを作成します。

  1. 次のコマンドをコピーします。

    docker exec -u root -it {local_deployment_name} sh -c "mkdir -p /data/dump && chown -R mongod:mongod /data/dump && mongodump --archive=/data/dump/dump.archive"

  2. {local-deployment-name} プレースホルダーを、ローカル Atlas 配置の名前に置き換えます。

  3. コマンドを実行します。

4

アーカイブをコピーします。

  1. 次のコマンドをコピーします。

    docker cp <local deployment name>:/data/dump/dump.archive .

  2. {local-deployment-name} プレースホルダーを、ローカル Atlas 配置の名前に置き換えます。

  3. コマンドを実行します。

5

接続文字列を返します。

atlas clusters connectionStrings describe
6

アーカイブファイルから復元します。

  1. 次のコマンドをコピーします。

    mongorestore --uri={connection-string} --archive=./dump.archive

  2. {connection-string} プレースホルダーを接続文字列に置き換えます。

  3. コマンドを実行します。

7

（任意）Atlas のローカル配置を削除します。

atlas local delete

Atlas のローカル配置の更新

DockerとMongoDB Database Toolsを使用して、ローカル Atlas 配置を新しいバージョンの イメージに更新できます。

1

新しいローカル Atlas 配置を作成します。

atlas local setup

Atlas のローカル配置を独自のデータとインデックスを使用して初期化するには:

  1. 次のコマンドをコピーします。

    atlas local setup --initdb {folder}

  2. {folder} プレースホルダーを、ローカルコンテナ内で英数字順に実行するための .js ファイルと .sh ファイルを含むディレクトリに置き換えます。

  3. コマンドを実行します。

2

データのバイナリファイルを作成します。

  1. 次のコマンドをコピーします。

    docker exec -u root -it {old-local-deployment-name} sh -c "mkdir -p /data/dump && chown -R mongod:mongod /data/dump && mongodump --archive=/data/dump/dump.archive"

  2. {old-local-deployment-name} プレースホルダーを、古いローカル Atlas 配置の名前に置き換えます。

  3. コマンドを実行します。

3

アーカイブをコピーします。

  1. 次のコマンドをコピーします。

    docker cp {old-local-deployment-name}:/data/dump/dump.archive .

  2. {old-local-deployment-name} プレースホルダーを、古いローカル Atlas 配置の名前に置き換えます。

  3. コマンドを実行します。

4

新しい接続文字列を返します。

atlas local connect --connectWith connectionString
5

アーカイブファイルから復元します。

  1. 次のコマンドをコピーします。

    mongorestore --uri={connection-string} --archive=./dump.archive

  2. {connection-string} プレースホルダーを接続文字列に置き換えます。

  3. コマンドを実行します。

6

（任意）古いローカル Atlas 配置を削除します。

atlas local delete

Atlas のローカル配置でMongoDB Search を使用する

MongoDB Search検索インデックスを作成するには、atlas local search indexes create コマンドを使用します。その後、 MongoDB Search クエリを実行できます。詳しくは、 MongoDB Search を参照してください。

詳細な手順については、 「 MongoDB Search インデックスの作成 」と「 クエリの実行 」を参照してください。

Atlas のローカル配置でMongoDB ベクトル検索 を使用する

MongoDB ベクトル検索 を操作するには、atlas local search indexes create コマンドを使用します。詳細については、 「 ベクトル検索用のベクトル埋め込みのインデックス作成方法 」を参照してください。

詳細な手順については、Atlas 配置でMongoDB ベクトル検索 を使用する を参照してください。

重要

MongoDB ベクトル検索で Atlas CLI を使用するには、 MongoDB 7.0.5 以降で Atlas 配置を作成する必要があります。以前のMongoDBバージョンでローカル Atlas 配置を作成した場合、自動的に最新のMongoDBバージョンは取得されません。以前のイメージと配置を削除する必要があります。その後、新しい Atlas 配置を作成する必要があります。

サポートされているアクション

atlas local がサポートするすべてのアクションについては、 atlas-local を参照してください。

次のステップ

ローカル Atlas 配置を作成して検証した後、次の操作を実行できます。

エラーのトラブルシューティング

Atlas のローカル配置の問題のトラブルシューティングの詳細については、「 Atlas のローカル配置の問題のトラブルシューティング 」を参照してください。

戻る
ローカルとクラウドの配置
次へ
Docker を使用した配置
このページを評価

項目一覧