Inicio rápido: Configuración de una aplicación de Durable Functions para usar El programador de tareas durables de Azure Functions (versión preliminar)

Escriba funciones con estado en un entorno sin servidor mediante Durable Functions, una característica de Azure Functions. Los escenarios en los que Durable Functions es útil incluyen orquestar microservicios y flujos de trabajo, patrones con estado, como fan-out/fan-in y tareas de larga duración.

Puede usar el programador de tareas duraderas como back-end para Durable Functions, para almacenar el estado de runtime de la orquestación y la entidad.

En esta guía de inicio rápido:

Prerrequisitos

En este inicio rápido se da por supuesto que ya tiene un proyecto de Azure Functions en el equipo local con:

• Durable Functions agregado al proyecto, entre los que se incluyen:
  • Una función de orquestador.
  • Función cliente que desencadena la aplicación Durable Functions.
• Proyecto configurado para la depuración local.

Si no cumple estos requisitos previos, se recomienda comenzar con uno de los siguientes inicios rápidos para configurar un proyecto de Functions local:

También necesita lo siguiente:

• Docker instalado para ejecutar el emulador de Durable Task Scheduler.
• Azurite instalado.
• Una Herramienta de prueba HTTP que mantiene los datos seguros.

Agregar el paquete del Programador de tareas durables

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged --prerelease

{
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.29.0, 5.0.0)"
  }
}

Actualización de host.json

Actualice el host.json de la manera siguiente para usar el programador de tareas duraderas como back-end.

{
  "extensions": {
    "durableTask": {
      "hubName": "%TASKHUB_NAME%",
      "storageProvider": {
        "type": "azureManaged",
        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
      }
    }
  }
}

Configuración de local.settings.json

Agregue información de conexión para el desarrollo local:

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "<DEPENDENT ON YOUR PROGRAMMING LANGUAGE>",
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "DURABLE_TASK_SCHEDULER_CONNECTION_STRING": "Endpoint=http://localhost:8080;Authentication=None",
    "TASKHUB_NAME": "default"
  }
}

Configuración del emulador de Durable Task

1. Extraiga la imagen de Docker que contiene el emulador.

   docker pull mcr.microsoft.com/dts/dts-emulator:latest
   

2. Ejecutar el emulador.

   docker run -d -p 8080:8080 -p 8082:8082 mcr.microsoft.com/dts/dts-emulator:latest
   

   La salida siguiente indica que el emulador se ha iniciado correctamente.

   

3. Anote los puertos expuestos en el escritorio de Docker. El programador expone varios puertos para diferentes propósitos:

   • 8080: punto de conexión de gRPC que permite a una aplicación conectarse al programador
   • 8082: punto de conexión para el panel del programador de tareas duraderas

   

Probar localmente

1. Vaya al directorio raíz de la aplicación e inicie Azurite.

   azurite start
   

2. Ejecute la aplicación.

   func start
   

   Debería ver una lista de las funciones de la aplicación. Si ha creado la aplicación después de una de las guías de inicio rápido de Durable Functions, debería ver algo similar a la salida siguiente:

   

3. Inicie una instancia de orquestación mediante el envío de una solicitud HTTP POST al punto de conexión de dirección URL mediante la Herramienta de prueba HTTP que eligió.

4. Copie el valor de dirección URL de statusQueryGetUri y péguelo en la barra de direcciones del explorador. Debería ver el estado en la instancia de orquestación:

     {
       "name": "DurableFunctionsOrchestrationCSharp1",
       "instanceId": "b50f8b723f2f44149ab9fd2e3790a0e8",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
         "Hello Tokyo!",
         "Hello Seattle!",
         "Hello London!"
       ],
       "createdTime": "2025-02-21T21:09:59Z",
       "lastUpdatedTime": "2025-02-21T21:10:00Z"
     }
   

5. Para ver más detalles sobre la instancia de orquestación, vaya a http://localhost:8082/ para acceder al panel del programador de tareas duraderas.

6. Haga clic en el centro de tareas predeterminado para ver su panel.

Ejecución de la aplicación en Azure

Creación de los recursos necesarios

Cree una instancia de Programador de Tareas Duraderas y una aplicación de Azure Functions en Azure siguiendo el flujo de creación integrado de la aplicación de funciones. Esta experiencia configurará automáticamente el acceso basado en identidades y configurará las variables de entorno necesarias para que la aplicación acceda al programador.

1. Vaya a la hoja Creación de aplicaciones de Functions y seleccione Functions Premium o App Service como opción de hospedaje.

   

