Overview
このチュートリアルでは、 MongoDB9.0 Enterprise Edition を、サードパーティの Homebrewパッケージマネージャーを使用して macOS にインストールします。
Homebrew 経由でMongoDBをインストールすると 、 MongoDB Database Toolsもインストールされます。詳細については、「 MongoDB Database Tools の使用 」を参照してください。
Considerations
プラットフォーム サポート
MongoDB 9.0Enterprise Edition は macOS 14 以降をサポートしており、Hasshell 以降の CPU アーキテクチャが必要です。
詳しくは、「プラットフォーム サポート」を参照してください。
プロダクション ノート
MongoDB を本番環境に導入する前に、パフォーマンスに関する考慮事項と構成の推奨事項について、自己管理型配置のプロダクションドキュメントを参照してください。
始める前に
システムが以下の前提条件をすべて満たしていることを確認してください。前提条件となる各手順は、システムに一度だけ実行します。Homebrew を使用して、以前の MongoDB をインストールした手順の一部として、この前提条件をすでに実行している場合は、インストール手順に進むことができます。
Xcode コマンドライン ツールのインストール
Homebrew には、Apple Xcode の Xcode コマンドライン ツールが必要です。
Xcode コマンドライン ツールをインストールするには、次のコマンドを実行します。
xcode-select --install
Homebrew をインストール
macOS does not include the Homebrew brew package by default.
Homebrew をインストールするには、 公式の Homebrew インストール手順 を使用します。
MongoDB Enterprise Editionをインストールする
Homebrew を使用してMongoDB Enterpriseエディションをインストールするには、次の手順を実行します。
MongoDB Homebrew タブを追加します。
MongoDB Homebrew を選択すると、公式のMongoDBおよびDatabase Tools のHomebrew フォーミュラ がシステムで使用できるようになります。
MongoDB Homebrew タブを追加するには、次のコマンドを実行します。
brew tap mongodb/brew
次に、そのタブを信頼できるものとしてマークします。
brew trust mongodb/brew
MongoDB の以前のインストールですでにこれを実行している場合は、この手順を省略できます。
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 --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-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 を接続します。新しいターミナルから、次のコマンドを実行します。
mongosh
CRUD(作成、読み取り、更新、削除)操作の詳細については、以下を参照してください。
詳細情報
デフォルトの Localhost バインディング
デフォルトでは、MongoDB は bindIp を 127.0.0.1 に設定して起動します。これは、ローカルホスト ネットワーク インターフェースにバインドされます。つまり、mongod は同じマシン上で実行中のクライアントからの接続のみを受け入れることができます。この値が有効なネットワークインターフェースに設定されていない限り、リモートクライアントは mongod に接続できず、mongod はレプリカセットを初期化できません。
この値は、次のいずれかに設定できます。
警告
インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。
bindIpの構成の詳細については、「自己管理型配置の IP バインディング 」を参照してください。
含まれたバイナリ
インストールには、次のバイナリが含まれています。
ファイルパス
さらに、お使いの Apple ハードウェアに応じて、インストールにより、以下の指定された場所に次のファイルとディレクトリが作成されます。
Intel プロセッサ | Apple Silicon Processor | |
|---|---|---|
|
| |
|
| |
|
|
Apple Silicon プロセッサを使用する Apple ハードウェアの最新リストについては、Apple のドキュメント を参照してください。また、次のコマンドを実行して、brew で上記のファイルとディレクトリがインストールされた場所を確認することもできます。
brew --prefix