Crear una aplicación de servicios de aplicaciones

Navegue a la interfaz de usuario de servicios de aplicaciones

En el panel del Proyecto Atlas UI, haga clic en el icono App Services tab.

Elija un tipo de aplicación

Puedes crear una aplicación en blanco o empezar desde una plantilla con servicios preconfigurados. Algunas plantillas de aplicación también incluyen sus aplicaciones cliente correspondientes.

Para obtener más información, consulte Aplicaciones de plantilla.

Si el proyecto no tiene aplicaciones, se le pedirá que cree una nueva aplicación a partir de una plantilla o que comience desde cero.

De lo contrario, puede elegir entre dos botones de creación en la parte superior derecha de la pestaña App Services:

• Para crear una aplicación en blanco, haga clic en el botón Create a New App.

• Para utilizar una plantilla, haz clic en Create App from Template y selecciona una plantilla del menú desplegable.

Configurar los ajustes de la aplicación

La interfaz de usuario le solicita que configure los siguientes ajustes:

• El Nombre de la aplicación. El nombre de tu aplicación es público y se incluye en el ID de la aplicación que usan los clientes.

  Nota

  Limitaciones del nombre de la aplicación

  Los nombres de las aplicaciones deben tener entre 1 y 32 caracteres y solo pueden contener letras ASCII, números, guiones bajos y guiones.

• Una fuente de datos vinculada. Se trata de un clúster de Atlas al que la aplicación puede acceder. Si el proyecto no tiene clústeres, puede configurar App Services para que cree uno automáticamente.

  Nota

  Se requiere la versión 5.0 de MongoDB o superior

  Atlas Device Sync requiere un clúster Atlas con MongoDB versión 5.0 o posterior. Al configurar el clúster, seleccione la versión en el menú desplegable bajo Additional Settings.

También puedes configurar la siguiente configuración opcional en Advanced Configuration:

• La Región de la aplicación que determina dónde se ejecuta tu aplicación y dónde se almacena su metadatos. Para obtener más información, consulta Modelos de implementación y regiones.

• El entorno de la aplicación determina qué valores del entorno se usarán. Para obtener más información, consulta Configurarun entorno de aplicación.

Crea la aplicación

Una vez que haya configurado la aplicación, haga clic en Create App Service.

Una vez creada tu aplicación, la Interfaz de Usuario de Atlas te redirigirá automáticamente a la interfaz de administración de App Services.

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>"

Ejecutar el comando de creación de aplicaciones

La CLI puede crear una aplicación y copiar sus archivos de configuración a un directorio local con un solo comando. El comando solicita especificar el nombre de la aplicación y el proyecto Atlas que la contendrá. Puede configurar el comando con indicadores o de forma interactiva.

appservices apps create

El comando también admite indicadores adicionales que puedes incluir opcionalmente para personalizar tu aplicación. La siguiente tabla muestra indicadores comunes que puedes usar:

Obtenga un token de acceso a la API de administrador

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.

Obtener el ID del proyecto

Cada aplicación de App Services pertenece a un proyecto MongoDB Atlas.

Para crear una aplicación, debe tener el ID de proyecto (a veces denominado ID de grupo) del proyecto de MongoDB Atlas que contiene la aplicación. Incluya este ID en la URL de las solicitudes de API.

Crear una nueva aplicación

Puedes crear una nueva aplicación a través del endpoint Crear una aplicación.

Su solicitud debe incluir:

• Un Authorization encabezado con su token de acceso a la API de administración como token de portador.

• Un name para la nueva aplicación

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps \
  --header 'Authorization:  Bearer <access_token>' \
  --data '{ "name": "<App Name>" }'

Si quieres crear una aplicación a partir de una plantilla, también debes incluir lo siguiente en el cuerpo de la solicitud:

• El campo template_id con una de las apps de plantilla disponibles. Para obtener una lista de todas las aplicaciones de plantilla, consulta Aplicaciones de plantilla disponibles.

• El campo data_source con información sobre un clúster Atlas existente.

  curl -X POST \
    https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps \
    -H 'Authorization:  Bearer <access_token>' \
    -d '{
      "name": "<App Name>",
      "template_id": "<Template App Id>",
      "data_source": {
        "name": "mongodb-atlas",
        "type": "mongodb-atlas",
        "config": {
          "clusterName": "<Atlas Cluster Name>"
        }
      }
    }'

Si su aplicación se crea correctamente, la API devuelve una respuesta 201 con información sobre su nueva aplicación.