Docs Menu
Docs Home
/ /
ローカルとクラウドの配置
Docs Home
/ /
Atlas の管理
/
ローカルとクラウドの配置
Docs Home
/
ツール
/
Atlas CLI
/
Atlas の管理
/
ローカルとクラウドの配置

Atlas のローカル配置の作成

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

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

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

MacOS

13.2 以降

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. （任意） Compassバージョン1.39.4以降をインストールします。

    brew install mongodb-compass

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

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

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

2

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

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

Atlas のローカル配置の作成

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

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

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

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

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

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

1

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

atlas deployments setup

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

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

    atlas deployments setup --initdb {folder}

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

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

2

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

例:

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

? 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 deployments コマンドを 対話モードで実行します。

atlas deployments setup

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

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

    atlas deployments 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 deployments コマンドを実行します。

例:

atlas deployments setup myLocalRs1 --type local --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 deployments setup myLocalRs1 --type local --force --initdb {folder}

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

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

Atlas のローカル配置の管理

Atlas のローカル配置を管理するには、 atlas deploymentsコマンドを使用します。 Atlas のローカル配置とクラウド配置の両方で次のコマンドを使用できます。 --type localまたは--type atlasを使用して、それぞれローカルまたはクラウドの Atlas 配置に対して コマンドを実行できます。

1

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

例:

atlas deployments 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

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

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

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

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

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

配置に接続します。

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

    atlas deployments connect

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

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

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

4

配置を一時停止します。

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

    atlas deployments pause

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

5

配置を開始する

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

    atlas deployments start

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

6

配置のログを返します。

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

    atlas deployments logs

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

Atlas 配置を削除する

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

    atlas deployments delete

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

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

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

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

1

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

atlas deployments setup --type atlas
2

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

atlas deployments setup --type local

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

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

    atlas deployments setup --type local --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 deployments connect --type atlas --connectWith connectionString
6

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

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

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

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

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

7

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

atlas deployments delete --type local

Atlas のローカル配置の更新

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

1

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

atlas deployments setup --type local

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

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

    atlas deployments setup --type local --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 deployments connect --type local --connectWith connectionString
5

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

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

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

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

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

6

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

atlas deployments delete --type local

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

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

このコマンドは、ローカルおよびクラウドのAtlas 配置で実行できます。詳細な手順については、 「 MongoDB Search インデックスの作成 」と「 クエリの実行 」を参照してください。

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

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

このコマンドは、ローカルおよびクラウドのAtlas 配置で実行できます。詳細な手順については、Atlas 配置でMongoDB ベクトル検索 を使用する を参照してください。

重要

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

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

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

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

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

戻る

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

次へ

Docker を使用した配置

項目一覧