Valores de archivos de configuración de origen externo para implementaciones autogestionadas

Utiliza la directiva de expansión __rest

La __rest directiva de expansión carga valores del archivo de configuración desde un REST punto final. __rest admite la carga de valores específicos en el archivo de configuración o la carga del archivo de configuración completo.

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"

Utiliza la directiva de expansión __exec

La __exec directiva de expansión carga valores del archivo de configuración desde un comando de shell o terminal. __exec admite la carga de valores específicos en el archivo de configuración o la carga de todo el archivo de configuración.

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"

Referencia de directivas de expansión

__rest

La __rest directiva de expansión carga valores del archivo de configuración desde un REST punto final. __rest permite cargar valores específicos en el archivo de configuración o cargar el archivo de configuración completo. A continuación,mongod/ empieza a usar los valores externos como parte de sumongos configuración.

La __rest directiva de expansión tiene la siguiente sintaxis:

• Para especificar un punto final REST para una o más configuraciones de un archivo de configuración específico:

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

• Para especificar un punto final REST para todo el archivo de configuración:

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

  Si se especifica el archivo de configuración completo a través del REST punto final, la directiva de expansión y sus opciones deben ser los únicos valores especificados en el archivo de configuración.

__rest toma los siguientes campos:

Campo	Tipo	Descripción
__descansar	string	Obligatorio La URL contra la cual mongod/ emitemongos una GET solicitud para recuperar el valor de origen externo. Para los puntos finales que no son de host REST local (por ejemplo, un REST punto final alojado en un servidor remoto), __rest requierehttps:// URL cifradas () donde tanto la máquina host como el servidor remoto admitan TLS 1.1 o posterior. Si el REST punto final especificado en la URL requiere autenticación, codifique las credenciales en la URL con la información de usuario RFC 3986 estándar formato. Para los puntos REST finales locales REST __rest (por ejemplo, un punto final que escucha en la máquina host), permitehttp:// URL sin cifrar (). IMPORTANTE: El valor devuelto por el REST punto final especificado no puede incluir directivas de expansión adicionales.mongod/mongos no realiza procesamiento adicional en los datos devueltos y finalizará con un código de error si estos incluyen directivas de expansión adicionales.
type	string	Opcional Controla cómo analiza el valor devuelto desde la URL __rest especificada. Los valores posibles son: string ( Pordefecto) Indica a que analice los datos devueltos como una cadena literal. Si __rest se string especifica, todo el __rest bloque y las opciones complementarias deben estar anidados bajo el campo para el que se cargan los valores de origen externo. yaml Indica a que analice los datos devueltos como __rest un yaml archivo con formato. Si se yaml especifica, el bloque debe ser el __rest mongodúnico contenido del archivo de configuración. / reemplazamongos el yaml contenido del archivo de configuración con el obtenido del recurso REST.
trim	string	Opcional: Especifique whitespace para indicar a que recorte cualquier espacio inicial o final, específicamente las __rest ocurrencias " " "\r"de,,,, "\n" "\t""\v"y."\f" El valor predeterminado es none o no se recorta.
digerir	string	Opcional. El256 resumen SHA- del resultado de la expansión. Si se especifica, también debe especificar digest_key.
clave de resumen	string	Opcional. La representación de cadena hexadecimal del secreto utilizado para calcular el256 resumen SHA-. Si se especifica, también debe especificar el resumen.

Nota

• Si el archivo de configuración incluye la __rest expansión, en Linux/macOS, el acceso de lectura al archivo de configuración debe limitarse únicamente al usuario que ejecuta mongod mongos el proceso /.

• Para habilitar el análisis de la __rest directiva de expansión, inicie mongod/mongos con la --configExpand "rest" opción.

Para ver ejemplos, consulte Utilizar la __rest directiva de expansión.

__exec

