注意
MongoDB Atlas
MongoDB Atlas は、インストールのオーバーヘッドが不要で、無料で始められるクラスターを提供する、クラウドでホストされる MongoDBサービスオプションです。
Overview
このチュートリアルでは、MongoDB 7.0Enterprise Edition を、サードパーティの Homebrew パッケージ マネージャーを使用して macOS にインストールします。
Homebrew 経由で MongoDB をインストールすると、MongoDB Database Tools もインストールされます。詳細については、「Using the MongoDB Database Tools」を参照してください。
Considerations
プラットフォーム サポート
MongoDB 7.0Enterprise Edition は macOS 15 以降をサポートしており、Hasshell 以降の CPU アーキテクチャが必要です。
詳しくは、「プラットフォーム サポート」を参照してください。
プロダクション ノート
MongoDB を本番環境に導入する前に、パフォーマンスに関する考慮事項と構成の推奨事項について、自己管理型配置のプロダクションドキュメントを参照してください。
始める前に
システムが以下の前提条件をすべて満たしていることを確認してください。前提条件となる各手順は、システムに一度だけ実行します。Homebrew を使用して、以前の MongoDB をインストールした手順の一部として、この前提条件をすでに実行している場合は、インストール手順に進むことができます。
Xcodeコマンドラインツールをインストールする
Homebrew には、Apple Xcode の Xcode コマンドライン ツールが必要です。
Xcode コマンドライン ツールをインストールするには、次のコマンドを実行します。
xcode-select --installHomebrew をインストール
macOS does not include the Homebrew brew package by default.
Homebrew をインストールするには、公式の Homebrew インストール手順を使用してください。
MongoDB Enterprise Editionをインストールする
Homebrew を使用して MongoDB Enterprise をインストールするには、以下のステップを実行してください。
MongoDBのHomebrewタップを追加します。
MongoDB Homebrew tapを使用すると、公式のMongoDBおよびDatabase Tools Homebrewフォーミュラをシステムで利用できるようになります。
MongoDB Homebrew tapを追加するには、次のコマンドを実行します。
brew tap mongodb/brew次に、tapを信頼済みとしてマークします。
brew trust mongodb/brewMongoDB の以前のインストールですでにこれを実行している場合は、この手順を省略できます。
Tip
あるいは、必要に応じて、MongoDB の前のバージョンを指定することもできます。この方法では、複数のバージョンの MongoDB を並行して管理できます。
Tip
以前に古いバージョンのフォーミュラをインストールしたことがある場合は、ChecksumMismatchError が発生する場合があります。解決するには「ChecksumMismatchError のトラブルシューティング」を参照してください。
MongoDB Enterprise Edition を実行する
MongoDB Enterprise Edition を実行するには、次の手順に従います。 これらの手順では、デフォルト設定の使用を前提としています。
brew を使用して macOS サービスとして MongoDB を実行することも、バックグラウンド プロセスとして MongoDB を手動で実行することもできます。
注意
Homebrew インストール方法を使用して MongoDB をインストールした macOS システムの場合、brew services を介して MongoDB を起動すると、オープン ファイルの制限が自動的に設定されないことがあります。ulimit の値を手動で構成する必要がある場合があります。
詳細については、Ulimit 設定を参照してください。
mongod構成ファイルを使用して、 を バックグラウンド プロセスとして手動で実行するには配置で TLS 接続 を使用しない場合は、
--forkオプションを使用します。Intel プロセッサ で実行中中の macOS の場合は、次を実行します。
mongod --config /usr/local/etc/mongod.conf --forkApple Silicon プロセッサ で実行中のmacOS の場合は、次を実行します。
mongod --config /opt/homebrew/etc/mongod.conf --fork
配置で TLS 接続 を使用する場合は、 GNU 画面 を使用します。
Apple Silicon プロセッサ で実行中の macOS の場合:
どちらの方法でも、インストール中に作成された mongod.conf ファイルが使用されます。このファイルに独自の MongoDB 構成オプションを追加することもできます。
注意
macOS が mongod の起動を防ぐ
macOS はインストール後に mongod の実行を妨げられる可能性があります。mongod を起動時に、開発者を識別または認証できなかったことを示すセキュリティ エラーが発生した場合は、次の操作を行って mongod のアクセスを許可してください。
システム環境設定を開く
[セキュリティとプライバシー] を選択します。
[一般] タブで、お使いの macOS のバージョンに応じて Open Anyway、または Allow Anyway と表示された、
mongodに関するいずれかのメッセージの右側のボタンをクリックします。
To verify that MongoDB is running, perform one of the following:
MongoDB をmacOS サービスとして起動した場合、
brew services listmongodb-enterpriseサービスがstartedと表示されます。MongoDB をバックグラウンド プロセスとして手動で起動した場合、
ps aux | grep -v grep | grep mongod出力に
mongodプロセスが表示されます。
ログファイルを表示して、mongod プロセスの現在のステータスを /usr/local/var/log/mongodb/mongo.log として確認することもできます。
Connect and Use MongoDB
MongoDB の使用を開始するには、実行中のインスタンスに mongosh を接続します。新しいターミナルから、次のコマンドを実行します。
mongoshCRUD(作成、読み取り、更新、削除)操作の詳細については、以下を参照してください。
詳細情報
デフォルトの Localhost バインディング
By default, MongoDB launches with bindIp set to 127.0.0.1, which binds to the localhost network interface. This means that the mongod can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod, and the mongod will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.
この値は、次のいずれかに設定できます。
警告
インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。
bindIpの構成の詳細については、「自己管理型配置の IP バインディング 」を参照してください。
含まれるバイナリ
インストールには、次のバイナリが含まれています。
注意
インストールには、MongoDB Database Tools も含まれています。詳細については、「Using the MongoDB Database Tools」を参照してください。
ファイルパス
さらに、お使いの Apple ハードウェアに応じて、インストールにより、以下の指定された場所に次のファイルとディレクトリが作成されます。
Intel プロセッサ | Apple Silicon Processor | |
|---|---|---|
|
| |
|
| |
|
|
Apple Silicon プロセッサを使用する Apple ハードウェアの最新リストについては、Apple のドキュメント を参照してください。また、次のコマンドを実行して、brew で上記のファイルとディレクトリがインストールされた場所を確認することもできます。
brew --prefix