自己管理型MongoDBの外部設定値

__rest展開ディレクティブを使用する

__rest展開ディレクティブは、 RESTエンドポイントから構成ファイル値をロードします。 __restは、構成ファイル内の特定の値の読み込みまたは構成ファイル全体の読み込みをサポートしています。

storage:
  dbPath: "/var/lib/mongo"
systemLog:
  destination: file
  path: "/var/log/mongodb/mongod.log"
net:
  bindIp: 192.51.100.24,127.0.0.1
  tls:
    mode: requireTLS
    certificateKeyFile: "/etc/tls/mongod.pem"
    certificateKeyFilePassword:
      __rest: "https://myrestserver.example.net/api/config/myCertKeyFilePassword"
      type: "string"

__rest: "https://myrestserver.example.net/api/config/fullConfig"
type: "yaml"

__exec展開ディレクティブを使用する

__exec展開ディレクティブは、shell またはターミナルコマンドから構成ファイル値をロードします。 __execは、構成ファイル内の特定の値の読み込みまたは構成ファイル全体の読み込みをサポートしています。

storage:
  dbPath: "/var/lib/mongo"
systemLog:
  destination: file
  path: "/var/log/mongodb/mongod.log"
net:
  bindIp: 192.51.100.24,127.0.0.1
  tls:
    mode: requireTLS
    certificateKeyFile: "/etc/tls/mongod.pem"
    certificateKeyFilePassword:
      __exec: "python /home/myUserName/getPEMPassword.py"
      type: "string"

__exec: "python /home/myUserName/getFullConfig.py"
type: "yaml"

展開ディレクティブに関する参考資料

__rest

展開ディレクティブは、 __restエンドポイントから構成ファイル値をロードします。REST __restmongodは、構成ファイル内の特定の値の読み込みまたは構成ファイル全体の読み込み をサポートしています。次に、 は、構成の一部として外部ソースの値の使用を開始します。

__rest展開ディレクティブの構文は次のとおりです。

• 特定の構成ファイル設定に対してRESTエンドポイントを指定するには、次のようにします。

  <some configuration file setting>:
    __rest: "<string>"
    type: "string"
    trim: "none|whitespace"
    digest: "<string>"
    digest_key: "<string>"

• 構成ファイル全体にRESTエンドポイントを指定するには

  __rest: "<string>"
  type: "yaml"
  trim: "none|whitespace"

  RESTエンドポイント経由で構成ファイル全体を指定する場合、展開ディレクティブとそのオプションは構成ファイルで指定される値のみである必要があります。

__rest は、次のフィールドがあります。

フィールド	タイプ	説明
__rest	string	mongodGET必須。 が外部ソースの値を取得するために リクエストを発行するURL 。 非ローカルホストRESTエンドポイント（たとえば、リモート サーバーでホストされているRESTエンドポイント）の場合、 __restにはホストマシンとリモート サーバーの両方が TLS 1.1以降をサポートしている暗号化された（ https:// ） URL が必要です。 RESTURLで指定された エンドポイントに認証が必要な場合は、標準の RFC3986 ユーザー情報形式を使用してURLに認証情報をエンコードします。 ローカルホストRESTエンドポイント（ホスト マシンでリッスンするRESTエンドポイントなど）の場合、 __restは暗号化されていない（ http:// ）URL を許可します。 重要: 指定されたREST エンドポイントによって返される値には、追加の展開ディレクティブを含めることはできません。 は返されたデータに対して追加の処理を実行せず、返されたデータに追加の展開ディレクティブが含まれている場合はエラーmongod コードで終了します。
type	string	任意__restが指定された URL から返された値を解析する方法を制御します。 可能な値は次のとおりです。 string （デフォルト） 返されたデータをリテラル string として解析するように__restに指示します。 stringを指定する場合、 __restブロック全体とサポート オプションは、外部ソース値をロードするフィールドの下にネストする必要があります。 yaml 返されたデータを yaml 形式のファイルとして解析するように __rest に指示します。 yaml を指定する場合、__rest ブロックは構成ファイル内の 唯一 のコンテンツである必要があります。 mongod は、構成ファイルの内容を RESTリソースから取得された yaml に置き換えます。
trim	string	任意whitespaceを指定すると、 __restは先頭または末尾の空白、具体的には" " 、 "\r" 、 "\n" 、 "\t" 、 "\v" 、 "\f"の発生を削除します。 デフォルトはnone 、または削除なし。
ダイジェスト	string	任意。 展開結果の SHA- 256ダイジェスト。 指定する場合は、 Digest_key も指定する必要があります。
Digest_key	string	任意。 stringSHA-256 ダイジェスト を計算するために使用されるシークレットの 16進数 表現。 指定する場合は、ダイジェストも指定する必要があります。

注意

• 構成ファイルに__rest展開が含まれている場合、Linux/macOS では、構成ファイルへの読み取りアクセスは、 mongod / mongosプロセスを実行しているユーザーのみに制限する必要があります。

