/ /

Guardar la configuración de conexión

Puede guardar la configuración de conexión que usa con frecuencia como perfiles. Los perfiles almacenan los ID de proyecto, los ID de organización y, opcionalmente, Claves API para usar en futuras sesiones de Atlas CLI. Para ahorrar tiempo, puede especificar un perfil en lugar de usar las --projectId y --orgId con cada comando. La CLI de Atlas almacena sus perfiles en un archivo de configuración config.tomlllamado.

Nota

Cualquier configuración almacenada en Las variables de entorno prevalecen sobre la configuración almacenada en los perfiles. Cualquier proyecto u organización especificado con los indicadores --projectId y --orgId prevalece sobre el perfil y las variables de entorno.

Localizar el archivo de configuración

El CLI de Atlas guarda el archivo de configuración en la siguiente ubicación, según el sistema operativo:

%AppData/atlascli

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

$XDG_CONFIG_HOME/atlascli

De forma predeterminada, la CLI de Atlas guarda el archivo de configuración en la ruta definida en la $XDG_CONFIG_HOME variable de entorno. Puede modificar la ruta definida en la $XDG_CONFIG_HOME variable a su ubicación preferida. Para obtener más información sobre cómo modificar la $XDG_CONFIG_HOME variable, consulte la Especificación del directorio base de XDG.

Si $XDG_CONFIG_HOME no está configurado, Atlas CLI utiliza:

$HOME/.config/atlascli

La CLI de Atlas otorga al usuario que ejecutó el comando acceso de lectura y escritura al archivo.

Cree un perfil

La primera vez que se ejecuta el comando atlas auth login o atlas config init, la CLI de Atlas crea automáticamente el archivo config.toml y un perfil predeterminado. Si se ejecuta un comando sin especificar un perfil, variables de entorno ni indicadores --projectId y --orgId, la CLI de Atlas usa el perfil predeterminado para el comando.

Seleccione su caso de uso

Seleccione un método de conexión según su caso de uso:

Opción	Método de autenticación	Caso de uso
`UserAccount`	Credenciales de inicio de sesión de Atlas y un token de autenticación	Mejor para uso no programático
`ServiceAccount`	Cuenta de servicio	Mejor para uso programático con una Cuenta de Servicio
`APIKeys`	Claves API	Ideal para el uso programático con una clave API

Para obtener más información,consulte Seleccionar un método de conexión.

Completar los requisitos previos

Instale el Atlas CLI.
Añadir la dirección IP del host a la lista de acceso IP.
Si selecciona atlas config init como método de conexión, debe configurar las claves API.
Si su instalación de Atlas CLI está detrás de un firewall y desea utilizar una URL de proxy, configure la HTTP_PROXY HTTPS_PROXY variable de entorno o.
Importante
La CLI de Atlas admite los esquemas http, https y socks5. Debe especificar cloud.mongodb.com/ como la URL de destino principal en la lista de acceso del servicio proxy. También debe especificar el nombre de usuario y la contraseña si la configuración del proxy permite la autenticación.
Para obtener más información,consulte Servidor proxy.

Siga estos pasos

Seleccione un caso de uso y siga el procedimiento para crear un perfil.

Seleccione el perfil predeterminado o un perfil con nombre.

Crea un perfil por defecto para:

Ejecute un comando sin especificar un perfil, variables de entorno o indicadores --projectId y --orgId.
Utiliza la marca --profile default.

Crea un perfil con nombre para utilizar el indicador --profile <profileName>.

Siga estos pasos para crear el perfil predeterminado. Si ya existe, estos comandos actualizan sus valores.

Ejecutar el comando de autenticación.

Ejecutar el comando atlas auth login en la terminal.

atlas auth login

El comando abre una ventana del navegador y devuelve un código de activación de un solo uso. Este código expira después de 10 minutos.

Inicie sesión en Atlas.

Si aún no ha iniciado sesión, inicie sesión en su cuenta de Atlas en el navegador.

Introduzca el código de autorización.

Pegue su código de activación en el navegador y haga clic Confirm Authorization.

Regresar a la CLI de Atlas.

Regresar a la terminal. Si se conecta correctamente, verá un mensaje:

