Compartir a través de

Inicio rápido: Creación de una aplicación de Durable Functions de PowerShell

Use Durable Functions, una característica de Azure Functions, para escribir funciones con estado en un entorno sin servidor. Para instalar Durable Functions, instale la Extensión de Azure Functions en Visual Studio Code. La extensión administra el estado, los puntos de control y los reinicios en la aplicación.

En este inicio rápido, usará la extensión Durable Functions en Visual Studio Code para crear y probar localmente una aplicación durable Functions "hola mundo" en Azure Functions. La aplicación Durable Functions organiza y encadena llamadas a otras funciones. A continuación, publicará el código de función en Azure. Las herramientas que usa están disponibles a través de la extensión de Visual Studio Code.

Ejecución de una aplicación de Durable Functions en Azure.

Requisitos previos

Para completar este inicio rápido necesita instalar:

Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.

Creación del proyecto local

En esta sección se usa Visual Studio Code para crear un proyecto local en Azure Functions.

  1. En Visual Studio Code, seleccione F1 (o presione Ctrl/Cmd+Mayús+P) para abrir la paleta de comandos. En el símbolo del sistema (>), escriba y seleccione Azure Functions: Crear nuevo proyecto.

    Recorte de pantalla que muestra el comando Crear una función.

  2. Haga clic en Examinar. En el cuadro de diálogo Seleccionar carpeta , vaya a una carpeta que se usará para el proyecto y, a continuación, elija Seleccionar.

  3. Escriba la siguiente información cuando se le indique:

    Pronto Acción Descripción
    Seleccionar un lenguaje para el proyecto de aplicación de funciones Seleccione PowerShell. Crea un proyecto local de Funciones de PowerShell.
    Seleccionar una versión Seleccione Azure Functions v4. Solo verá esta opción cuando Core Tools aún no está instalado. En este caso, Core Tools se instala la primera vez que ejecuta la aplicación.
    Seleccione una plantilla para la primera función del proyecto Seleccione Omitir por ahora.
    Seleccionar cómo desea abrir el proyecto Seleccione Abrir en la ventana actual. Abre Visual Studio Code en la carpeta seleccionada.

Visual Studio Code instala Azure Functions Core Tools si es necesario crear un proyecto. 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.

También se crea un archivo package.json en la carpeta raíz.

Configuración de la aplicación de funciones para usar PowerShell 7.4 y el SDK independiente de Durable Functions

Abra el archivo local.settings.json y confirme que una configuración denominada FUNCTIONS_WORKER_RUNTIME_VERSION está establecida en 7.4 y que una configuración denominada ExternalDurablePowerShellSDK está establecida en true. Si faltan o si se establecen en otros valores, actualice el contenido del archivo.

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "powershell",
    "FUNCTIONS_WORKER_RUNTIME_VERSION" : "7.4",
    "ExternalDurablePowerShellSDK": "true"
  }
}

A continuación, especifique una entrada para el SDK DF en requirements.psd1 el archivo, como en el ejemplo siguiente:

# This file enables modules to be automatically managed by the Functions service.
# See https://aka.ms/functionsmanageddependency for additional information.
#
@{
    # For latest supported version, go to 'https://www.powershellgallery.com/packages/AzureFunctions.PowerShell.Durable.SDK/'.
    'AzureFunctions.PowerShell.Durable.SDK' = '2.*'
}

Asegúrese de usar la versión más reciente del módulo AzureFunctions.PowerShell.Durable.SDK . El 2.* especificador de versión garantiza que obtiene la versión estable 2.x más reciente.

Agregue la siguiente línea al profile.ps1 archivo (normalmente, al final del archivo):

Import-Module AzureFunctions.PowerShell.Durable.SDK -ErrorAction Stop

Creación de las funciones

La aplicación Durable Functions más básica tiene tres funciones:

  • Función de Orchestrator: flujo de trabajo que organiza otras funciones.
  • Función Actividad: una función a la que llama la función de orquestador, realiza el trabajo y, opcionalmente, devuelve un valor.
  • Función cliente: una función normal en Azure que inicia una función de orquestador. En este ejemplo se usa una función desencadenada por HTTP.

Función de orquestador

Use una plantilla para crear el código de aplicación de Durable Functions en el proyecto.

  1. En la paleta de comandos, escriba y seleccione Azure Functions: Create Function.

  2. Escriba la siguiente información cuando se le indique:

    Pronto Acción Descripción
    Seleccione una plantilla para la función Escriba orquestador de Durable Functions. Crea una orquestación de aplicaciones de Durable Functions.
    Proporcionar un nombre de función Escriba HelloOrchestrator. Nombre de la función durable.

Ha agregado un orquestador para coordinar las funciones de actividad. Open HelloOrchestrator/run.ps1 para ver la función del orquestador. Cada llamada al cmdlet Invoke-ActivityFunction invoca una función de actividad denominada Hello.

