重要
The atlas deployments commands are deprecated as of Atlas CLI version 1.52.0. Use atlas local commands for local deployments and atlas clusters commands for cloud deployments. We updated this guide to use the new commands.
このガイドでは、MongoDB Atlas配置をローカルまたはクラウドで作成する方法を学びます。次に、配置に接続するアプリケーションを作成する方法を学びます。MongoDB Community または MongoDB Enterprise エディションを自分のインフラストラクチャにインストールする方法については、MongoDBのインストールガイドを参照してください。
MongoDB Atlas配置の作成
このセクションでは、ローカルまたはクラウドのMongoDB Atlas配置を設定し、 MongoDB Shell を使用して配置に接続する方法を説明します。
依存関係のインストール
このチュートリアルを開始する前に、開発環境に次の依存関係をインストールする必要があります。
Atlas CLI: ターミナルから配置を管理できるコマンドラインインターフェイス
MongoDB Shell: 配置に接続し、データベース操作をサポートする対話型ツール
Docker：MongoDBのローカル配置を含む、コンテナ内でソフトウェアを実行することができるプラットフォーム
これらの必要な開発ツールをインストールするコマンドを表示するには、オペレーティング システムに対応するタブを選択します。
Homebrewパッケージマネージャーを使用して次のコマンドを実行し、依存関係をインストールします。Homebrew がない場合は、Homebrew ウェブサイト。の手順に従ってインストールできます。
brew install mongodb-atlas brew install --cask docker
Chocolateyパッケージマネージャーを使用して依存関係をインストールするには、次のコマンドを実行する。ウェブサイトを
choco install mongodb-atlas choco install docker-desktop
Atlas CLI をインストールする他の方法については、Atlas CLI インストール ページ を参照してください。
注意
Dockerデスクトップ
上記のコマンドはDocker Desktopアプリケーションをインストールします。インストールが完了したら、Dockerアカウントの作成とアプリケーションの起動を確認します。
フル機能の配置を設定する
次のコマンドを実行し、shellのプロンプトに従ってクラスターを配置します。Atlas アカウントをお持ちでない場合は、次のコマンドによってアカウントの作成が求められます。
このコマンドは、ローカルマシン上で実行されるコンテナに単一ノードのレプリカセットを作成します。
atlas local setup myDeployment \ --mdbVersion 8.0 --port <port number> --connectWith connectionString
注意
<port number> プレースホルダーを使用するポートに置き換えます。デフォルトのポートは 27017 ですが、27017 が使用できない場合は別のポートを指定できます。
このコマンドは、次の情報を出力します。
Deployment created! Connection string: "<connection string URI>"
後のステップで使用するために接続文字列URI を保存します。
このコマンドは、MongoDB Atlasに無料階層クラスターを作成します。
atlas setup --clusterName myDeployment \ --provider AWS --region us-east-1 --skipSampleData \ --username <database username> --password <database user password> \ --connectWith skip --force
注意
次のプレースホルダー値を置き換えて、配置内に新しいデータベースユーザーatlasAdmin権限を持つ新しいデータベースユーザーを作成します。
<database username>: 新しいデータベースユーザーのユーザー名を指定します<database user password>: 新しいデータベースユーザーのパスワードを指定します
このコマンドは、次の情報を出力します。
Cluster created. Your connection string: "<connection string URI>"
後のステップで使用するために接続文字列URI を保存します。
配置に接続
MongoDB Shell（mongosh）を使用して配置に接続するには、次のコマンドを実行中。
atlas local connect myDeployment --connectWith mongosh
atlas clusters connect myDeployment --username <database username> \ --password <database user password> --connectWith mongosh
注意
<database username> と <database user password> のプレースホルダーを、データベースユーザー用に作成したユーザー名とパスワードに置き換えます。
接続後、次のコマンドを実行して接続をテストできます。
show dbs
コマンドは、配置内のデータベースの一覧を返します。
成功します。MongoDB Atlas配置が正常に設定され、それに接続されました。MongoDB Shell を使用して配置を操作する方法の詳細については、MongoDB Shell のドキュメント を参照してください。
次のセクションでは、配置に接続し、データを操作するアプリケーションを作成する方法を学習します。
最初のMongoDBアプリケーションを作成する
アプリケーション内のMongoDB Atlas配置に接続するには、公式のMongoDBクライアントライブラリのいずれかを使用できます。
次のドロップダウン メニューからご希望のプログラミング言語を選択し、その言語でMongoDB Atlas配置に接続する方法 を確認できます。
Tip
このセクションの手順を実行する前に、exit コマンドを実行して MongoDB Shell を終了していることを確認してください。