Successfully logged in as {Your Email Address}.

Seleccione su organización predeterminada.

Presione el Down Arrow y las teclas Up Arrow para resaltar la organización deseada y presione Enter.

? Choose a default organization:  [Use arrows to move, type to filter]
> Org1 (5e39bf1212121e685774c81c)

Nota

Si tiene acceso a más de 500 organizaciones, debe escribir el ID de la organización o el nombre de la organización para filtrar los resultados antes de usar las flechas para seleccionar una organización.

Seleccione su proyecto predeterminado.

Presione las teclas Down Arrow y Up Arrow para resaltar el proyecto deseado y presione Enter.

? Choose a default project:  [Use arrows to move, type to filter]
  Project1 (5e5ebffd0c04a97009061234)
  Project2 (5cfacee6014b761b07f15678)
> Project3 (5e39bf4979358e6857741212)
  Project4 (5c815cc7014b768fb67e3434)

Seleccione su formato de salida predeterminado.

Presione las teclas Down Arrow y Up Arrow para resaltar el formato de salida deseado y presione Enter.

? Default Output Format:  [Use arrows to move, type to filter]
> plaintext
  json

Opción	Descripción
`plaintext`	Salida legible para humanos que incluye todos los campos que La CLI de Atlas regresa.
`json`	Salida JSON que incluye todos los campos que devuelve la CLI de MongoDB.

Especifique la ruta al Shell MongoDB,, en su`mongosh` sistema.

La CLI de Atlas utiliza la mongosh ruta especificada para acceder a sus implementaciones. El valor predeterminado /usr/local/bin/mongosh es. Pulse Enter para aceptar el valor predeterminado o especifique la ruta en su sistema mongosh y Enter pulse.

? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)

Verifique la configuración de su perfil.

Consulta el archivo de configuración o ejecuta el comando atlas config describe para verificar tu perfil. Para el perfil por defecto, el <profileName> es default.

atlas config describe <profileName>

El comando devuelve la siguiente configuración. La CLI de Atlas redacta los valores del token de acceso y del token de actualización por motivos de seguridad.

SETTING           VALUE
"access_token":   "redacted",
"mongosh_path":   "/usr/local/bin/mongosh",
"org_id":         "60c9877baf349d6fc4fd9744",
"output":         "json",
"project_id":     "60c94857241ae99848af45ad",
"refresh_token":  "redacted",
"service":        "cloud"

Siga estos pasos para crear un perfil con un nombre personalizado.

Ejecutar el comando de autenticación.

Ejecute el comando atlas auth login en su terminal con el indicador profile <profileName>. <profileName> debe ser el nombre deseado para su nuevo perfil.

atlas auth login --profile myProfile

El comando abre una ventana del navegador y devuelve un código de activación de un solo uso. Este código expira después de 10 minutos.

Inicie sesión en Atlas.

Si aún no ha iniciado sesión, inicie sesión en su cuenta de Atlas en el navegador.

Introduzca el código de autorización.

Pegue su código de activación en el navegador y haga clic en Confirm Authorization.

Regresar a la CLI de Atlas.

Regresar a la terminal. Si se conecta correctamente, verá un mensaje:

Successfully logged in as {Your Email Address}.

Seleccione su organización predeterminada.

Presione las teclas Down Arrow y Up Arrow para resaltar la organización deseada y presione Enter.

? Choose a default organization:  [Use arrows to move, type to filter]
> Org1 (5e39bf1212121e685774c81c)

Nota

Seleccione su proyecto predeterminado.

Presione las teclas Down Arrow y Up Arrow para resaltar el proyecto deseado y presione Enter.

? Choose a default project:  [Use arrows to move, type to filter]
  Project1 (5e5ebffd0c04a97009061234)
  Project2 (5cfacee6014b761b07f15678)
> Project3 (5e39bf4979358e6857741212)
  Project4 (5c815cc7014b768fb67e3434)

Seleccione su formato de salida predeterminado.

Presione las teclas Down Arrow y Up Arrow para resaltar el formato de salida deseado y presione Enter.

? Default Output Format:  [Use arrows to move, type to filter]
> plaintext
  json

