重要
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
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 を終了していることを確認してください。