/ /

Archivo de configuración de MongoDB CLI

El MongoDB CLI archivo de configuración almacena tus perfiles. Puedes actualizar la configuración almacenada en tu archivo de configuración editando el archivo con un editor de texto o usando el mongocli config set comando.

Importante

Tu Las API claves son como contraseñas. El archivo de configuración almacena las claves API en texto claro, por lo que debes asegurarte de proteger adecuadamente el archivo de configuración.

Ubicación del archivo de configuración

La primera vez que ejecutes el comando mongocli config, MongoDB CLI crea un archivo de configuración llamado config.toml. La CLI de MongoDB otorga al usuario que ejecutó el comando acceso de lectura y escritura al archivo. La CLI de MongoDB guarda el archivo de configuración en la siguiente ubicación según tu sistema operativo:

%AppData/mongocli

/Users/{username}/Library/Application Support/mongocli

$XDG_CONFIG_HOME/mongocli

Si $XDG_CONFIG_HOME no está configurado, la MongoDB CLI utiliza:

$HOME/.config/mongocli

Perfiles

El archivo de configuración de MongoDB CLI almacena configuraciones relacionadas y claves API en grupos llamados perfiles. Se puede crear o definir múltiples perfiles para poder emplear la MongoDB CLI e ingresar a diferentes servicios o proyectos de MongoDB desde la misma terminal.

Nota

Cualquier configuración almacenada en variables de entorno tiene prioridad sobre la configuración almacenada en los perfiles.

Para ejecutar MongoDB CLI con un perfil específico, agregue la opción --profile <profileName> al comando.

Perfil por defecto

Si ejecuta un comando sin la opción --profile, la CLI de MongoDB utiliza la configuración del perfil por defecto. La MongoDB CLI determina el perfil por defecto por la cantidad de perfiles que has configurado:

Si tienes solo un perfil, la CLI de MongoDB usa ese perfil como por defecto.
Si tienes varios perfiles, el MongoDB CLI utiliza el perfil llamado default como por defecto. Si no tienes un perfil llamado default y ejecutas un comando que requiere ciertos ajustes, la CLI de MongoDB devuelve un error debido a la falta de ajustes.

Ejemplo

El siguiente archivo de configuración de ejemplo contiene la ruta a MongoDB Shell, mongosh, y dos perfiles, default y myOpsManager.

El perfil de default se conecta a una implementación de Atlas y contiene las siguientes configuraciones:

Un Identificador de la Organización
Claves API
Un ID del proyecto

El perfil myOpsManager se conecta a una implementación de Ops Manager y contiene los siguientes ajustes:

La base de URL de Ops Manager.
Un Identificador de la Organización.
API keys.
Un ID del grupo.
Opcional La ruta completa en tu sistema local al certificado de la Entidad Certificadora (CA) codificado en PEM utilizado para firmar los certificados TLS del cliente y del Ops Manager.
Opcional indicación de si se verifica el certificado TLS de la Autoridad de Certificación (CA).

$XDG_CONFIG_HOME/mongocli/config.toml
mongosh_path = "/usr/local/bin/mongosh"
[default]
  organization_id = "qwer5678uiop23jb45lk78mn"
  public_api_key = "ABCDEFG"
  project_id= "5e2f04ecf10fcd33c7d4077e"
  private_api_key = "e750d2bf-1234-4cde-5678-ca4dcbcac9a4"
  service = "cloud"
[myOpsManager]
  ops_manager_ca_certificate = /etc/ssl/certs/ca.pem
  ops_manager_skip_verify = no
  ops_manager_url = "http://localhost:9080/"
  organization_id = "jklsa23123dsdf3jj456hs2"
  public_api_key = "HIJKLMN"
  project_id = "kk12jdn43jd123dkdkf97jg"
  private_api_key = "e750d2bf-9101-4cde-1121-ca4dcbcac9a5"
  service = "ops-manager"

Para utilizar la MongoDB CLI con el perfil default, omite la opción --profile en el comando:

mongocli <command>

Para usar la CLI de MongoDB con el perfil myOpsManager, agregue la opción --profile myOpsManager al comando:

mongocli <command> --profile myOpsManager

Volver

Configurar

Variables de entorno