A continuación, agregue la función de actividad Hello a la que se hace referencia.

Función de actividad

  1. En la paleta de comandos, escriba y seleccione Azure Functions: Create Function.

  2. Escriba la siguiente información cuando se le indique:

    Pronto Acción Descripción
    Seleccione una plantilla para la función Seleccione Actividad de Durable Functions. Crea una función de actividad.
    Proporcionar un nombre de función Escriba Hello. Nombre de la función de actividad.

Ha agregado la función de actividad Hello invocada por el orquestador. Abra Hello/run.ps1 para comprobar que toma un nombre como entrada y devuelve un saludo. Una función de actividad es donde se realizan acciones como realizar una llamada a una base de datos o realizar un cálculo.

Por último, agregue una función desencadenada por HTTP que inicie la orquestación.

Función de cliente (inicio de HTTP)

  1. En la paleta de comandos, escriba y seleccione Azure Functions: Create Function.

  2. Escriba la siguiente información cuando se le indique:

    Pronto Acción Descripción
    Seleccione una plantilla para la función Seleccione Inicio HTTP de Durable Functions. Crea una función de inicio HTTP.
    Proporcionar un nombre de función Escriba HttpStart. Nombre de la función de actividad.
    Nivel de autorización Seleccione Anónimo. Con fines de demostración, este valor permite llamar a la función sin usar la autenticación.

Ha agregado una función desencadenada por HTTP que inicia una orquestación. Abra httpStart/run.ps1 para comprobar que usa el cmdlet Start-NewOrchestration para iniciar una nueva orquestación. A continuación, usa el cmdlet New-OrchestrationCheckStatusResponse para devolver una respuesta HTTP que contiene direcciones URL que se pueden usar para supervisar y administrar la nueva orquestación.

Ahora tiene una aplicación de Durable Functions que puede ejecutar localmente e implementar en Azure.

Sugerencia

En esta guía rápida se utiliza el SDK independiente de PowerShell de Durable Functions, que ahora está disponible de forma general y ofrece el mejor rendimiento y las características más recientes. Para obtener más información sobre el SDK y la migración desde la versión integrada heredada, consulte la guía del SDK de PowerShell independiente.

Prueba local de la función

Azure Functions Core Tools ofrece la capacidad de ejecutar un proyecto de Azure Functions en el equipo de desarrollo local. Se le pedirá que instale estas herramientas la primera vez que inicie una función en Visual Studio.

  1. Para probar la función, establezca un punto de interrupción en el código de función de actividad de Hello (en Hello/run.ps1). Seleccione F5 o seleccione Depurar: Iniciar depuración en la paleta de comandos para iniciar el proyecto de aplicación de funciones. La salida de Core Tools aparece en el panel del terminal.

    Nota:

    Para obtener más información sobre la depuración, consulte Diagnósticos de Durable Functions.

  2. Durable Functions requiere que se ejecute una cuenta de Almacenamiento de Azure. Cuando Visual Studio Code le pida que seleccione una cuenta de almacenamiento, seleccione Seleccionar cuenta de almacenamiento.

    Recorte de pantalla que muestra el comando Crear cuenta de almacenamiento.

  3. En las indicaciones, proporcione la siguiente información para crear una nueva cuenta de almacenamiento en Azure.

    Pronto Acción Descripción
    Selección de la suscripción Seleccione el nombre de la suscripción. Su suscripción de Azure.
    Seleccione una cuenta de almacenamiento Seleccione Crear una nueva cuenta de almacenamiento.
    Escriba el nombre de la nueva cuenta de almacenamiento Escriba un nombre único. Nombre de la cuenta de almacenamiento que se creará.
    Seleccionar un grupo de recursos Escriba un nombre único. Nombre del grupo de recursos que se va a crear.
    Seleccionar una ubicación Seleccione una región de Azure. Seleccione una región cercana a usted.

  4. En el panel terminal, copie el punto de conexión de la dirección URL de la función desencadenada por HTTP.

    Captura de pantalla de la salida local de Azure.

  5. Use su navegador o una herramienta de prueba HTTP para enviar una solicitud HTTP POST al punto de conexión de la dirección URL.

    Reemplace el último segmento por el nombre de la función de orquestador (HelloOrchestrator). La dirección URL debe ser similar a http://localhost:7071/api/orchestrators/HelloOrchestrator.

    La respuesta es el resultado inicial de la función HTTP. Le permite saber que la orquestación duradera se inició correctamente. Todavía no muestra el resultado final de la orquestación. La respuesta incluye algunas direcciones URL útiles. Por ahora, consulte el estado de la orquestación.

  6. Copie el valor de la URL que corresponde a statusQueryGetUri, péguelo en la barra de direcciones del explorador y ejecute la solicitud. También puede seguir usando la herramienta de prueba HTTP para emitir la solicitud GET.

    La solicitud consultará la instancia de orquestación sobre el estado. Debe obtener una respuesta final, que muestra la instancia completada e incluye las salidas o los resultados de la función durable. Parece este ejemplo:

    {
    "name": "HelloOrchestrator",
    "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"
}

  7. Para detener la depuración, en Visual Studio Code, seleccione 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.

