/ /

Archivo de configuración de MongoDB CLI

El archivo de configuración de la CLI de MongoDB almacena sus perfiles. Puede actualizar la configuración almacenada en su archivo de configuración editándolo 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 no se establece $XDG_CONFIG_HOME, la CLI de MongoDB utiliza:

$HOME/.config/mongocli

Perfiles

El archivo de configuración de la CLI de MongoDB almacena la configuración y las claves API relacionadas en grupos llamados perfiles. Puede crear o definir varios perfiles para acceder 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 tiene varios perfiles, la CLI de MongoDB usa el perfil default como predeterminado. Si no tiene un perfil default y ejecuta un comando que requiere ciertas configuraciones, la CLI de MongoDB devuelve un error por la configuración faltante.

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 usar MongoDB CLI con el perfil default, omita la opción --profile del 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