Atlas のローカル配置の作成
項目一覧
このチュートリアルでは、 atlas deploymentsコマンドを使用してローカル Atlas 配置を作成する方法を説明します。 このチュートリアルでは、ローカル コンピューターに単一ノードのレプリカ セットを配置します。 その後に配置を管理し、Atlas Search と Atlas Vector Search を使用できるようになります。
ローカル配置は、テストと開発専用です。
重要
パブリック プレビュー
atlas deploymentsコマンドと後続の関連コマンドはパブリック プレビューとして利用できます。 機能および関連するドキュメントは、パブリック プレビュー ステージでいつでも変更される可能性があります。 質問をしたり、フィードバックを提供したりするには、 Atlas CLI ローカル開発コミュニティ フォーラム を参照してください。
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 |
注意
Windows および Ubuntu は、パブリック プレビュー ステージでは、ローカル Atlas の配置では完全にはサポートされていません。
前提条件を完了する
始める前に、次の前提条件を完了してください。
重要
各前提条件製品の互換性情報については、関連するインストール ページを参照してください。
例（MacOS）:
brew install mongodb-atlas-cli 他のオペレーティング システムの Atlas CLI をインストールする手順については、「 Atlas CLIのインストールまたは更新 」を参照してください。
mongoshバージョン2.0以降をインストールします。
例（MacOS）:
brew install mongosh 他のオペレーティング システムの
mongoshインストール手順については、「 mongosh のインストール 」を参照してください。（任意） Compassバージョン1.39.4以降をインストールします。
例（MacOS）:
brew install mongodb-compass 他のオペレーティング システムの Compass をインストールする手順については、「 Compass のダウンロードとインストール 」を参照してください。
MongoDB Database Tools をインストールします。
例（MacOS）:
brew tap mongodb/brew && brew install mongodb-database-tools 他のオペレーティング システムの MongoDB Database Tools をインストールする手順については、「 Database Tools のインストール 」を参照してください。
MacOS または Windows の場合は、 Docker Desktop v4.31 + をインストールします。
Linux の場合は、 Docker Engine v27.0 + をインストールします。
注意
Docker では、MongoDB イメージをプルしてキャッシュするためにネットワーク接続が必要です。
ポドマン は Linux RHEL バージョンでもサポートされています。
Atlas のローカル配置の作成
Atlas のローカル配置を作成するには、 atlas deploymentsコマンドを使用します。
このコマンドは、次の方法で実行できます。
インタラクティブ モード（デフォルト） : コマンドは配置設定を要求し、デフォルト値を提供します。
インタラクティブ モード（カスタム） : コマンドは配置設定を要求し、カスタム値を指定できるようにします。
非対話型モード: 指定されたオプションを指定して コマンドを実行します。 The command does not prompt you to provide further values.
atlas deploymentsがサポートするすべてのアクションについては、 Atlas 配置を参照してください。
次のいずれかのタブをクリックすると、ご希望モードのコマンドが表示されます。
ローカル 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 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 のローカル配置の管理
Atlas のローカル配置を管理するには、 atlas deploymentsコマンドを使用します。 Atlas のローカル配置とクラウド配置の両方で次のコマンドを使用できます。 --type localまたは--type atlasを使用して、それぞれローカルまたはクラウドの Atlas 配置に対して コマンドを実行できます。
ローカル Atlas 配置で Atlas Search を使用する
Atlas Search 検索インデックスを作成するには、 atlas deployments search indexes createコマンドを使用します。 その後、Atlas Search クエリを実行できるようになります。 詳しくは、「 Atlas Search 」を参照してください。
このコマンドは、ローカルおよびクラウドの Atlas 配置で実行できます。 詳細な手順については、「 Atlas Search インデックスの作成 」と「 クエリの実行 」を参照してください。
Atlas Vector Search をローカル Atlas 配置で使用する
Atlas Vector Search を操作するには、 atlas deployments search indexes createコマンドを使用します。 詳細については、 「ベクトル検索のためのベクトル埋め込みのインデックス作成方法」 を参照してください。
このコマンドは、ローカルおよびクラウドの Atlas 配置で実行できます。 詳細な手順については、「 Atlas 配置で Atlas Vector Search を使用する 」を参照してください。
重要
Atlas Vector Search で Atlas CLI を使用するには、MongoDB 7.0.5以降で Atlas 配置を作成する必要があります。 以前の MongoDB バージョンでローカル Atlas 配置を作成した場合、自動的に最新の MongoDB バージョンは取得されません。 以前のイメージと配置を削除する必要があります。 その後、新しい Atlas 配置を作成する必要があります。
サポートされているアクション
atlas deploymentsがサポートするすべてのアクションについては、 Atlas 配置を参照してください。
エラーのトラブルシューティング
Atlas のローカル配置の問題のトラブルシューティングの詳細については、「 Atlas のローカル配置の問題のトラブルシューティング 」を参照してください。