La __exec directiva de expansión carga los valores del archivo de configuración desde la salida de un comando de shell o terminal. __exec permite cargar valores específicos en el archivo de configuración o cargar el archivo de configuración completo. A continuación,mongod/mongos empieza a usar los valores externos como parte de su configuración.

La __exec directiva de expansión tiene la siguiente sintaxis:

• Para especificar un comando de shell o terminal para una o más configuraciones de un archivo de configuración específico:

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

• Para especificar un comando de shell o terminal para todo el archivo de configuración:

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

  Si se especifica el archivo de configuración completo a través de un comando de terminal o shell, la directiva de expansión y sus opciones deben ser los únicos valores especificados en el archivo de configuración.

__exec toma los siguientes campos:

Campo	Tipo	Descripción
__exec	string	Obligatorio La cadena que mongod/ ejecuta en la terminal o shell para recuperar el valor de origenmongos externo. En hosts Linux y OSX, la ejecución se gestiona mediante POSIX popen(). En hosts Windows, la ejecución se gestiona mediante la API de control de procesos. __exec abre una tubería de solo lectura con el mismo usuario que inició mongod o mongos. IMPORTANTE: Los datos devueltos al ejecutar el comando especificado no pueden incluir directivas de expansión adicionales.mongod/mongos no realiza procesamiento adicional en los datos devueltos y finalizará con un código de error si estos incluyen directivas de expansión adicionales.
type	string	Opcional Controla cómo analiza el valor devuelto por el comando __exec ejecutado. Los valores posibles son: string ( Pordefecto ) Indica a que analice los datos devueltos como una cadena literal. Si __exec se string especifica, todo el __exec bloque y las opciones complementarias deben estar anidados bajo el campo para el que se cargan los valores de origen externo. yaml Indica a que analice los datos devueltos como __exec un yaml archivo con formato. Si se yaml especifica, el bloque debe ser el __exec mongodúnico contenido del archivo de configuración. / reemplazamongos el yaml contenido del archivo de configuración con el obtenido del comando ejecutado.
trim	string	Opcional: Especifique whitespace para indicar a que recorte cualquier espacio inicial o final, específicamente las __exec ocurrencias " " "\r"de,,,, "\n" "\t""\v"y."\f" El valor predeterminado es none o no se recorta.
digerir	string	Opcional. El256 resumen SHA- del resultado de la expansión. Si se especifica, también debe especificar la digest_key
clave de resumen	string	Opcional. La representación de cadena hexadecimal del secreto utilizado para calcular el256 resumen SHA-. Si se especifica, también debe especificar el resumen.

Nota

• Si el archivo de configuración incluye la __exec expansión, en Linux/macOS, el acceso de escritura al archivo de configuración debe estar limitado únicamente al usuario que ejecuta mongod mongos el proceso /.

• Para habilitar el análisis de las __exec directivas de expansión, inicie mongod/mongos con la --configExpand "exec" opción.

Para ver ejemplos, consulte Utilizar la __exec directiva de expansión.

Genere el archivo de configuración con los valores resueltos de la directiva de expansión

Puede probar la salida final de un archivo de configuración que especifique una o más directivas de expansión iniciando mongod/mongos con la --outputConfig opción. Un mongod/mongos iniciado con genera el documento de configuración YAML --outputConfig resuelto stdout en y se detiene. Si alguna directiva de expansión especificada en el archivo de configuración devuelve directivas de expansión adicionales,mongod/ genera un error ymongos finaliza.

Por ejemplo, el siguiente archivo mongod.conf de configuración contiene una __rest directiva de expansión:

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

La cadena registrada en la URL especificada es 20128

Si el archivo de configuración incluye la __rest expansión, en Linux/macOS, el acceso de lectura al archivo de configuración debe limitarse únicamente al usuario que ejecuta mongod mongos el proceso /.

Comience el mongod con --configExpand "rest" las opciones --outputConfig y:

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

El envía lo siguiente mongod a stdout antes de finalizar:

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