Creación de su primera función perdurable en C#
Durable Functions es una extensión de Azure Functions que le permite escribir funciones con estado en un entorno sin servidor. La extensión administra el estado, establece puntos de control y reinicia en su nombre.
En este artículo aprenderá a usar Visual Studio Code con el fin de crear y probar localmente una función perdurable "Hola mundo". Esta función se encarga de organizar y encadenar llamadas a otras funciones. Después, podrá publicar el código de función en Azure. Estas herramientas están disponibles como parte de la extensión de Azure Functions de Visual Studio Code.
Requisitos previos
Para completar este tutorial:
Instale Visual Studio Code.
Instale las siguientes extensiones de Visual Studio Code:
Asegúrese de que tiene la versión más reciente de Azure Functions Core Tools.
Durable Functions requiere una cuenta de almacenamiento de Azure. Necesita una suscripción de Azure.
Asegúrese de que tiene instalada la versión 3.1 o una posterior de SDK de .NET Core.
Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
Creación del proyecto local
En esta sección se usa Visual Studio Code para crear un proyecto local en Azure Functions.
En Visual Studio Code, presione la tecla F1 (o Ctrl/Cmd+Mayús+P) para abrir la paleta de comandos. En la paleta de comandos, busque y seleccione
Azure Functions: Create New Project....
Elija una ubicación de carpeta vacía para el proyecto y elija Seleccionar.
Siga las solicitudes y proporcione la siguiente información:
Prompt Valor Descripción Seleccionar el lenguaje para el proyecto de la aplicación de funciones C# Cree un proyecto local de Functions en C#. Selección de una versión Azure Functions v4 Esta opción solo se ve si las herramientas principales no estén instaladas. En este caso, las herramientas principales se instalan la primera vez que se ejecuta la aplicación. Seleccionar una plantilla para la primera función de su proyecto Omitir por ahora Seleccionar cómo desea que se abra el proyecto Abrir en la ventana actual Al elegir este valor, Visual Studio Code volverá a abrirse en la carpeta que seleccionó.
Visual Studio Code instalará el conjunto de herramientas Azure Functions Core Tools si este fuera necesario. También crea el proyecto de una aplicación de funciones en una carpeta. Este proyecto contiene los archivos de configuración host.json y local.settings.json.
Incorporación de funciones a la aplicación
En los pasos siguientes se usa una plantilla para crear el código de Durable Functions en el proyecto.
En la paleta de comandos, busque y seleccione
Azure Functions: Create Function....Siga las solicitudes y proporcione la siguiente información:
Prompt Valor Descripción Seleccionar una plantilla para la función DurableFunctionsOrchestration Crear una orquestación de Durable Functions Proporcionar un nombre de función HelloOrchestration Nombre de la clase en la que se crean las funciones Proporcionar un espacio de nombres Company.Function Espacio de nombres de la clase generada Cuando Visual Studio Code le pida que seleccione una cuenta de almacenamiento, seleccione Seleccionar cuenta de almacenamiento. Siga las indicaciones y proporcione la siguiente información para crear una nueva cuenta de almacenamiento en Azure:
Prompt Valor Descripción Seleccionar suscripción nombre de la suscripción Selección de su suscripción a Azure Seleccione una cuenta de almacenamiento Creación de una cuenta de almacenamiento nueva Escriba el nombre de la nueva cuenta de almacenamiento nombre único Nombre de la cuenta de almacenamiento que se creará Selección de un grupo de recursos nombre único Nombre del grupo de recursos que se creará Seleccionar una ubicación region Seleccione una región cercana
Se agrega al proyecto una clase que contiene las funciones nuevas. Visual Studio Code también agregará la cadena de conexión de la cuenta de almacenamiento al archivo local.settings.json, además de una referencia al paquete NuGet Microsoft.Azure.WebJobs.Extensions.DurableTask al archivo de proyecto .csproj.
Abra el nuevo archivo HelloOrchestration.cs para ver el contenido. Esta función Durable Functions es un ejemplo de una función sencilla de encadenamiento con los métodos siguientes:
| Método | FunctionName | Descripción |
|---|---|---|
RunOrchestrator |
HelloOrchestration |
Administra la orquestación de Durable Functions. En este caso, la orquestación se inicia, crea una lista y le agrega el resultado de tres llamadas a funciones. Una vez completadas las tres llamadas a funciones, devuelve la lista. |
SayHello |
HelloOrchestration_Hello |
Por ejemplo, la función devuelve un saludo. Esta es la función que contiene la lógica de negocios que se va a organizar. |
HttpStart |
HelloOrchestration_HttpStart |
Una función desencadenada por HTTP que inicia una instancia de la orquestación y devuelve una respuesta de comprobación de estado. |
Ahora que ha creado un proyecto de función y una función durable, puede probarla en el equipo local.
Prueba local de la función
Azure Functions Core Tools le permite ejecutar un proyecto de Azure Functions en el equipo de desarrollo local. Se le solicita que instale estas herramientas la primera vez que inicie una función de Visual Studio Code.
Para probar la función, establezca un punto de interrupción en el código de la función de la actividad
SayHelloy presione la tecla F5 para iniciar el proyecto de la aplicación de funciones. La salida de Core Tools aparece en el panel Terminal.Nota
Para más información sobre los procesos de depuración, consulte los Diagnósticos de Durable Functions.
En el panel Terminal, copie el punto de conexión de la dirección URL de la función desencadenada por HTTP.
Utilice una herramienta como Postman o cURL y, después, envíe una solicitud HTTP POST al punto de conexión de la dirección URL.
La respuesta que obtendrá será el resultado inicial de la función HTTP, que nos informa de que la orquestación duradera se ha iniciado correctamente. No obstante, este no es el resultado final de la tarea de orquestación. La respuesta incluye algunas direcciones URL útiles. De momento, vamos a consultar el estado de la orquestación.
Copie el valor de la URL que corresponde a
statusQueryGetUri, péguelo en la barra de direcciones del explorador y ejecute la solicitud. Como alternativa, también puede usar Postman para emitir la solicitud GET.La solicitud consultará la instancia de orquestación sobre el estado. Después de un tiempo, obtendrá una respuesta que mostrará que la instancia se ha completado e incluirá las salidas o los resultados de la función duradera. Su aspecto es similar a:
{ "name": "HelloOrchestration", "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a", "runtimeStatus": "Completed", "input": null, "customStatus": null, "output": [ "Hello Tokyo!", "Hello Seattle!", "Hello London!" ], "createdTime": "2020-03-18T21:54:49Z", "lastUpdatedTime": "2020-03-18T21:54:54Z" }Para detener el proceso de depuración, presione las teclas Mayús + F5 en Visual Studio Code.
Después de comprobar que la función se ejecuta correctamente en el equipo local es el momento de publicar el proyecto en Azure.
Inicio de sesión en Azure
Para poder crear recursos de Azure o publicar la aplicación, debe iniciar sesión en Azure.
Si aún no ha iniciado sesión, elija el icono de Azure en la barra de actividades. Después, en el área Recursos, elija Iniciar sesión en Azure...
Si ya ha iniciado sesión y puede ver las suscripciones existentes, vaya a la siguiente sección. Si aún no tiene una cuenta de Azure, elija Crear una cuenta de Azure.... Los estudiantes pueden elegir Crear una cuenta de Microsoft Azure for Students....
Cuando se le solicite en el explorador, elija su cuenta de Azure e inicie sesión con las credenciales de la misma. Si opta por crear una cuenta, podrá iniciar sesión una vez que haya completado el proceso de creación.
Cuando haya iniciado sesión correctamente, puede cerrar la nueva ventana del explorador. Las suscripciones que pertenezcan a la cuenta de Azure se mostrarán en la barra lateral.
Cree la aplicación de funciones en Azure
Durante el transcurso de esta sección, podrá crear una aplicación de funciones y los recursos relacionados con esta en la suscripción de Azure.
Seleccione el icono de Azure en la barra de actividades. A continuación, en el área Recursos, seleccione el icono + y elija la opción Crear aplicación de funciones en Azure.
Escriba la siguiente información cuando se le indique:
Prompt Número de selección Seleccionar suscripción elija la suscripción que desee usar. Si solo tiene una suscripción visible en el área Recursos, esta solicitud no se mostrará. Escribir un nombre único global para la aplicación de funciones Escriba un nombre que sea válido en una ruta de acceso de la dirección URL. El nombre que escriba se valida para asegurarse de que es único en Azure Functions. Seleccione una pila en tiempo de ejecución Elija la versión de lenguaje que ha estado ejecutando localmente. Seleccionar una ubicación para los nuevos recursos Para mejorar el rendimiento, elija una región cerca de usted. La extensión mostrará el estado de los recursos individuales en el panel Azure: Registro de actividad a medida que estos se creen.
Cuando se complete el proceso de creación, se crearán los siguientes recursos de Azure en la suscripción. Los recursos se denominarán en función del nombre de la aplicación de funciones:
- Un grupo de recursos, que es un contenedor lógico de recursos relacionados.
- Una cuenta de Azure Storage estándar, que mantiene información de estado y de otro tipo sobre los proyectos.
- Una aplicación de funciones, que proporciona el entorno para ejecutar el código de función. Una aplicación de funciones permite agrupar funciones como una unidad lógica para facilitar la administración, la implementación y el uso compartido de recursos en el mismo plan de hospedaje.
- Un plan de App Service, que define al host subyacente de la aplicación de funciones.
- Una instancia de Application Insights conectada a la aplicación de funciones, que hace un seguimiento del uso de las funciones de la aplicación.
Una vez que se haya creado la aplicación de función se mostrará una notificación y se aplicará el paquete de implementación.
Sugerencia
De forma predeterminada, los recursos de Azure que requiere la aplicación de funciones se crean según el nombre de la aplicación de funciones que proporcione. De forma predeterminada, estos también se crean en el mismo nuevo grupo de recursos que contiene la aplicación de funciones. Si lo que quiere es personalizar los nombres de estos recursos o reutilizar recursos existentes, deberá publicar el proyecto con opciones de creación avanzadas.
Implementar el proyecto en Azure
Importante
Los procesos de implementación en aplicaciones de funciones existentes siempre sobrescriben el contenido de esas aplicaciones en Azure.
En el área Recursos de la actividad de Azure, busque el recurso de la aplicación de funciones que acaba de crear, haga clic con el botón derecho en el recurso y seleccione Implementar en la aplicación de funciones....
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.
Cuando se complete el proceso de implementación, seleccione Ver salida para visualizar los resultados de la creación y la implementación, incluidos los recursos de Azure que ha creado. Si se pierde la notificación, seleccione el icono de campana en la esquina inferior derecha para verlo de nuevo.
Prueba de una función en Azure
Copie la dirección URL del desencadenador HTTP del panel Salida. La URL que llama a la función desencadenada mediante HTTP debe tener el siguiente formato:
https://<functionappname>.azurewebsites.net/api/HelloOrchestration_HttpStartPegue la dirección URL de la solicitud HTTP en la barra de direcciones del explorador. Cuando use la aplicación publicada, deberá obtener la misma respuesta de estado que obtuvo antes.
Pasos siguientes
Ha usado Visual Studio Code para crear y publicar una aplicación de función perdurable con C#.
En este artículo, aprenderá a usar Visual Studio 2022 con el fin de crear y probar localmente una función durable "Hola mundo". Esta función organiza y encadena llamadas a otras funciones. Luego, publicará el código de función en Azure. Estas herramientas están disponibles como parte de la carga de trabajo de desarrollo de Azure en Visual Studio 2022.
Requisitos previos
Para completar este tutorial:
Instale Visual Studio 2022. Asegúrese de que la carga de trabajo de Desarrollo de Azure también está instalada. Visual Studio 2019 también admite el desarrollo de Durable Functions, pero la interfaz de usuario y los pasos son distintos.
Compruebe que el Emulador de Azurite está instalado y ejecutándose.
Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
Creación de un proyecto de aplicación de función
La plantilla de Azure Functions crea un proyecto que se puede publicar en una aplicación de función en Azure. Una aplicación de función permite agrupar funciones como una unidad lógica para facilitar la administración, la implementación, el escalado y el uso compartido de recursos.
En Visual Studio, seleccione Nuevo>proyecto en el menú Archivo.
En el cuadro de diálogo Crear un proyecto, busque
functions. A continuación, elija la plantilla de Azure Functions y seleccione Siguiente.
Introduzca un Nombre de proyecto y seleccione el botón Aceptar. El nombre de proyecto debe ser válido como espacio de nombres de C#, por lo que no deberá usar guiones bajos, guiones o caracteres no alfanuméricos.
En Información adicional, use la configuración especificada en la tabla que aparece después de la imagen.
Configuración Valor sugerido Descripción Trabajo de Functions .NET 6 Crea un proyecto de función que admite .NET 6 y Azure Functions Runtime 4.0. Para más información, consulte Cómo seleccionar un destino para versiones en tiempo de ejecución de Azure Functions. Function Vacío De esta forma se crea una aplicación de función vacía. Cuenta de almacenamiento Emulador de Storage Es necesaria una cuenta de almacenamiento para la administración del estado de función durable. Haga clic en Crear para crear un proyecto de función vacío. Este proyecto tiene los archivos de configuración básica necesarios para ejecutar las funciones.
Incorporación de funciones a la aplicación
En los pasos siguientes se usa una plantilla para crear el código de Durable Functions en el proyecto.
Haga clic con el botón derecho en el proyecto en Visual Studio y seleccione Agregar>Nueva función de Azure.
Compruebe que el elemento Función de Azure esté seleccionado en el menú Agregar. Después, escriba un nombre para el archivo C# y seleccione el botón Agregar.
Seleccione la plantilla Orquestación de Durable Functions y seleccione Agregar.
Una nueva función Durable Functions se agregará a la aplicación. Abra el nuevo archivo .cs para visualizar su contenido. Esta función Durable Functions es un ejemplo de una función sencilla de encadenamiento con los métodos siguientes:
| Método | FunctionName | Descripción |
|---|---|---|
RunOrchestrator |
<file-name> |
Administra la orquestación de Durable Functions. En este caso, la orquestación se inicia, crea una lista y le agrega el resultado de tres llamadas a funciones. Una vez completadas las tres llamadas a funciones, devuelve la lista. |
SayHello |
<file-name>_Hello |
Por ejemplo, la función devuelve un saludo. Esta es la función que contiene la lógica de negocios que se va a organizar. |
HttpStart |
<file-name>_HttpStart |
Una función desencadenada por HTTP que inicia una instancia de la orquestación y devuelve una respuesta de comprobación de estado. |
Ahora que ha creado un proyecto de función y una función duradera, puede probarla en el equipo local.
Prueba local de la función
Azure Functions Core Tools le permite ejecutar un proyecto de Azure Functions en el equipo de desarrollo local. La primera vez que inicie una función desde Visual Studio Code se le solicitará que instale estas herramientas.
Para probar la función, presione F5. Si se le solicita, acepte la solicitud de Visual Studio para descargar e instalar las herramientas de Azure Functions Core (CLI). También es preciso que habilite una excepción de firewall para que las herramientas para controlen las solicitudes de HTTP.
Copie la dirección URL de la función de los resultados del runtime de Azure Functions.
Pegue la dirección URL de la solicitud HTTP en la barra de direcciones del explorador y ejecútela. A continuación se muestra la respuesta en el explorador para la solicitud GET local devuelta por la función:
La respuesta que obtendrá será el resultado inicial de la función HTTP, que nos informa de que la orquestación duradera se ha iniciado correctamente. No obstante, este no es el resultado final de la tarea de orquestación. La respuesta incluye algunas direcciones URL útiles. De momento, vamos a consultar el estado de la orquestación.
Copie el valor de la URL que corresponde a
statusQueryGetUri, péguelo en la barra de direcciones del explorador y ejecute la solicitud.La solicitud consultará la instancia de orquestación sobre el estado. Después de un tiempo, debe obtener una respuesta similar a la siguiente. Esta salida nos muestra que la instancia se ha completado e incluye las salidas o resultados de la función duradera.
{ "name": "Durable", "instanceId": "d495cb0ac10d4e13b22729c37e335190", "runtimeStatus": "Completed", "input": null, "customStatus": null, "output": [ "Hello Tokyo!", "Hello Seattle!", "Hello London!" ], "createdTime": "2019-11-02T07:07:40Z", "lastUpdatedTime": "2019-11-02T07:07:52Z" }Para detener la depuración, presione Mayús + F5.
Después de comprobar que la función se ejecuta correctamente en el equipo local es el momento de publicar el proyecto en Azure.
Publicar el proyecto en Azure
Para publicar el proyecto, deberá tener una aplicación de funciones ubicada en la suscripción de Azure. Las aplicaciones de función se pueden crear directamente desde Visual Studio.
En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Publicar. En Destino, seleccione Azure y, luego, Siguiente.
Seleccione la opción Aplicación de funciones de Azure (Windows) en la pestaña Destino específico. Esta opción creará una aplicación de funciones que se ejecutará en Windows. Después, seleccione el botón Siguiente.
En Instancia de la función, seleccione Crear una aplicación de Azure Functions...
Crear una nueva instancia con los valores especificados en la tabla siguiente:
Configuración valor Descripción Nombre Nombre único globalmente Nombre que identifica de forma única la nueva aplicación de función. Acepte este nombre o escriba uno nuevo. Los caracteres válidos son a-z,0-9y-.Suscripción Su suscripción La suscripción de Azure que se va a usar. Acepte esta suscripción o seleccione una nueva en la lista desplegable. Grupo de recursos Nombre del grupo de recursos Nombre del grupo de recursos en el que quiere crear la aplicación de funciones. Seleccione Nuevo para crear un nuevo grupo de recursos. También puede elegir un grupo de recursos existente en la lista desplegable. Tipo de plan Consumo Cuando publique el proyecto en una aplicación de funciones que se ejecute en un plan Consumo, solo pagará por las ejecuciones de la aplicación. Otros planes de hospedaje suponen costos más elevados. Ubicación Ubicación de la instancia de App Service Elija una ubicación en una región próxima a usted o a otros servicios a los que las funciones accedan. Azure Storage Cuenta de almacenamiento de uso general El runtime de Functions necesita una cuenta de almacenamiento de Azure. Seleccione Nueva para configurar una cuenta de almacenamiento de uso general. También puede elegir una cuenta existente que cumpla los requisitos de la cuenta de almacenamiento. Application Insights Instancia de Application Insights Debe habilitar la integración de Application Insights para la aplicación de funciones. Seleccione Nuevo para crear una nueva instancia, ya sea en un área de trabajo de Log Analytics nueva o en una existente. También puede elegir una cuenta existente. 
Seleccione Crear para crear una aplicación de funciones y sus recursos relacionados en Azure. El estado de la creación del recurso se muestra en la parte inferior izquierda de la ventana.
En la instancia de Functions, asegúrese de que Ejecutar desde el archivo de paquete esté activado. La aplicación de funciones se implementa con la implementación de un archivo zip y con el modo de ejecución desde el paquete habilitado. La implementación de archivo ZIP es el método de implementación recomendado para el proyecto de Functions, ya que se obtiene un mejor rendimiento.
Seleccione Finalizary, en la página Publicar, seleccione Publicar para implementar el paquete que contiene los archivos de proyecto en la nueva aplicación de funciones en Azure.
Una vez finalizada la implementación, en la pestaña Publicar aparecerá la dirección URL raíz de la aplicación de funciones de Azure.
En la pestaña Publicar, en la sección Hospedaje, elija Abrir en Azure Portal. Esto abre el recurso de Azure de aplicación de funciones nuevo en Azure Portal.
Prueba de una función en Azure
Copie la URL base de la aplicación de función de la página de perfil de publicación. Reemplace la parte
localhost:portde la dirección URL que usó al probar la función localmente por la nueva URL base.La URL que llama al desencadenador HTTP de la función duradera deberá tener el siguiente formato:
https://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>_HttpStartPegue la dirección URL de la solicitud HTTP en la barra de direcciones del explorador. Cuando use la aplicación publicada, deberá obtener la misma respuesta de estado que obtuvo antes.
Pasos siguientes
Ha usado Visual Studio para crear y publicar una aplicación de función durable con C#.