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, haga clic en Create App from Template y seleccione 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 la aplicación es público y se incluye en el ID de la aplicación que utilizan 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 o superior de MongoDB

  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 determina dónde se ejecuta la aplicación y dónde se almacenan sus metadatos. Para obtener más información, consulte Modelos y regiones de implementación.

• El entorno de la aplicación determina qué valores de entorno usar. Para obtener más información, consulte Configurar un entorno de la aplicación.

Crea la aplicación

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

Al crear su aplicación, la interfaz de usuario de Atlas lo redirecciona automáticamente a la interfaz de usuario de administración de servicios de aplicaciones.

Autenticar un usuario de MongoDB Atlas

Utilice su clave 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

Llame al punto final de autenticación del usuario administrador con su par de claves API de MongoDB Atlas:

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

Si la autenticación es exitosa, el cuerpo de la respuesta contiene un objeto JSON con un valor access_token:

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

El access_token otorga acceso a la API de administración de App Services. Debe incluirlo como token de portador en el encabezado Authorization para todas las solicitudes de 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 desea crear una aplicación a partir de una plantilla, también debe 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.