• __rest展開ディレクティブの解析を有効にするには、 オプションを使用してmongod --configExpand "rest"を起動します。

例については、「 __rest展開ディレクティブの使用 」を参照してください。

__exec

展開ディレクティブは、__exec シェルまたはターミナルコマンドの出力から構成ファイル値をロードします。__exec は、構成ファイル内の特定の値の読み込みまたは構成ファイル全体の読み込み をサポートしています。次に、mongod は構成の一部として外部ソースの値の使用を開始します。

__exec展開ディレクティブの構文は次のとおりです。

• 特定の構成ファイル設定に対して shell またはターミナルコマンドを指定するには、次のようにします。

  <some configuration file setting>:
    __exec: "<string>"
    type: "string"
    trim: "none|whitespace"

• 構成ファイル全体に対して shell またはターミナルコマンドを指定するには:

  __exec: "<string>"
  type: "yaml"
  trim: "none|whitespace"

  ターミナルコマンドまたは shell コマンドを使用して構成ファイル全体を指定する場合、展開ディレクティブとそのオプションは、構成ファイルで指定される値のみである必要があります。

__exec は、次のフィールドがあります。

フィールド	タイプ	説明
__exec	string	必須 外部ソースの値を取得するために がターミナルまたはシェルで実行するmongod string 。 Linux および OSX ホストでは、実行は POSIX popen()によって処理されます。 Windows ホストでは、実行は プロセス制御 API 経由で処理されます。 __execは、 mongodまたはmongosを開始したのと同じユーザーとして読み取り専用パイプを開きます。 重要: 指定されたコマンドを実行して返されるデータには、追加の展開ディレクティブを含めることはできません。 は返されたデータに対して追加の処理を実行せず、返されたデータに追加の展開ディレクティブが含まれている場合はエラーmongod コードで終了します。
type	string	任意コマンドの実行時に返される値を__execが解析する方法を制御します。 可能な値は次のとおりです。 string （デフォルト） 返されたデータをリテラル string として解析するように__execに指示します。 stringを指定する場合、 __execブロック全体とサポート オプションは、外部ソース値をロードするフィールドの下にネストする必要があります。 yaml 返されたデータを yaml 形式のファイルとして解析するように __exec に指示します。 yaml を指定する場合、__exec ブロックは構成ファイル内の 唯一 のコンテンツである必要があります。 mongod は構成ファイルの内容を、実行された コマンドから検索された yaml に置き換えます。
trim	string	任意whitespaceを指定すると、 __execは先頭または末尾の空白、具体的には" " 、 "\r" 、 "\n" 、 "\t" 、 "\v" 、 "\f"の発生を削除します。 デフォルトはnone 、または削除なし。
ダイジェスト	string	任意。 展開結果の SHA- 256ダイジェスト。 指定する場合は、 Digest_keyも指定する必要があります
Digest_key	string	任意。 stringSHA-256 ダイジェスト を計算するために使用されるシークレットの 16進数 表現。 指定する場合は、ダイジェストも指定する必要があります

注意

• 構成ファイルに__exec展開が含まれている場合、Linux/macOS では、構成ファイルへの書込み (write) アクセスは、 mongod / mongosプロセスを実行しているユーザーのみに制限する必要があります。

• __exec展開ディレクティブの解析を有効にするには、 オプションを使用してmongod --configExpand "exec"を起動します。

例については、「 __exec展開ディレクティブの使用 」を参照してください。

解決された展開ディレクティブ値を含む構成ファイルを出力する

1 つ以上の展開ディレクティブを指定する構成ファイルの最終出力をテストするには、mongod --outputConfigmongod--outputConfigstdoutを オプションとともに起動します。 で開始された は解決されたmongod YAML 構成ドキュメントを に出力して停止します。構成ファイルで指定された展開ディレクティブのいずれかが追加の展開ディレクティブを返す場合、 はエラーをスローして終了します。

たとえば、次の構成ファイルmongod.confには__rest展開ディレクティブが含まれています。

storage:
  dbPath: "/var/lib/mongo"
systemLog:
  destination: file
  path: "/var/log/mongodb/mongod.log"
net:
  port:
    __rest: "https://mongoconf.example.net:8080/record/1"
    type: string

指定された URL で記録された string は、 20128

構成ファイルに__rest展開が含まれている場合、Linux/macOS では、構成ファイルへの読み取りアクセスは、 mongod / mongosプロセスを実行しているユーザーのみに制限する必要があります。

}mongod --configExpand "rest"オプションと--outputConfig オプションを使用して を起動します。

mongod -f mongod.conf --configExpand rest --outputConfig

mongodは終了前に以下をstdoutに出力します。

config: mongod.conf
storage:
  dbPath: "/var/lib/mongo"
systemLog:
  destination: file
  path: "/var/log/mongodb/mongod.log"
net:
  port: 20128
outputConfig: true