Opción	Descripción
`plaintext`	Salida legible para humanos que incluye todos los campos que La CLI de Atlas regresa.
`json`	Salida JSON que incluye todos los campos que devuelve la CLI de MongoDB.

Especifique la ruta al Shell MongoDB,, en su`mongosh` sistema.

? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)

Verifique la configuración de su perfil.

Consulta el archivo de configuración o ejecuta el comando atlas config describe para verificar tu perfil. Para el perfil por defecto, el <profileName> es default.

atlas config describe <profileName>

El comando devuelve la siguiente configuración. La CLI de Atlas redacta los valores del token de acceso y del token de actualización por motivos de seguridad.

SETTING           VALUE
"access_token":   "redacted",
"mongosh_path":   "/usr/local/bin/mongosh",
"org_id":         "60c9877baf349d6fc4fd9744",
"output":         "json",
"project_id":     "60c94857241ae99848af45ad",
"refresh_token":  "redacted",
"service":        "cloud"

Seleccione el perfil predeterminado o un perfil con nombre.

Crea un perfil por defecto para:

Ejecute un comando sin especificar un perfil, variables de entorno o indicadores --projectId y --orgId.
Utiliza la marca --profile default.

Crea un perfil con nombre para utilizar el indicador --profile <profileName>.

Siga estos pasos para crear el perfil predeterminado. Si ya existe, estos comandos actualizan sus valores.

Ejecutar el comando de autenticación.

Ejecutar el comando atlas auth login en la terminal.

atlas auth login

Introduzca sus claves API.

Introducir las llaves privadas y públicas cuando se soliciten.

Seleccione su organización predeterminada.

Presione las teclas Down Arrow y Up Arrow para resaltar la organización deseada y presione Enter.

? Choose a default organization:  [Use arrows to move, type to filter]
> Org1 (5e39bf1212121e685774c81c)

Seleccione su proyecto predeterminado.

Presione las teclas Down Arrow y Up Arrow para resaltar el proyecto deseado y presione Enter.

? Choose a default project:  [Use arrows to move, type to filter]
  Project1 (5e5ebffd0c04a97009061234)
  Project2 (5cfacee6014b761b07f15678)
> Project3 (5e39bf4979358e6857741212)
  Project4 (5c815cc7014b768fb67e3434)

Seleccione su formato de salida predeterminado.

Presione las teclas Down Arrow y Up Arrow para resaltar el formato de salida deseado y presione Enter.

? Default Output Format:  [Use arrows to move, type to filter]
> plaintext
  json

Opción	Descripción
`plaintext`	Salida legible por humanos que incluye todos los campos que devuelve la CLI de Atlas.
`json`	Salida JSON que incluye todos los campos que devuelve la CLI de MongoDB.

Especifique la ruta al Shell MongoDB,, en su`mongosh` sistema.

? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)

Verifique la configuración de su perfil.

Consulta el archivo de configuración o ejecuta el comando atlas config describe para verificar tu perfil. Para el perfil por defecto, el <profileName> es default.

atlas config describe <profileName>

El comando devuelve la siguiente configuración. La CLI de Atlas redacta los valores de la clave API por motivos de seguridad.

SETTING            VALUE
"mongosh_path":    "/usr/local/bin/mongosh",
"org_id":          "60c9877baf349d6fc4fd9744",
"output":          "json",
"private_api_key": "redacted",
"project_id":      "60c94857241ae99848af45ad",
"public_api_key":  "redacted",
"service":         "cloud"

Siga estos pasos para crear un perfil con un nombre personalizado.

Ejecutar el comando de autenticación.

Ejecute el comando atlas config init en su terminal con el indicador profile <profileName>. <profileName> debe ser el nombre deseado para su nuevo perfil.

atlas config init --profile myProfile

Introduzca sus claves API.

Introducir las llaves privadas y públicas cuando se soliciten.

Seleccione su organización predeterminada.

Presione las teclas Down Arrow y Up Arrow para resaltar la organización deseada y presione Enter.

? Choose a default organization:  [Use arrows to move, type to filter]
> Org1 (5e39bf1212121e685774c81c)

Seleccione su proyecto predeterminado.

Presione las teclas Down Arrow y Up Arrow para resaltar el proyecto deseado y presione Enter.

