重要
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 |
前提条件を完了する
始める前に、次の前提条件を完了してください。
重要
依存関係リスト内の各製品の互換性情報については、製品のインストール ドキュメントを参照してください。
依存関係をインストールします。
Homebrew を使用する場合は、ターミナルで次のコマンドを実行できます。
brew install mongodb-atlas-cli その他のオペレーティング システムへのインストール手順については、「 Atlas CLI のインストールまたは更新 」を参照してください。
Docker では、MongoDB イメージをプルしてキャッシュするためにネットワーク接続が必要です。
MacOS またはWindowsの場合は、 Docker Desktop v4.31+ をインストールします。
Linuxの場合は、Docker Engine v27.0+ をインストールします。
Linux RHEL の場合は、Pedman v5.0+. を使用することもできます。
(Optional) Install mongosh version 2.0 or later.
brew install mongosh その他のオペレーティング システムへのインストール手順については、 mongosh のインストール を参照してください。
(Optional) Install Compass version 1.39.4 or later.
brew install mongodb-compass For installation instructions on other operating systems, see Download and Install Compass.
（任意）Visual Studio Code とMongoDB for VS Code拡張機能をインストールします。
詳しくは、 MongoDB for VS Codeのインストール を参照してください。
Atlas アカウントを作成します。
If you don't already have an existing Atlas account, run atlas setup in your terminal or create a new account.
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ファイルを含むディレクトリに置き換えます。コマンドを実行します。
ローカル 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ファイルを含むディレクトリに置き換えます。コマンドを実行します。
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 setup と --loadSampleData true オプションを併用して、配置設定中にサンプルデータを読み込むこともできます。上記の 設定例 を参照してください。
サンプルデータを既存の配置にロードするには、以下を行います。
サンプル データをダウンロードするには、次のコマンドを実行します。
curl https://atlas-education.s3.amazonaws.com/sampledata.archive -o sampledata.archive 次のコマンドを実行し、配置を選択して、配置のポート番号を取得します。
atlas local connect --connectWith connectionString 接続文字列にはポート番号が含まれます。例、接続文字列
mongodb://localhost:27017/?directConnection=trueでは、ポート番号は27017です。配置のポート番号を取得します。
次のコマンドをコピーします。
atlas local connect <deployment name> --connectWith connectionString <deployment name>を配置名に置き換えます。コマンドを実行します。
接続文字列にはポート番号が含まれます。例、接続文字列
mongodb://localhost:27017/?directConnection=trueでは、ポート番号は27017です。
次のコマンドをコピーしてターミナルに貼り付け、
{port-number}を配置用のポートに置き換えます。mongorestore --archive=sampledata.archive --port={port-number}
配置に接続します。
配置に接続するには、次のコマンドを実行します。
atlas local connect 接続する配置を指定し、
Enterを押します。
Atlas 配置を削除する
次のコマンドを実行して、配置を削除します。
atlas local delete 削除する配置を指定し、
Enterを押します。を指定し、
yEnterを押します。をクリックして確認します。
Atlas のローカル配置のクラウド Atlas 配置への移行
DockerとMongoDB Database Toolsを使用して、ローカル Atlas 配置をクラウドAtlas 配置に移動できます。
Atlas のローカル配置の更新
DockerとMongoDB Database Toolsを使用して、ローカル Atlas 配置を新しいバージョンの イメージに更新できます。
Atlas のローカル配置でMongoDB Search を使用する
Use the atlas local search indexes create command to create an MongoDB Search search index. You can then run MongoDB Search queries. To learn more, see MongoDB Search.
詳細な手順については、 「 MongoDB Search インデックスの作成 」と「 クエリの実行 」を参照してください。
Atlas のローカル配置でMongoDB ベクトル検索 を使用する
Use the atlas local search indexes create command to work with MongoDB Vector Search. To learn more, see How to Index Vector Embeddings for Vector Search.
詳細な手順については、Atlas 配置でMongoDB ベクトル検索 を使用する を参照してください。
重要
MongoDB ベクトル検索で Atlas CLI を使用するには、 MongoDB 7.0.5 以降で Atlas 配置を作成する必要があります。以前のMongoDBバージョンでローカル Atlas 配置を作成した場合、自動的に最新のMongoDBバージョンは取得されません。以前のイメージと配置を削除する必要があります。その後、新しい Atlas 配置を作成する必要があります。
サポートされているアクション
atlas local がサポートするすべてのアクションについては、 atlas-local を参照してください。
エラーのトラブルシューティング
Atlas のローカル配置の問題のトラブルシューティングの詳細については、「 Atlas のローカル配置の問題のトラブルシューティング 」を参照してください。