Inicio de sesión en Azure

Para poder crear recursos de Azure o publicar la aplicación, debe iniciar sesión en Azure.

  1. Si aún no ha iniciado sesión, en la barra de actividad, seleccione el icono de Azure. A continuación, en Recursos, seleccione Iniciar sesión en Azure.

    Captura de pantalla de la ventana de inicio de sesión en Azure en Visual Studio Code.

    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, seleccione Crear una cuenta de Azure. Los alumnos pueden seleccionar Crear una cuenta de Azure for Students.

  2. Cuando se le solicite en el explorador, seleccione su cuenta de Azure e inicie sesión con las credenciales de la cuenta de Azure. Si opta por crear una cuenta, podrá iniciar sesión una vez que haya completado el proceso de creación.

  3. Después de iniciar sesión correctamente, puede cerrar la nueva ventana del explorador. Las suscripciones que pertenecen a su cuenta de Azure se muestran en la barra lateral.

Cree la aplicación de funciones en Azure

En esta sección, creará una aplicación de funciones en el plan de Consumo flexible junto con los recursos relacionados de la suscripción de Azure. Muchas de las decisiones de creación de recursos se toman en función de los comportamientos predeterminados. Para obtener más control sobre los recursos creados, en su lugar debe crear la aplicación de funciones con opciones avanzadas.

  1. En Visual Studio Code, seleccione F1 para abrir la paleta de comandos. En el símbolo del sistema (>), escriba y seleccione Azure Functions: Crear aplicación de funciones en Azure.

  2. Escriba la siguiente información cuando se le indique:

    Pronto Acción
    Selección de la suscripción Seleccione la suscripción de Azure que se va a usar. El símbolo del sistema no aparece cuando solo tiene una suscripción visible en Recursos.
    Escriba un nuevo nombre de aplicación de funciones. Escriba un nombre único global que sea válido en una ruta de acceso URL. El nombre que escriba se valida para asegurarse de que es único en Azure Functions.
    Seleccionar una ubicación para los nuevos recursos Seleccione una región de Azure. Para mejorar el rendimiento, seleccione una región cerca de usted. Solo se muestran las regiones admitidas por los planes de consumo flexible.
    Seleccione una pila en tiempo de ejecución Seleccione la versión de idioma que se ejecuta actualmente localmente.
    Selección del tipo de autenticación de recursos Seleccione Identidad administrada, que es la opción más segura para conectarse a la cuenta de almacenamiento de host predeterminada.

    En el panel Azure: Registro de actividad, la extensión de Azure muestra el estado de los recursos individuales a medida que se crean en Azure.

    Captura de pantalla que muestra el registro de creación de recursos de Azure.

  3. Cuando se crea la aplicación de funciones, se crean los siguientes recursos relacionados en la suscripción de Azure. Los recursos se denominan en función del nombre especificado para la aplicación de funciones.

    • Un grupo de recursos, que es un contenedor lógico de recursos relacionados.
    • 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 Azure App Service, que define el host subyacente para la aplicación de funciones.
    • Una cuenta de Azure Storage estándar que usa el host de Functions para mantener el estado y otra información sobre tu aplicación de funciones.
    • Una instancia de Application Insights conectada a la aplicación de funciones y que realiza un seguimiento del uso de las funciones en la aplicación.
    • Una identidad administrada asignada por el usuario que se agrega al rol Colaborador de datos de Storage Blob en la nueva cuenta de almacenamiento de host predeterminada.

    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 necesarios para la aplicación de funciones se crean según el nombre que escriba para la aplicación de funciones. De manera predeterminada, los recursos se crean con la aplicación de funciones en el mismo grupo de recursos nuevo. Si desea personalizar los nombres de los recursos asociados o reutilizar los recursos existentes, publique 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.

  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.

    Recorte de pantalla de la ventana Ver salida.

Prueba de una función en Azure

  1. Asegúrese de que la configuración de la aplicación llamada ExternalDurablePowerShellSDK esté definida como true.

  2. Copie la dirección URL del desencadenador HTTP en el panel de salida. La dirección URL que llama a la función desencadenada por HTTP debe tener este formato:

    https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

  3. Pegue la nueva URL de la solicitud HTTP en la barra de direcciones del explorador. Al usar la aplicación publicada, puede esperar obtener la misma respuesta de estado que obtuvo al probar localmente.

La aplicación Durable Functions de PowerShell que creó y publicó mediante Visual Studio Code está lista para usarse.

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.

Contenido relacionado

  • Last updated on