/ /

/ /

Atlas のローカル配置の作成

重要

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

このチュートリアルでは、atlas local コマンドを使用してローカル 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

前提条件を完了する

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

重要

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

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

Atlas CLI をインストールします。
Homebrew を使用する場合は、ターミナルで次のコマンドを実行できます。
```
brew install mongodb-atlas-cli
```
その他のオペレーティングシステムへのインストール手順については、「 Atlas CLI のインストールまたは更新」を参照してください。
Dockerをインストールします。
Docker では、MongoDB イメージをプルしてキャッシュするためにネットワーク接続が必要です。
- MacOS またはWindowsの場合は、 Docker Desktop v4.31+ をインストールします。
- Linuxの場合は、Docker Engine v27.0+ をインストールします。
- Linux RHEL の場合は、Pedman v5.0+. を使用することもできます。
（オプション） mongoshバージョン 2.0以降をインストールします。
```
brew install mongosh
```
その他のオペレーティングシステムへのインストール手順については、「 mongoshのインストール」を参照してください。
（任意） Compassバージョン1.39.4以降をインストールします。
```
brew install mongodb-compass
```
その他のオペレーティングシステムでのインストール手順については、「 Compass のダウンロードとインストール」を参照してください。
（任意）Visual Studio Code とMongoDB for VS Code拡張機能をインストールします。
詳しくは、 MongoDB for VS Codeのインストールを参照してください。

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

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

Atlas のローカル配置の作成

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

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

インタラクティブモード（デフォルト） : コマンドは配置設定を要求し、デフォルト値を提供します。
インタラクティブモード（カスタム） : コマンドは配置設定を要求し、カスタム値を指定できるようにします。
非対話型モード: 指定されたオプションを指定してコマンドを実行します。コマンドでは、それ以上の値を指定するように求められません。atlas local がサポートするすべてのアクションについては、 atlas-local を参照してください。

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

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

atlas local setup

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

次のコマンドを実行します:
```
atlas local setup --loadSampleData true
```

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

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

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

例:

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

ローカル 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

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

atlas local setup

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

次のコマンドを実行します:
```
atlas local setup --loadSampleData true
```

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

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

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

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

ローカル 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

配置名を指定します。

例:

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

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

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

例:

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

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

ポートを指定します。

例:

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

オプションを指定して `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 のローカル配置を独自のデータとインデックスを使用して初期化するには:

次のコマンドをコピーします。
```
atlas local setup myLocalRs1 --force --initdb {folder}
```
{folder} プレースホルダーを、ローカルコンテナ内で英数字順に実行するための .js ファイルと .sh ファイルを含むディレクトリに置き換えます。
コマンドを実行します。

Atlas のローカル配置の管理

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

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

例:

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

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

注意

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

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

サンプルデータをダウンロードするには、次のコマンドを実行します。
```
curl  https://atlas-education.s3.amazonaws.com/sampledata.archive -o sampledata.archive
```
次のコマンドをコピーしてターミナルに貼り付け、 {port-number}を配置用のポートに置き換えます。
```
mongorestore --archive=sampledata.archive --port={port-number}
```

配置に接続します。

配置に接続するには、次のコマンドを実行します。
```
atlas local connect
```
接続する配置を指定し、 Enterを押します。
配置への接続方法を指定し、 Enterを押します。
接続文字列を取得したり、次のクライアントに接続したりできます。接続文字列:
- mongosh をインストールした場合 mongosh
- Compass をインストールした場合はMongoDB Compass
- Visual Studio Code 、 Visual Studio Code CLI 、 MongoDB for VS Code拡張機能をインストールした場合は、Visual Studio Code

配置を一時停止します。

配置を一時停止するには、次のコマンドを実行します。
```
atlas local stop
```
一時停止する配置を指定し、 Enterを押します。

配置を開始する

配置を開始するには、次のコマンドを実行します。
```
atlas local start
```
開始する配置を指定し、 Enterを押します。

配置のログを返します。

配置ログを返すには、次のコマンドを実行します。
```
atlas local logs
```
のログを返す配置を指定し、 Enterを押します。

Atlas 配置を削除する

次のコマンドを実行して、配置を削除します。
```
atlas local delete
```
削除する配置を指定し、 Enterを押します。
を指定し、y Enterを押します。をクリックして確認します。

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

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

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

atlas setup

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

atlas local setup

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

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

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

次のコマンドをコピーします。
```
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"
```
{local-deployment-name} プレースホルダーを、ローカル Atlas 配置の名前に置き換えます。
コマンドを実行します。

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

次のコマンドをコピーします。
```
docker cp <local deployment name>:/data/dump/dump.archive .
```
{local-deployment-name} プレースホルダーを、ローカル Atlas 配置の名前に置き換えます。
コマンドを実行します。

接続文字列を返します。

atlas clusters connectionStrings describe

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

次のコマンドをコピーします。
```
mongorestore --uri={connection-string} --archive=./dump.archive
```
{connection-string} プレースホルダーを接続文字列に置き換えます。
コマンドを実行します。

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

atlas local delete

Atlas のローカル配置の更新

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

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

atlas local setup

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

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

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

次のコマンドをコピーします。
```
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"
```
{old-local-deployment-name} プレースホルダーを、古いローカル Atlas 配置の名前に置き換えます。
コマンドを実行します。

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

次のコマンドをコピーします。
```
docker cp {old-local-deployment-name}:/data/dump/dump.archive .
```
{old-local-deployment-name} プレースホルダーを、古いローカル Atlas 配置の名前に置き換えます。
コマンドを実行します。

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

atlas local connect --connectWith connectionString

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

次のコマンドをコピーします。
```
mongorestore --uri={connection-string} --archive=./dump.archive
```
{connection-string} プレースホルダーを接続文字列に置き換えます。
コマンドを実行します。

（任意）古いローカル 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 のローカル配置の問題のトラブルシューティング」を参照してください。

戻る

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

Docker を使用した配置

重要

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

前提条件を完了する

重要

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

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

Atlas のローカル配置の作成

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

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

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

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

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

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

配置名を指定します。

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

ポートを指定します。

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

Atlas のローカル配置の管理

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

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

注意

配置に接続します。

配置を一時停止します。

配置を開始する

配置のログを返します。

Atlas 配置を削除する

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

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

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

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

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

接続文字列を返します。

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

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

Atlas のローカル配置の更新

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

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

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

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

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

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

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

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

重要

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

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

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

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

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

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

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