2. En la hoja Crear aplicación Function (App Service) rellene la información de la pestaña Aspectos básicos.

   

   Campo	Descripción
   Suscripción	Seleccione la suscripción de Azure.
   Grupo de recursos	Seleccione uno existente o haga clic en Crear para crear un grupo de recursos nuevo.
   Nombre de la aplicación de funciones	Cree un nombre único para su aplicación de funciones.
   ¿Desea implementar código o imágenes de contenedor?	Mantenga seleccionada la opción Código.
   Pila en tiempo de ejecución	Seleccione el entorno de ejecución que usa para este inicio rápido.
   Versión	Seleccione la versión de la pila en tiempo de ejecución.
   Región	Seleccione alguna de las regiones admitidas.
   Sistema operativo	Seleccione su sistema operativo.

3. Seleccione la pestaña Durable Functions.

4. Elija Programador de tareas duraderas (Durable Task Scheduler) como proveedor de back-end para las funciones duraderas.

5. Cree un recurso de programador. Esta acción crea automáticamente un centro de tareas.

   

   Campo	Descripción
   Back-end de almacenamiento	Seleccione Programador de tareas duraderas (Durable Task Scheduler).
   Región	Se recomienda que las regiones del programador y de la aplicación de funciones sean las mismas.
   Programador de tareas duradera	Use el nombre del programador ofrecido o haga clic en Crear nuevo para crear un nombre personalizado.
   Planificación	Solo Dedicated (Dedicado) está disponible en este momento.
   Unidades de capacidad	Actualmente, solo puede elegir una unidad de capacidad como opción.

6. Haga clic en Revisar y crear para revisar la creación de recursos.

   Se crea automáticamente una identidad administrada asignada por el usuario con el permiso de control de acceso basado en rol (RBAC) necesario y se agrega a la aplicación de funciones. Puede encontrar en la información de vista de resumen relacionada con el recurso de identidad administrada, como:

   • El rol asignado a él (Colaborador de datos de Durable Task)

   • La asignación delimitada al nivel central de tareas

     

7. Haga clic en Crear una vez superada la validación.

La implementación de recursos puede tardar entre 15 y 20 minutos. Una vez finalizado, puede implementar la aplicación en Azure.

Implementación de la aplicación de funciones en Azure

1. En la paleta de comandos, escriba y seleccione Azure Functions: implementar la aplicación de funciones.

2. Seleccione la aplicación de funciones que acaba de crear. Cuando se le solicite sobrescribir las implementaciones anteriores, seleccione Implementar para implementar el código de función en el nuevo recurso de aplicación de funciones.

3. Cuando se complete la implementación, seleccione Ver la salida para ver los resultados de creación e implementación, incluidos los recursos de Azure que creó. Si se pierde la notificación, seleccione el icono de campana en la esquina inferior derecha para verlo de nuevo.

   

Aplicaciones en el plan Premium de Functions

Si la aplicación se ejecuta en el plan Functions Premium, active la configuración Supervisión de escalado en tiempo de ejecución después de la implementación para asegurarse de que la aplicación se escala automáticamente en función de la carga:

az resource update -g <resource_group> -n <function_app_name>/config/web --set properties.functionsRuntimeScaleMonitoringEnabled=1 --resource-type Microsoft.Web/sites

Prueba de la aplicación de funciones

Ejecute el siguiente comando para obtener la dirección URL de la función:

az functionapp function list --resource-group <RESOURCE_GROUP_NAME> --name <FUNCTION_APP_NAME>  --query '[].{Function:name, URL:invokeUrlTemplate}' --output json

Comprobación del estado de la orquestación

Compruebe el estado de la instancia de orquestación y los detalles de la actividad en el panel del Programador de tareas duraderas. El acceso al panel requiere que inicie sesión.

1. Vaya al recurso del programador de tareas duradero en el portal.

2. Haga clic en un nombre del centro de tareas.

3. En el menú izquierdo, seleccione Control de acceso (IAM).

4. Haga clic en Agregar para agregar una asignación de roles.

   

5. Busque y seleccione Colaborador de datos de Durable Task. Haga clic en Next.

   

6. En la pestaña Miembros, en Asignar acceso a, seleccione Usuario, grupo o entidad de servicio.

7. En Miembros, haga clic en + Seleccionar miembros.

8. En el panel Seleccionar miembros, busque el nombre o el correo electrónico:

   

9. Elija el correo electrónico y haga clic en el botón Seleccionar.

10. Haga clic en Revisar y asignar para terminar de asignar el rol.

11. Una vez asignado el rol, haga clic en Información general en el menú izquierdo del recurso del centro de tareas y vaya a la dirección URL del panel ubicada en la sección Essentials superior.

Limpieza de recursos

Si ya no necesita los recursos que creó para completar el inicio rápido, para evitar costos relacionados en la suscripción de Azure, Eliminación del grupo de recursos y todos los recursos relacionados.

Pasos siguientes

• Obtenga más información sobre el panel del Programador de tareas durables.
• Solucione los errores que pueda encontrar al usar el Programador de tareas durables.