Overview
このチュートリアルでは、MongoDB 7.0 Community Edition を、サードパーティの Homebrew パッケージ マネージャーを使用して macOS にインストールします。
MongoDB 4.4.1 以降では、Homebrew 経由で MongoDB をインストールすると 、MongoDB データベースツール もインストールされます。詳細については、「MongoDB データベースツールの使用」を参照してください。
MongoDB バージョン
このチュートリアルでは、MongoDB 7.0 Community Edition をインストールします。別のバージョンの MongoDB Community をインストールするには、このページの左上にあるバージョンのドロップダウンメニューを使用して、該当バージョンのドキュメントを選択します。
Considerations
プラットフォーム サポート
MongoDB 7.0Community Edition は macOS 14 以降をサポートしており、Hasshell 以降の CPU アーキテクチャが必要です。
詳しくは、「プラットフォーム サポート」を参照してください。
プロダクション ノート
MongoDB を本番環境に導入する前に、パフォーマンスに関する考慮事項と構成の推奨事項について、自己管理型配置のプロダクションドキュメントを参照してください。
MongoDB Community Edition のインストール
前提条件
システムが以下の前提条件をすべて満たしていることを確認してください。前提条件となる各手順は、システムに一度だけ実行します。Homebrew を使用して、以前の MongoDB をインストールした手順の一部として、この前提条件をすでに実行している場合は、インストール手順に進むことができます。
Install Xcode Command-Line Tools
Homebrew には、Apple Xcode の Xcode コマンドライン ツールが必要です。
macOS ターミナルで次のコマンドを実行して、Xcode コマンドライン ツールをインストールします。
xcode-select --install
Homebrew をインストール
macOS does not include the Homebrew brew package by default.
- 公式の Homebrew インストール手順 を使用して
brewをインストールします。
MongoDB 7.0 Community Edition をインストール
Homebrew の brew パッケージ マネージャーを使用して MongoDB Community Edition をインストールするには、次の手順に従います。手順に進む前に、上記のインストールの前提条件に従っていることを確認してください。
[MongoDB Homebrew Tap] をタップして、MongoDB と Database Tools の公式 Homebrew フォーミュラをダウンロードし、macOS ターミナルで次のコマンドを実行してください。
brew tap mongodb/brew 次に、タップを信頼できるソースとしてマークします。
brew trust mongodb/brew MongoDB の以前のインストールですでにこれを実行している場合は、この手順を省略できます。
To update Homebrew and all existing formulae:
brew update MongoDB をインストールするには、macOS のターミナルアプリケーションで以下のコマンドを実行します。
brew install mongodb-community@7.0
Tip
あるいは、必要に応じて、MongoDB の前のバージョンを指定することもできます。この方法では、複数のバージョンの MongoDB を並行して管理できます。
Tip
以前に古いバージョンのフォーミュラをインストールしたことがある場合は、ChecksumMismatchError が発生する場合があります。解決するには「ChecksumMismatchError のトラブルシューティング」を参照してください。
インストールには、次のバイナリが含まれています。
さらに、お使いの Apple ハードウェアに応じて、インストールにより、以下の指定された場所に次のファイルとディレクトリが作成されます。
Intel プロセッサ | Apple Silicon Processor | |
|---|---|---|
|
| |
|
| |
|
|
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).
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 画面 を使用します。
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 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 Database Tools はMongoDBデプロイ を操作するためのコマンドライン ユーティリティのコレクションであり、mongoimport や などのデータのバックアップとインポートまたはエクスポートmongodump ツール、そしてmongotop などの監視ツールが含まれます。
上記の手順でMongoDB Serverをインストールしたら、macOSの ターミナルアプリケーションのコマンドラインから直接Database Toolsを利用できます。例、次のようにmongotop macOS ターミナルで呼び出すことで、実行中のMongoDBインスタンスに対して を実行できます。
mongotop
起動され、実行中の mongod に接続され、使用状況統計のレポート作成が開始されます。
各 Database Tools の使用方法については、「MongoDB データベースツールのドキュメント」を参照してください。
詳細情報
デフォルトの 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 バインディング 」を参照してください。
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
.tgzarchive.Retap the formula.
brew untap mongodb/brew && brew tap mongodb/brew インストールを再度行ってください。
brew install mongodb-community@7.0