MongoDB Community Edition の macOS へのインストール
項目一覧
Overview
このチュートリアルでは、MongoDB 8.0 Community Edition を、サードパーティの Homebrew パッケージ マネージャーを使用して macOS にインストールします。
MongoDB 4.4.1 以降、Homebrew 経由で MongoDB をインストールすると 、MongoDB データベースツール もインストールされます。詳細については、「MongoDB データベースツールの使用」を参照してください。
MongoDB バージョン
このチュートリアルではMongoDB 8.0 Community Edition をインストールします。別のバージョンの MongoDB Community をインストールするには、このページの左上隅にあるバージョンのドロップダウンメニューを使用して、該当バージョンのドキュメントを選択します。
Considerations
プラットフォーム サポート
MongoDB 8.0 Community Edition は macOS 11 以降をサポートしています。
詳しくは、「 プラットフォームのサポート 」を参照してください。
プロダクション ノート
MongoDB を本番環境に導入する前に、本番環境の MongoDB導入に関するパフォーマンス上の考慮事項と構成の推奨事項を示す 自己管理型配置のプロダクション ノート を検討してください。
MongoDB Community Edition のインストール
前提条件
システムが次の各前提条件を満たしていることを確認してください。 各前提条件ステップは、システム上で 1 回だけ実行する必要があります。 Homebrew を使用して以前の MongoDB インストールの一環として必要な手順をすでに実行している場合は、インストール手順に進んでください。
Install Xcode Command-Line Tools
Homebrew には、Apple Xcode の Xcode コマンドライン ツールが必要です。
macOS ターミナルで次のコマンドを実行して、Xcode コマンドライン ツールをインストールします。
xcode-select --install
Homebrew をインストール
macOS には、デフォルトでは Homebrew brew
パッケージは含まれていません。
公式の Homebrew インストール手順 を使用して をインストール 。
brew
MongoDB 8.0のインストール MongoDB Community Edition
Homebrew の brew
パッケージ マネージャーを使用して MongoDB Community Edition をインストールするには、次の手順に従います。手順に進む前に、上記のインストールの前提条件に従っていることを確認してください。
[MongoDB Homebrew Tap] をタップして、MongoDB と Database Tools の公式 Homebrew フォーミュラをダウンロードし、macOS ターミナルで次のコマンドを実行してください。
brew tap mongodb/brew MongoDB の以前のインストールですでにこれを実行している場合は、この手順を省略できます。
To update Homebrew and all existing formulae:
brew update MongoDB をインストールするには、macOS のターミナルアプリケーションで以下のコマンドを実行します。
brew install mongodb-community@8.0
Tip
あるいは、必要に応じて、MongoDB の前のバージョンを指定することもできます。この方法では、複数のバージョンの MongoDB を並行して管理できます。
Tip
以前に古いバージョンのフォーミュラをインストールしたことがある場合は、 ChecksumMismatchError が発生することがあります。 解決するには、 「 ChecksumMismatchError のトラブルシューティング 」を参照してください。
インストールには、次のバイナリが含まれています。
さらに、お使いの Apple ハードウェアに応じて、インストールにより、以下の指定された場所に次のファイルとディレクトリが作成されます。
Intel プロセッサ | Apple Silicon Processor | |
---|---|---|
/usr/local/etc/mongod.conf | /opt/homebrew/etc/mongod.conf | |
/usr/local/var/log/mongodb | /opt/homebrew/var/log/mongodb | |
/usr/local/var/mongodb | /opt/homebrew/var/mongodb |
Apple Silicon プロセッサを使用する Apple ハードウェアの最新リストについては、Apple のドキュメント を参照してください。また、次のコマンドを実行して、brew
で上記のファイルとディレクトリがインストールされた場所を確認することもできます。
brew --prefix
MongoDB 4.4.1 以降、インストールには MongoDB データベースツール も付属しています。詳細については、「MongoDB データベースツールの使用」を参照してください。
MongoDB コミュニティ エディションの実行
MongoDB コミュニティ エディション を実行するには、次の手順で行います。これらの手順は、デフォルト設定を使用していることを前提としています。
You can run MongoDB as a macOS service using brew
, or you can run MongoDB manually as a background process. It is recommended to run MongoDB as a macOS service, as doing so sets the correct system ulimit
values automatically (see ulimit settings for more information).
MongoDB(
mongod
プロセスなど)を macOS サービスとして実行するには、次を実行します。brew services start mongodb-community@8.0 macOS サービスとして実行している
mongod
を停止するには、必要に応じて次のコマンドを使用します。brew services stop mongodb-community@8.0 mongod
構成ファイルを使用して、 を バックグラウンド プロセスとして手動で実行するには配置で TLS 接続 を使用しない場合は、
--fork
オプションを使用します。Intel プロセッサ で実行中中の macOS の場合は、次を実行します。
mongod --config /usr/local/etc/mongod.conf --fork Apple Silicon プロセッサ で実行中中の macOS の場合は、次を実行します。
mongod --config /opt/homebrew/etc/mongod.conf --fork 配置で TLS 接続 を使用する場合は、 GNU 画面 を使用します。
Intel プロセッサ で実行中中の macOS の場合:
コマンドラインで
--dbpath
と--logpath
を指定して、バックグラウンド プロセスとして手動でmongod
を起動するには、次を実行します。mongod --dbpath /path/to/dbdir --logpath /path/to/mongodb.log --fork バックグラウンド プロセスとして実行中の
mongod
を停止するには、mongosh を使用してmongod
を接続し、shutdown
コマンドを必要に応じて出します。
どちらの方法でも、インストール中に作成された mongod.conf
ファイルが使用されます。このファイルに独自の MongoDB 構成オプションを追加することもできます。
注意
macOS が mongod の起動を防ぐ
To verify that MongoDB is running, perform one of the following:
MongoDB をmacOS サービスとして起動した場合、
brew services list mongodb-community
サービスがstarted
と表示されます。MongoDB をバックグラウンド プロセスとして手動で起動した場合、
ps aux | grep -v grep | grep mongod 出力に
mongod
プロセスが表示されます。
ログファイルを表示して、mongod
プロセスの現在のステータスを /usr/local/var/log/mongodb/mongo.log
として確認することもできます。
Connect and Use MongoDB
MongoDB の使用を開始するには、実行中のインスタンスに mongosh
を接続します。新しいターミナルから、次のコマンドを実行します。
mongosh
For information on CRUD (Create,Read,Update,Delete) operations, see:
MongoDB データベースツールの使用
MongoDB 4.4.1 以降では、brew
を介して MongoDB をインストールすると、MongoDB データベースツールもインストールされます。
MongoDB データベースツール は MongoDB 配置を操作するためのコマンドライン ユーティリティのコレクションであり、mongoimport
や mongodump
などのデータのバックアップとインポートまたはエクスポート ツール、そしてmongotop
などの監視ツールが含まれます。
上記の手順で MongoDB Server をインストールしたら、macOSのターミナルアプリケーションのコマンドラインから直接 Database Tools を利用できます。たとえば、次のように macOS ターミナルで呼び出すことで、実行中の MongoDB インスタンスに対して mongotop
を実行できます。
mongotop
起動され、実行中の mongod
に接続され、使用状況統計のレポート作成が開始されます。
各 Database Tools の使用方法については、「MongoDB データベースツールのドキュメント」を参照してください。
詳細情報
デフォルトの Localhost バインディング
デフォルトでは、MongoDB は bindIp
を 127.0.0.1
に設定して起動します。これは、ローカルホスト ネットワーク インターフェースにバインドされます。つまり、mongod
は同じマシン上で実行中のクライアントからの接続のみを受け入れることができます。この値が有効なネットワークインターフェースに設定されていない限り、リモートクライアントは mongod
に接続できず、mongod
はレプリカセットを初期化できません。
この値は、次のいずれかに設定できます。
警告
インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。
bindIp
の構成の詳細については、「自己管理型配置の IP バインディング 」を参照してください。
ChecksumMismatchError のトラブルシューティング
以前に古いバージョンのフォーミュラをインストールしたことがある場合は、次のような ChecksumMismatchError
が表示されることがあります。
Error: An exception occurred within a child process: ChecksumMismatchError: SHA256 mismatch Expected: c7214ee7bda3cf9566e8776a8978706d9827c1b09017e17b66a5a4e0c0731e1f Actual: 6aa2e0c348e8abeec7931dced1f85d4bb161ef209c6af317fe530ea11bbac8f0 Archive: /Users/kay/Library/Caches/Homebrew/downloads/a6696157a9852f392ec6323b4bb697b86312f0c345d390111bd51bb1cbd7e219--mongodb-macos-x86_64-4.2.0.tgz To retry an incomplete download, remove the file above.
修正するには、
Remove the downloaded
.tgz
archive.Retap the formula.
brew untap mongodb/brew && brew tap mongodb/brew インストールを再度行ってください。
brew install mongodb-community@8.0