Ejecución de la instancia de Azure Functions desde un archivo de paquete

  • Artículo
  • Tiempo de lectura: 6 minutos

En Azure, puede ejecutar las funciones directamente desde un archivo del paquete de implementación de la aplicación de función. La otra opción consiste en implementar los archivos en el directorio d:\home\site\wwwroot de la aplicación de función.

En este artículo se describen las ventajas de ejecutar las funciones desde un paquete. También se muestra cómo habilitar esta funcionalidad en la aplicación de función.

Ventajas de la ejecución desde un archivo de paquete

Son varias las ventajas de ejecutar las funciones desde un archivo de paquete:

  • Se reduce el riesgo de problemas de bloqueo de copia de archivos.
  • Se pueden implementar en una aplicación de producción (con reinicio).
  • Puede estar seguro de los archivos que se ejecutan en la aplicación.
  • Mejora el rendimiento de las implementaciones de Azure Resource Manager.
  • Puede reducir los tiempos de arranque en frío, especialmente para las funciones de JavaScript con árboles de paquete de npm grandes.

Para más información, consulte este anuncio.

Ejecución de las funciones desde un paquete

Para permitir la ejecución de la aplicación de función desde un paquete, solo tiene que agregar un valor WEBSITE_RUN_FROM_PACKAGE a la configuración de la aplicación de función. El valor WEBSITE_RUN_FROM_PACKAGE puede tener uno de los siguientes valores:

Value Descripción
1 Se recomienda para las aplicaciones de función que se ejecutan en Windows. Ejecución desde un archivo de paquete en la carpeta d:\home\data\SitePackages de la aplicación de función. Si no se va a implementar con un archivo zip, esta opción requiere que la carpeta tenga también un archivo denominado packagename.txt. Este archivo contiene solo el nombre del archivo de paquete en la carpeta, sin ningún espacio en blanco.
<URL> Ubicación del archivo de paquete específico que desea ejecutar. Al especificar una dirección URL, también debe sincronizar desencadenadores tras publicar un paquete actualizado.
Al usar Blob Storage, normalmente no debe usar un blob público. En su lugar, debe usar un contenedor de almacenamiento privado con una Firma de acceso compartido (SAS) o bien una identidad administrada para permitir que el entorno de ejecución de Functions acceda al paquete. Puede usar el Explorador de Azure Storage para cargar archivos de paquete en la cuenta de Blob Storage.

Precaución

Al ejecutar una aplicación de función en Windows, la opción de dirección URL externa tiene peor rendimiento con el arranque en frío. Al implementar la aplicación de función en Windows, debe establecer WEBSITE_RUN_FROM_PACKAGE en 1 y publicar con implementación de un archivo zip.

A continuación se muestra una aplicación de función configurada para ejecutarse desde un archivo .zip que se hospeda en Azure Blob Storage:

Valor de aplicación WEBSITE_RUN_FROM_ZIP

Nota

Actualmente, solo se admiten archivos de paquete .zip.

Captura de un paquete de Azure Blob Storage mediante una identidad administrada

Azure Blob Storage se puede configurar para autorizar solicitudes con Azure AD. Esto significa que, en lugar de generar una clave SAS con una fecha de expiración, puede confiar en la identidad administrada de la aplicación. De manera predeterminada, se usará la identidad asignada por el sistema de la aplicación. Si desea especificar una identidad asignada por el usuario, puede establecer la configuración de la aplicación WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID en el identificador de recurso de esa identidad. El valor también puede aceptar "SystemAssigned" como valor, aunque esto es lo mismo que omitir la configuración por completo.

Para habilitar la captura del paquete mediante la identidad:

  1. Asegúrese de que el blob esté configurado para acceso privado.

  2. Conceda a la identidad el rol Lector de datos de Storage Blob con ámbito en el blob del paquete. Consulte Asignación de un rol de Azure para acceder a datos de blobs para obtener información sobre la creación de la asignación de roles.

  3. Establezca la configuración de la aplicación WEBSITE_RUN_FROM_PACKAGE en la dirección URL del blob del paquete. Probablemente tendrá el formato "https://{nombre-de-la-cuenta-de-almacenamiento}.blob.core.windows.net/{nombre-del-contenedor}/{ruta-de-acceso-al-paquete}" o similar.

