Depuración local de Azure Functions con IronPDF

Cuestiones al ejecutar Azure localmente

Una excepción común vista al encontrar este problema es "Error al localizar el archivo de configuración de despliegue IronPdf.Native.Chrome.deployment.json."

Recomendado: Ejecute aplicaciones de función de Azure alojadas en Windows que apunten a .NET Core 3.1 <TargetFramework>netcoreapp3.1</TargetFramework>

Requerido: Use la configuración predeterminada "in-process" al crear una Azure Function en Visual Studio. La última versión de IronPDF soporta Azure Functions ejecutándose 'fuera de proceso' o en un 'proceso aislado', como se describe en la "Guía para ejecutar C# Azure Functions en el modelo de trabajador aislado." Sin embargo, las versiones más antiguas pueden no soportar estos tipos de Azure Functions.

Problema con las dependencias al ejecutar Azure Functions localmente

Al ejecutar Azure localmente, usando Azurite (VS2022) o el Emulador de Almacenamiento de Azure (VS2019), se crea un directorio bin adicional que el Emulador de Almacenamiento utiliza para el despliegue. Solo los archivos DLL se copian en este directorio, por lo que el software que requiere archivos adicionales no funcionará y puede lanzar la excepción mencionada anteriormente.

Puede resolver este problema copiando el directorio de runtimes en el directorio bin separado utilizado por el Emulador de Almacenamiento. Recomendamos hacer esto como un evento posterior a la compilación (ver instrucciones a continuación) cuando se ejecute localmente (ya que recompilar/construir devolverá el directorio bin a su estado original). No encontrará este problema al implementar en la nube.

• Problema: Al ejecutar un proyecto de Azure Function localmente, crea una carpeta bin adicional desde la cual ejecuta la función. Sin embargo, no copia todos los archivos necesarios en dicha carpeta bin.
• Ejemplo: Un proyecto en C:\code\azure-functions-test que se compila en C:\code\azure-functions-test\bin\Debug\netcoreapp3.1
• Solución: Copie el directorio C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\runtimes para que también exista dentro de C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\bin
• Sobrescriba cualquier archivo existente si se le solicita

Evento posterior a la creación

Para automatizar el proceso de copiar los archivos necesarios en el directorio bin local de Azure Function, siga estas instrucciones para configurar un evento posterior a la construcción en Visual Studio:

1. Haga clic derecho en el proyecto de Azure Functions, seleccione Propiedades.
2. Desplácese hacia abajo hasta la sección de Eventos.
3. Introduzca un Evento posterior a la construcción como se muestra a continuación:

XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D

XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D

Este comando hará:

• Copiar el contenido del directorio runtimes en el directorio bin/runtimes.
• Los interruptores /S y /E aseguran que todos los subdirectorios y directorios vacíos estén incluidos.
• El interruptor /Y suprime las solicitudes de confirmación para sobrescribir un archivo de destino existente.
• El interruptor /I asume que el destino es un directorio si no existe.
• El interruptor /R sobrescribe archivos de solo lectura.
• El interruptor /D copia archivos modificados en o después de la fecha especificada.