/ /

Archivo de configuración CLI de MongoDB

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 Comandode configuración de mongocli.

Importante

Su Las claves API son como contraseñas. El archivo de configuración almacena las claves API en texto plano, así que asegúrese de protegerlo adecuadamente.

Ubicación del archivo de configuración

La primera vez que ejecuta el comando de configuración de mongocli, la CLI de MongoDB crea un archivo de configuración llamado config.tomlLa 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 el 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 las configuraciones almacenadas en los perfiles.

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

Perfil predeterminado

Si ejecuta un comando sin la opción --profile, la CLI de MongoDB utiliza la configuración del perfil predeterminado. La CLI de MongoDB determina el perfil predeterminado según el número de perfiles configurados:

Si solo tiene un perfil, la CLI de MongoDB usa ese perfil como predeterminado.
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 al Shell de MongoDB, mongosh, y dos perfiles, default myOpsManagery.

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

Un ID de organización
Claves API
Un ID de proyecto

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

La URL base de Ops Manager.
Un identificador de organización.
Claves API.
Un identificador de proyecto.
Opcional La ruta completa en su sistema local al certificado de la autoridad de certificación (CA) codificado en PEM utilizado para firmar los certificados TLS del cliente y de Ops Manager
Banderaopcional que indica si el certificado TLS de CA está verificado.

$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 MongoDB CLI con el perfil myOpsManager, agregue la opción --profile myOpsManager al comando:

mongocli <command> --profile myOpsManager

Volver

Configurar

Variables de entorno