Configurar un entorno de aplicación

Crear un nuevo valor

En la interfaz de usuario de App Services, haga clic en Values en el menú de navegación de la izquierda, haga clic en Create New Value.

Introduzca un nombre para el valor y seleccione Environment para el tipo de valor.

Definir valores para cada entorno

Define un valor para cada etiqueta de entorno de la que quieras acceder al valor. Puedes definir un valor diferente para cada entorno y puedes dejar un valor sin definir en cualquier entorno.

Especifique el entorno de su aplicación

Tu aplicación siempre se ejecuta en un entorno específico, lo que afecta el valor de todos los valores del entorno. Puedes especificar el entorno actual de tu aplicación en la pantalla Deploy > Environment.

Guardar e implementar.

Una vez definido el valor del entorno, haga clic en Save para actualizar la configuración. Si su aplicación tiene habilitados los borradores de implementación, haga clic en Review & Deploy para implementar los cambios.

Autenticar a un usuario de MongoDB Atlas

Utiliza tu clave de API de administrador de MongoDB Atlas para iniciar sesión en la CLI:

appservices login --api-key="<my api key>" --private-api-key="<my private api key>"

Obtenga la última versión de su aplicación

Obtén una copia local de los archivos de configuración de tu aplicación. Para obtener la última versión, ejecuta el siguiente comando:

appservices pull --remote="<Your App ID>"

También puedes exportar una copia de los archivos de configuración de tu aplicación desde la interfaz de usuario o con la API de administración. Para saber cómo, consulta Exportar una aplicación.

Definir uno o más entornos

El directorio /environments contiene un archivo .json para cada etiqueta de entorno compatible. Cada archivo define todos los valores de entorno para su entorno correspondiente.

aplicación Services es compatible con las siguientes etiquetas de entorno:

• ""

• "development"

• "testing"

• "qa"

• "production"

Abra el archivo para cada entorno que desee usar. En cada archivo, agregue una entrada al subdocumento values que asigne el nombre del valor a su valor en ese entorno.

{
  "values": {
    "baseUrl": "https://example.com"
  }
}

{
  "values": {
    "baseUrl": "https://dev.example.com"
  }
}

Configura el entorno de tu aplicación

La aplicación siempre se ejecuta en un entorno específico, lo que afecta el valor de todos los valores de entorno. Puedes especificar el entorno actual para tu aplicación en root_config.json:

{
  ...,
  "environment": "development"
}

Implementa tu aplicación

Una vez que hayas definido los valores para cada entorno, puedes aplicar las configuraciones actualizadas a tu aplicación remota. La CLI de App Services implementa inmediatamente los valores actualizados del entorno al realizar el push.

appservices push --remote="<Your App ID>"

Autenticar a un usuario de MongoDB Atlas

Call the admin user authentication endpoint with your MongoDB Atlas API key pair:

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "username": "<Public API Key>",
    "apiKey": "<Private API Key>"
  }'

If authentication succeeds, the response body contains a JSON object with an access_token value:

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

El access_token concede acceso a la API de Administración de App Services. Debe incluirlo como un token Bearer en el encabezado Authorization para todas las solicitudes a la API de administración.

Definir valores ambientales

Puedes definir valores de entorno para tu aplicación llamando al endpoint Crear un valor de entorno. Cada valor de entorno tiene un nombre y un objeto values que asigna etiquetas de entorno al valor en el entorno.

curl -X GET \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/environment_values/{environmentValueId} \
  -H 'Authorization: Bearer <access_token>' \
  -d '{
    "name": "myEnvironmentValue",
    "values": {
      "none": "alpha",
      "development": "beta",
      "testing": "gamma",
      "qa": "delta",
      "production": "epsilon"
    }
  }'

Configura el entorno de tu aplicación

Puede configurar la etiqueta de entorno de su aplicación llamando al punto final Establecer el entorno de la aplicación.

curl -X PUT \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/environment \
  -H 'Authorization: Bearer <access_token>' \
  -d '{ "environment": "production" }'