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

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

__restREST展開ディレクティブは、 エンドポイントから構成ファイル値をロードします。__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展開ディレクティブは、 シェルまたはターミナルコマンドから構成ファイル値をロードします。__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 https://にはホストマシンとリモートサーバーの両方が TLS をサポートする暗号化された（ ） URL1 1が必要です。 以降のバージョン RESTURLで指定された エンドポイントに認証が必要な場合は、標準の RFC3986 ユーザー情報形式を使用してURLに認証情報をエンコードします。 ローカルホストREST エンドポイント（ホストREST マシンでリッスンする エンドポイントなど）の場合、__rest は暗号化されていない（http:// ）URL を許可します。 重要: 指定されたREST エンドポイントによって返される値には、追加の展開ディレクティブを含めることはできません。 は返されたデータに対して追加の処理を実行せず、返されたデータに追加の展開ディレクティブが含まれている場合はエラーmongod コードで終了します。
type	string	__rest任意: が指定されたURLから返された値を解析する方法を制御します。 可能な値は次のとおりです。 string （デフォルト） __rest に、返されたデータをリテラル string として解析するよう指示します。string を指定する場合は、外部ソースの値を読み込むフィールドの下に、__rest ブロック全体とサポートオプションをネストする必要があります。 yaml 返されたデータを yaml 形式のファイルとして解析するように __rest に指示します。 yaml を指定する場合、__rest ブロックは構成ファイル内の 唯一 のコンテンツである必要があります。 mongod は、構成ファイルの内容を RESTリソースから取得された yaml に置き換えます。
trim	string	任意 を指定すると、 whitespace__restは先頭または末尾の空白、具体的には 、 、" ""\r" 、"\n" 、"\t""\v" 、"\f" の発生を削除します。デフォルトはnone 、または削除なし。
ダイジェスト	string	任意.展開結果の HMAC-SHA256 出力は、HMAC-SHA256(digest_key, message) として計算されます。ここで message は検索する構成設定の値です。 指定する場合は、次のものも指定する必要があります。digest_key。
Digest_key	string	任意。展開結果の64 32HMAC-SHA ダイジェストを計算するために使用される バイトキーの 文字の256 1616進数文字列表現。 指定されている場合は、ダイジェスト も指定する必要があります。 例えば、certificateKeyFilePassword が "superSecret123" であると仮定します。REST リクエストまたは exec サービス呼び出しを使用してこのパスワードを検索するには、ダイジェスト キーを生成し、それを使用してパスワードのダイジェストを計算する必要があります。 ターミナルで次のコードを実行します。これにより、32 バイトのダイジェストキーが生成されます。 openssl rand -hex 32 出力を表示 ダイジェスト キーを生成した後、これを使用してパスワードのダイジェストを計算できます。 echo -ne "superSecret123" | openssl dgst -sha256 -mac hmac -macopt hexkey:f38d0d5adfcf1a0575f9fa9051c70a2f88b1bb7562513c9efd7686e9c21ad304 出力を表示

注意

• 構成ファイルに__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 （デフォルト） __exec に、返されたデータをリテラル string として解析するよう指示します。string を指定する場合は、外部ソースの値を読み込むフィールドの下に、__exec ブロック全体とサポートオプションをネストする必要があります。 yaml __exec返されたデータをyaml 形式のファイルとして解析するように に指示します。yaml を指定する場合、__exec ブロックは構成ファイル内の 唯一mongod のコンテンツである必要があります。 は、構成ファイルの内容を、実行されたyaml コマンドから検索された に置き換えます。
trim	string	任意 を指定すると、 whitespace__execは先頭または末尾の空白、具体的には 、 、" ""\r" 、"\n" 、"\t""\v" 、"\f" の発生を削除します。デフォルトはnone 、または削除なし。
ダイジェスト	string	任意.展開結果の HMAC-SHA256 出力は、HMAC-SHA256(digest_key, message) として計算されます。ここで message は検索する構成設定の値です。 指定されている場合は、digest_keyも指定する必要があります。
Digest_key	string	任意。展開結果の64 32HMAC-SHA ダイジェストを計算するために使用される バイトキーの 文字の256 1616進数文字列表現。 指定されている場合は、ダイジェスト も指定する必要があります。 例えば、certificateKeyFilePassword が "superSecret123" であると仮定します。REST リクエストまたは exec サービス呼び出しを使用してこのパスワードを検索するには、ダイジェスト キーを生成し、それを使用してパスワードのダイジェストを計算する必要があります。 ターミナルで次のコードを実行します。これにより、32 バイトのダイジェストキーが生成されます。 openssl rand -hex 32 出力を表示 ダイジェスト キーを生成した後、これを使用してパスワードのダイジェストを計算できます。 echo -ne "superSecret123" | openssl dgst -sha256 -mac hmac -macopt hexkey:f38d0d5adfcf1a0575f9fa9051c70a2f88b1bb7562513c9efd7686e9c21ad304 出力を表示

注意

• 構成ファイルに__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