重要
Atlas CLI バージョン 1.52.0 以降、atlas deployments コマンドは非推奨です。ローカル配置には atlas local コマンドを使用し、クラウド配置には atlas clusters コマンドを使用します。このガイドを新しいコマンドを使用するように更新しました。
このガイドでは、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
注意
Replace the following placeholder values to create a new database user with atlasAdmin privileges in your deployment:
<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
コマンドは、配置内のデータベースの一覧を返します。
Congratulations! You have successfully set up your MongoDB Atlas deployment and connected to it. To learn more about how to interact with your deployment by using the MongoDB Shell, see the MongoDB Shell documentation.
次のセクションでは、配置に接続し、データを操作するアプリケーションを作成する方法を学習します。
最初のMongoDBアプリケーションを作成する
To connect to your MongoDB Atlas deployment in an application, you can use one of the official MongoDB client libraries.
次のドロップダウン メニューからご希望のプログラミング言語を選択し、その言語でMongoDB Atlas配置に接続する方法 を確認できます。
Tip
このセクションの手順を実行する前に、exit コマンドを実行して MongoDB Shell を終了していることを確認してください。