Atlas のローカル配置の作成
項目一覧
このチュートリアルでは、 atlas deploymentsコマンドを使用してローカル Atlas 配置を作成する方法を説明します。 このチュートリアルでは、ローカル コンピューターに単一ノードのレプリカ セットを配置します。 その後に配置を管理し、Atlas Search と Atlas Vector Search を使用できるようになります。
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 + を使用することもできます。
（オプション） mongoshバージョン 2.0以降をインストールします。
brew install mongosh その他のオペレーティング システムへのインストール手順については、「 mongoshのインストール 」を参照してください。
（任意） Compassバージョン1.39.4以降をインストールします。
brew install mongodb-compass その他のオペレーティング システムでのインストール手順については、「 Compass のダウンロードとインストール 」を参照してください。
Atlas アカウントを作成します。
Atlasatlas setup アカウントがまだない場合は、ターミナルで を実行するか、新しいアカウントを作成してください。
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 のローカル配置の問題のトラブルシューティング 」を参照してください。