Integración con la implementación de archivos ZIP

La implementación de archivos ZIP es una característica de Azure App Service que le permite implementar su proyecto de aplicación de funciones en el directorio wwwroot. El proyecto se empaqueta como un archivo de implementación .zip. Las mismas API se pueden usar para implementar el paquete en la carpeta d:\home\data\SitePackages. Con el valor de configuración de la aplicación WEBSITE_RUN_FROM_PACKAGE de 1, las API de implementación de archivos ZIP copian el paquete en la carpeta d:\home\data\SitePackages en lugar de extraer los archivos en d:\home\site\wwwroot. También se crea el archivo packagename.txt. Después de un reinicio, el paquete se monta en wwwroot como un sistema de archivos de solo lectura. Para más información sobre la implementación de archivos ZIP, consulte Implementación para insertar archivos ZIP en Azure Functions.

Nota

Cuando se produce una implementación, se desencadena un reinicio de la aplicación de funciones. Antes del reinicio, todas las ejecuciones de función existentes pueden finalizar o agotar el tiempo de espera. Para más información, consulte Comportamientos de implementación.

Incorporación del valor WEBSITE_RUN_FROM_PACKAGE

Hay varias maneras de agregar, actualizar y eliminar opciones de configuración de la aplicación de función:

Para aplicar los cambios realizados en la configuración de la aplicación de funciones, es necesario reiniciar la aplicación de funciones.

Flujo de trabajo de ejemplo para cargar manualmente un paquete hospedado en Azure Storage

Para implementar un paquete comprimido cuando se usa la opción de dirección URL, debe crear un paquete de implementación comprimido en ZIP y cargarlo en el destino. En este ejemplo se usa un contenedor de Blob Storage.

  1. Cree un paquete ZIP para el proyecto con la utilidad que prefiera.

  2. En Azure Portal, busque el nombre de la cuenta de almacenamiento o vaya a las cuentas de almacenamiento para encontrarla.

  3. En la cuenta de almacenamiento, en Almacenamiento de datos, seleccione Contenedores.

  4. Seleccione + Contenedor para crear un contenedor de Blob Storage en la cuenta.

  5. En la página Nuevo contenedor, rellene el valor de Nombre (por ejemplo, "implementaciones"), asegúrese de que Nivel de acceso público sea Privado y seleccione Crear.

  6. Seleccione el contenedor que creó, elija Cargar, busque la ubicación del archivo ZIP que creó con el proyecto y seleccione Cargar.

  7. Una vez completada la carga, elija el archivo de blob cargado y copie la dirección URL. Puede que tenga que generar una dirección URL de SAS si no usa una identidad.

  8. Busque la aplicación de funciones o vaya a la página Aplicación de funciones para encontrarla.

  9. En la aplicación de funciones, en Configuración, seleccione Configuraciones.

  10. En la pestaña Configuración de la aplicación, seleccione + Nueva configuración de la aplicación.

  11. Escriba el valor WEBSITE_RUN_FROM_PACKAGE en Nombre y, en Valor, pegue la dirección URL del paquete de Blob Storage.

  12. Seleccione Aceptar. A continuación, seleccione Guardar > Continuar para guardar la configuración y reiniciar la aplicación.

Ahora puede ejecutar la función en Azure para comprobar que la implementación se ha realizado correctamente mediante el archivo ZIP del paquete de implementación.

Solución de problemas

  • La ejecución desde el paquete hace que wwwroot sea de solo lectura, por lo que recibirá un error al escribir archivos en este directorio.
  • No se admiten los formatos de archivo tar y gzip.
  • El archivo ZIP puede tener un máximo de 1 GB.
  • Esta característica no se crea con caché local.
  • Para mejorar el rendimiento del arranque en frío, utilice la opción de archivo zip local (WEBSITE_RUN_FROM_PACKAGE = 1).
  • La ejecución desde paquete es incompatible con la opción de personalización de implementación (SCM_DO_BUILD_DURING_DEPLOYMENT=true); el paso de compilación se omitirá durante la implementación.

Pasos siguientes

Implementación continua para Azure Functions