Uso de Azure Static Web Apps con una API de datos

Completados

Static Web Apps es un concepto en el diseño de sitios web que se ha vuelto popular. Consiste en contenido enviado directamente al explorador de un usuario que no requiere que se ejecute ningún código en el servidor. Static Web Apps se compone de HTML y CSS. También suele incluir código JavaScript que se ejecuta en el lado cliente, no en el servidor. Los desarrolladores web suelen encontrar que Static Web Apps:

  • Se puede desarrollar rápidamente con marcos como Bootstrap, Jekyll y AngularJS.
  • Es fácil de escalar porque no hay cambios de estado en el servidor.
  • Fomenta la separación entre el código de la interfaz de usuario y la funcionalidad de back-end.

Azure Static Web Apps es un servicio de Azure diseñado para facilitar el código e implementar Static Web Apps en Azure para producción. Azure Static Web Apps admite la implementación continua mediante la supervisión de un repositorio de código en GitHub o Azure DevOps. Al realizar un cambio en el código del sitio web e insertarlo en el repositorio, Azure Static Web Apps lo detecta, compila e implementa automáticamente el nuevo sitio en Azure. De forma inmediata, el cambio estará disponible para los usuarios.

Diagrama que muestra cómo Azure Static Web Apps facilita la implementación de aplicaciones web estáticas desde repositorios.

Nota:

La característica Conexiones de base de datos que anteriormente dejaba que Azure Static Web Apps el generador de DATA API (DAB) del host se retirara directamente el 30 de noviembre de 2025. El patrón actual es hospedar DAB como un servicio independiente en Azure Container Apps o Azure App Service (consulte la siguiente unidad) y hacer que el front-end de la aplicación web estática llame a ese punto de conexión a través de HTTPS. Para más información, consulte Retirada de conexiones de base de datos.

Creación de una aplicación web estática

Para empezar, vaya a Azure Portal y seleccione Crear un recurso. En la barra de búsqueda, escriba Static Web App. Cuando aparezca la tarjeta Aplicación web estática , selecciónela y, a continuación, seleccione Crear.

A continuación, elija la suscripción y seleccione un grupo de recursos existente o cree uno nuevo. En el cuadro de texto Nombre , escriba un nombre descriptivo para la aplicación. Debe seleccionar el tipo de plan. En el caso de los proyectos personales, puede usar el plan Gratis , mientras que para las aplicaciones de producción, se recomienda el plan Estándar .

Captura de pantalla que muestra cómo completar el asistente para crear una aplicación web estática en Azure Portal.

En Detalles de implementación, especifique el tipo de repositorio que contiene la aplicación. Es necesario iniciar sesión en GitHub o seleccionar el repositorio y la rama en Azure DevOps. Por último, revise la configuración seleccionando Revisar y crear y, a continuación, seleccione Crear para completar el proceso.

Implementación de la API de datos por separado

Dado que DAB ya no está hospedado dentro de Azure Static Web Apps, impleméntelo como su propio servicio. Las dos opciones admitidas son:

  • Azure Container Apps: recomendado para la mayoría de las cargas de trabajo. Usa la imagen de contenedor oficial mcr.microsoft.com/azure-databases/data-api-builder y se integra con la identidad administrada, los Key Vault y las revisiones.
  • Azure App Service: útil si ya ejecuta otras cargas de trabajo web en App Service y quiere estandarizarla.

La siguiente unidad le guía por la implementación Azure Container Apps paso a paso. Cuando finalice la implementación, anote el FQDN público del punto de conexión DAB, por ejemplo, https://<container-app-name>.<region>.azurecontainerapps.io. Puede hacer referencia a esta dirección URL desde la aplicación web estática.

Configuración del front-end para llamar al punto de conexión DAB

Una vez implementado el servicio DAB, puede llamar a sus puntos de conexión REST o GraphQL desde JavaScript que se ejecutan en static Web App.

  1. Habilite CORS en DAB. En el archivo de configuración de DAB, agregue el origen de la aplicación web estática para runtime.host.cors.origins que el explorador permita que el front-end llame a la API.

    "runtime": {
      "host": {
        "cors": {
          "origins": [ "https://<your-static-web-app>.azurestaticapps.net" ],
          "allow-credentials": false
        }
      }
    }
    
  2. Haga referencia al punto de conexión DAB desde el código de front-end. Almacene la dirección URL base en un archivo de configuración o una variable en tiempo de compilación y, a continuación, llame al punto de conexión REST o GraphQL con fetch. Por ejemplo, para leer la Address entidad:

    const DAB_ENDPOINT = "https://<container-app-name>.<region>.azurecontainerapps.io";
    const response = await fetch(`${DAB_ENDPOINT}/api/Address`);
    const data = await response.json();
    

Nota:

Para evitar exponer el punto de conexión de DAB a autores de llamadas anónimos en la red pública de Internet, restrinja el tráfico entrante a las direcciones IP salientes de Static Web App o proteja el punto de conexión con Microsoft Entra ID autenticación y valide el token del autor de la llamada en DAB.

Validación del acceso a la API

Para validar que los dos servicios funcionan juntos, examine la dirección URL de la aplicación web estática desde la sección Azure portalEssentials. Confirme que la página se carga y que el registro de red del explorador muestra las solicitudes correctas al punto de conexión DAB (respuestas HTTP 200 que contienen el JSON de la entidad).

También puede probar el punto de conexión DAB directamente abriendo https://<container-app-name>.<region>.azurecontainerapps.io/api/Address en un explorador o con curl ; debe recibir una lista de filas de la lista de respuestas JSON de la Address tabla.