? Choose a default project:  [Use arrows to move, type to filter]
  Project1 (5e5ebffd0c04a97009061234)
  Project2 (5cfacee6014b761b07f15678)
> Project3 (5e39bf4979358e6857741212)
  Project4 (5c815cc7014b768fb67e3434)

Seleccione su formato de salida predeterminado.

Presione las teclas Down Arrow y Up Arrow para resaltar el formato de salida deseado y presione Enter.

? Default Output Format:  [Use arrows to move, type to filter]
> plaintext
  json

Opción	Descripción
`plaintext`	Salida legible por humanos que incluye todos los campos que devuelve la CLI de Atlas.
`json`	Salida JSON que incluye todos los campos que devuelve la CLI de MongoDB.

Especifique la ruta al Shell MongoDB,, en su`mongosh` sistema.

? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)

Verifique la configuración de su perfil.

Consulta el archivo de configuración o ejecuta el comando atlas config describe para verificar tu perfil. Para el perfil por defecto, el <profileName> es default.

atlas config describe <profileName>

El comando devuelve la siguiente configuración. La CLI de Atlas redacta los valores de la clave API por motivos de seguridad.

SETTING            VALUE
"mongosh_path":    "/usr/local/bin/mongosh",
"org_id":          "60c9877baf349d6fc4fd9744",
"output":          "json",
"private_api_key": "redacted",
"project_id":      "60c94857241ae99848af45ad",
"public_api_key":  "redacted",
"service":         "cloud"

Actualizar un perfil

Puede actualizar la configuración almacenada en su archivo de configuración de las siguientes maneras:

Edite el archivo config.toml con un editor de texto.
Ejecute el comando atlas config set para una configuración. Esto edita un valor individual en el archivo config.toml.

Ejecutar un comando con un perfil

Para ejecutar un comando CLI de Atlas usando un perfil:

Crear un perfil.
Agregue el indicador --profile <profileName> a un comando u omita el indicador --profile <profileName> para usar el perfil predeterminado.

Ejemplo

Este comando utiliza un perfil llamado myProfile:

atlas <command> --profile myProfile

Este comando utiliza el perfil predeterminado:

atlas <command>

Volver

Conectar

Migrar a la Atlas CLI

Nota

Localizar el archivo de configuración

Cree un perfil

Seleccione su caso de uso

Completar los requisitos previos

Importante

Siga estos pasos

Ejecutar el comando de autenticación.

Inicie sesión en Atlas.

Introduzca el código de autorización.

Regresar a la CLI de Atlas.

Seleccione su organización predeterminada.

Nota

Seleccione su proyecto predeterminado.

Seleccione su formato de salida predeterminado.

Especifique la ruta al Shell MongoDB,, en sumongosh sistema.

Verifique la configuración de su perfil.

Ejecutar el comando de autenticación.

Inicie sesión en Atlas.

Introduzca el código de autorización.

Regresar a la CLI de Atlas.

Seleccione su organización predeterminada.

Nota

Seleccione su proyecto predeterminado.

Seleccione su formato de salida predeterminado.

Especifique la ruta al Shell MongoDB,, en sumongosh sistema.

Verifique la configuración de su perfil.

Ejecutar el comando de autenticación.

Introduzca sus claves API.

Seleccione su organización predeterminada.

Seleccione su proyecto predeterminado.

Seleccione su formato de salida predeterminado.

Especifique la ruta al Shell MongoDB,, en sumongosh sistema.

Verifique la configuración de su perfil.

Ejecutar el comando de autenticación.

Introduzca sus claves API.

Seleccione su organización predeterminada.

Seleccione su proyecto predeterminado.

Seleccione su formato de salida predeterminado.

Especifique la ruta al Shell MongoDB,, en sumongosh sistema.

Verifique la configuración de su perfil.

Actualizar un perfil

Ejecutar un comando con un perfil

Ejemplo

Especifique la ruta al Shell MongoDB,, en su`mongosh` sistema.

Especifique la ruta al Shell MongoDB,, en su`mongosh` sistema.

Especifique la ruta al Shell MongoDB,, en su`mongosh` sistema.

Especifique la ruta al Shell MongoDB,, en su`mongosh` sistema.