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.0Community Edition は、64 ビット Intel(x86_64、Hashed 以降)および Apple Silicon( arm64)システム上の macOS 14 以降をサポートしています。
詳しくは、「プラットフォーム サポート」を参照してください。
プロダクション ノート
MongoDB を本番環境に導入する前に、パフォーマンスに関する考慮事項と構成の推奨事項について、自己管理型配置のプロダクションドキュメントを参照してください。
MongoDB Community Edition のインストール
前提条件
システムが次の各前提条件を満たしていることを確認してください。 各前提条件ステップは、システム上で 1 回だけ実行する必要があります。 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 8.0のインストール MongoDB 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@8.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 のアクセスを許可してください。
システム設定を開きます
サイドバーの[プライバシーとセキュリティ]をクリックします。
[セキュリティ] セクションで、Open 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 データベースツール は 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
.tgzarchive.Retap the formula.
brew untap mongodb/brew && brew tap mongodb/brew インストールを再度行ってください。
brew install mongodb-community@8.0