Creación de un flujo de trabajo con Workflow Studio en Step Functions - AWS Step Functions

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación de un flujo de trabajo con Workflow Studio en Step Functions

Aprenda a crear, editar y ejecutar flujos de trabajo con Step Functions Workflow Studio. Una vez que el flujo de trabajo esté listo, puede guardarlo, ejecutarlo y exportarlo.

Creación de una máquina de estado

En Workflow Studio, puede elegir una plantilla inicial o una plantilla en blanco para crear un flujo de trabajo.

Una plantilla de inicio es un proyecto de ready-to-run ejemplo que crea automáticamente el prototipo y la definición del flujo de trabajo y despliega todos los AWS recursos relacionados que el proyecto necesite. Cuenta de AWS Puede usar estas plantillas de inicio para implementarlas y ejecutarlas tal cual, o bien usar los prototipos de flujo de trabajo para desarrollarlas a partir de ellos. Para obtener más información acerca de las plantillas de inicio, consulte Implemente una máquina de estados mediante una plantilla de inicio para Step Functions.

Con una plantilla en blanco, utilizas el modo Diseño o Código para crear tu flujo de trabajo personalizado.

Cree una máquina de estados con una plantilla de inicio

  1. Abra la consola de Step Functions y seleccione Crear máquina de estado.

  2. En el cuadro de diálogo Elija una plantilla, realice una de las siguientes acciones para elegir un proyecto de ejemplo:

    • Escriba Task Timer en el cuadro Buscar por palabra clave y, a continuación, seleccione Task Timer en los resultados de la búsqueda.

    • Examine los proyectos de muestra que aparecen en Todos en el panel derecho y, a continuación, seleccione Temporizador de tareas.

  3. Elija Siguiente para continuar.

  4. Step Functions muestra una lista de las Servicios de AWS utilizadas en el proyecto de muestra que ha seleccionado. También muestra un gráfico del flujo de trabajo para el proyecto de muestra. Implemente este proyecto en su empresa Cuenta de AWS o utilícelo como punto de partida para crear sus propios proyectos. En función de cómo desee continuar, elija Ejecutar una demostración o Crear a partir de ella.

  5. Elija Utilizar plantilla para continuar con la selección.

  6. Realice una de las siguientes acciones siguientes:

    • Si seleccionó Construir a partir de él, Step Functions crea el prototipo de flujo de trabajo, pero no despliega los recursos de la definición del flujo de trabajo, por lo que puede seguir creando su prototipo de flujo de trabajo.

      En Workflow StudioModo Diseño, puedes añadir estados adicionales a tu prototipo de flujo de trabajo. O bien, puede cambiar Modo Código al editor de código integrado para editar la definición Amazon States Language (ASL) de su máquina de estados desde la consola Step Functions.

      importante

      Es posible que tengas que actualizar el marcador de posición Amazon Resource Name (ARN) para los recursos utilizados en el proyecto de ejemplo antes de poder ejecutar tu flujo de trabajo.

    • Si seleccionó Ejecutar una demostración, Step Functions crea un proyecto de solo lectura que utiliza una AWS CloudFormation plantilla para implementar los AWS recursos de esa plantilla en su empresa. Cuenta de AWS Puede ver la definición de la máquina de estados seleccionando el modo Código.

      Elija Implementar y ejecutar para implementar el proyecto y crear los recursos.

      Tenga en cuenta que la implementación puede tardar hasta 10 minutos en crearse IAM los recursos y los permisos. Mientras se despliegan tus recursos, puedes abrir el enlace AWS CloudFormation Stack ID para ver qué recursos se están aprovisionando.

      Una vez creados todos los recursos, deberías ver el proyecto en la página State Machines de la consola.

      importante

      Se pueden aplicar cargos estándar por cada servicio utilizado en la CloudFormation plantilla.

Crear un flujo de trabajo con una plantilla en blanco

Cuando quieras empezar desde un lienzo limpio, crea un flujo de trabajo a partir de la plantilla en blanco.

  1. Abra la consola de Step Functions.

  2. Elija Crear máquina de estado.

  3. En el cuadro de diálogo Elegir una plantilla, seleccione En blanco.

  4. Elija Seleccionar para abrir Workflow StudioModo Diseño.

    Ahora puede empezar a diseñar su flujo de trabajo en Modo Diseño o escribir su definición de flujo de trabajo en Modo Código.

  5. Seleccione Config para administrar la configuración de su flujo de trabajo en el Modo Config. Por ejemplo, proporcione un nombre para su flujo de trabajo y seleccione su tipo.

Diseñar un flujo de trabajo

Cuando sepa el nombre del estado que quiere añadir, utilice el cuadro de búsqueda situado en la parte superior Navegador de estados para encontrarlo. De lo contrario, busca el estado que necesitas en el navegador y agrégalo al lienzo.

Puede reordenar los estados de su flujo de trabajo arrastrándolos a una ubicación diferente del flujo de trabajo. Al arrastrar un estado al lienzo, aparece una línea que indica dónde se insertará el estado en el flujo de trabajo, como se muestra en la siguiente captura de pantalla:

Captura de pantalla ilustrativa que muestra la línea azul que indica el destino de un estado.

Después de colocar un estado en el lienzo, su código se genera automáticamente y se agrega dentro de la definición del flujo de trabajo. Para ver la definición, active el botón Definición en el panel Inspector. Puede optar por Modo Código editar la definición con el editor de código integrado.

Después de colocar un estado en el lienzo, puede configurarlo en el panel Panel de inspectores de la derecha. Este panel contiene las pestañas Configuración, Entrada, Salida y Gestión de errores para cada estado o API acción que coloque en el lienzo. En la pestaña Configuración se configuran los estados que se incluyen en los flujos de trabajo.

Por ejemplo, la pestaña Configuración de la API acción Invoke de Lambda ofrece las siguientes opciones:

  • Nombre del estado: puede identificar el estado con un nombre personalizado o aceptar el nombre generado por defecto.

  • APImuestra qué API acción utiliza el estado.

  • Tipo de integración: puede elegir el tipo de integración de servicios que se utiliza para llamar a API acciones en otros servicios.

  • El nombre de la función proporciona opciones para:

    • Introduzca un nombre de función: puede introducir el nombre de su función o el suyoARN.

    • Obtener el nombre de una función en tiempo de ejecución a partir de la entrada de estado: puede usar esta opción para obtener dinámicamente el nombre de la función a partir de la entrada de estado en función de la ruta que especifique.

    • Seleccionar el nombre de una función: puede seleccionar directamente entre las funciones disponibles en su cuenta y región.

  • Carga útil: puede elegir usar la entrada de estado, un JSON objeto o ninguna carga útil para pasarla como carga útil a su función Lambda. Si lo deseaJSON, puede incluir tanto valores estáticos como valores seleccionados en la entrada de estado.

  • (Opcional) Algunos estados tendrán la opción de seleccionar Esperar a que se complete la tarea o Espere la devolución de la llamada. Cuando esté disponible, puede elegir uno de los siguientes patrones de integración de servicios:

    • No se ha seleccionado ninguna opción: Step Functions usará el patrón de integración Respuesta de la solicitud. Step Functions esperará una HTTP respuesta y, a continuación, pasará al siguiente estado. Step Functions no esperará a que se complete un trabajo. Cuando no haya opciones disponibles, el estado utilizará este patrón.

    • Esperar a que se complete la tarea: Step Functions utilizará el patrón de integración Ejecutar un trabajo (.sync).

    • Esperar la devolución de la llamada: Step Functions utilizará el patrón de integración Cómo esperar una devolución de llamada con el token de tarea.

  • (Opcional) Para acceder a los recursos configurados de forma diferente Cuentas de AWS dentro de sus flujos de trabajo, Step Functions ofrece acceso multicuenta. IAMLa función de acceso multicuenta ofrece opciones para:

    • Proporcionar IAM un rol ARN: especifique el IAM rol que contiene los permisos de acceso a los recursos adecuados. Estos recursos están disponibles en una cuenta de destino, que es una cuenta Cuenta de AWS a la que se pueden realizar llamadas entre cuentas.

    • Obtener ARN el IAM rol en tiempo de ejecución a partir de la entrada de estado: especifique una ruta de referencia a un par clave-valor existente en la JSON entrada del estado que contiene el rol. IAM

  • El estado siguiente le permite seleccionar el estado al que desea pasar a continuación.

  • (Opcional) El campo de comentarios no afectará al flujo de trabajo, pero puede usarlo para anotar su flujo de trabajo.

Algunos estados tendrán opciones de configuración genéricas adicionales. Por ejemplo, la configuración del ECS RunTask estado de Amazon contiene un API Parameters campo que se rellena con valores de marcador de posición. Para estos estados, puede reemplazar los valores de los marcadores de posición por configuraciones que se adapten a sus necesidades.

Para eliminar un estado

Puede pulsar la tecla de retroceso, hacer clic con el botón derecho del ratón y seleccionar Eliminar estado o bien elegir Eliminar en la barra de herramientas de diseño.

Ejecutar el flujo de trabajo

Cuando el flujo de trabajo esté listo para funcionar, puede ejecutarlo y ver su ejecución desde la consola Step Functions.

Para ejecutar un flujo de trabajo en Workflow Studio
  1. En los modos Diseño, Código o Config, elija Ejecutar.

    Se abre el cuadro de diálogo Iniciar ejecución en una pestaña nueva.

  2. En el cuadro de diálogo Iniciar ejecución, haga lo siguiente:

    1. (Opcional) Para identificar la ejecución, puede especificar un nombre o utilizar el nombre de ejecución generado por defecto.

      nota

      Step Functions acepta nombres para máquinas de estados, ejecuciones, actividades y etiquetas que no contengan ASCII caracteres. Como los nombres que no contengan ASCII caracteres no funcionan en Amazon CloudWatch, te recomendamos que utilices solo ASCII caracteres para poder realizar un seguimiento de las métricas. CloudWatch

    2. (Opcional) En el cuadro de entrada, introduce los valores de entrada en el JSON formato adecuado para ejecutar tu flujo de trabajo.

    3. Seleccione Iniciar ejecución.

    4. La consola de Step Functions le dirige a una página cuyo título es su ID de ejecución. Esta página se conoce como Detalles de la ejecución. En esta página, puede revisar los resultados de la ejecución a medida que avanza la ejecución o una vez finalizada.

      Para revisar los resultados de la ejecución, elija los estados individuales en la Vista de gráfico y, a continuación, elija las pestañas individuales del panel Detalles del paso para ver los detalles de cada estado, incluidas la entrada, la salida y la definición, respectivamente. Para obtener más información sobre la ejecución que puede ver en la página Detalles de la ejecución, consulte Página de detalles de ejecución: información general de la interfaz.

Editar el flujo de trabajo

Puede editar visualmente un flujo de trabajo existente en el Modo Diseño de Workflow Studio.

En la consola Step Functions, elija el flujo de trabajo que desee editar en la página Máquinas de estado. El flujo de trabajo se abre en el modo Diseño de Workflow Studio.

También puede editar la definición del flujo de trabajo enModo Código. Pulse el botón Código para ver o editar la definición del flujo de trabajo en Workflow Studio.

nota

Si se observan errores en el flujo de trabajo, deben corregirse en el modo Diseño. No se puede cambiar al modo Código o Config si hay algún error en el flujo de trabajo.

Exportar el flujo de trabajo

Puede exportar la definición de su flujo de trabajo Amazon States Language (ASL) y su gráfico de flujo de trabajo:

  1. Elija su flujo de trabajo en la consola de Step Functions.

  2. En la página Detalle de la máquina de estado, elija Editar.

  3. Elija el botón desplegable Acciones y luego realice una o ambas de las siguientes acciones:

    • Para exportar el gráfico del flujo de trabajo a un PNG archivo SVG o, en Exportar gráfico, selecciona el formato que desees.

    • Para exportar la definición del flujo de trabajo como un YAML archivo JSON o archivo, en Exportar definición, seleccione el formato que desee.

Crear un prototipo de flujo de trabajo con marcadores de posición

Puede usar Workflow Studio o Workflow Studio Application Composer para crear prototipos de nuevos flujos de trabajo que contengan recursos marcadores de posición denominados recursos que aún no existen.

Para crear un prototipo de flujo de trabajo:

  1. Inicie sesión en la consola de Step Functions.

  2. Elija Crear máquina de estado.

  3. En el cuadro de diálogo Elegir una plantilla, seleccione En blanco.

  4. Elija Seleccionar para abrir Workflow StudioModo Diseño.

  5. Se abre el modo Diseño de Workflow Studio. Diseñe su flujo de trabajo en Workflow Studio. Para incluir recursos de marcadores de posición:

    1. Elija el estado para el que desea incluir un recurso de marcador de posición y, a continuación, en Configuración:

      • Para los estados Lambda Invoke, seleccione Nombre de función y luego Introducir nombre de función. También puede introducir un nombre personalizado para la función.

      • Para los estados de Amazon SQS Send Message, selecciona Cola y, a continuaciónURL, selecciona Introducir cola URL. Introduce una cola de marcadores de posición. URL

      • Para los estados de Amazon SNS Publish, selecciona un tema en TemaARN.

      • Para el resto de estados que aparecen en Acciones, puede usar la configuración predeterminada.

      nota

      Si se observan errores en el flujo de trabajo, deben corregirse en el modo Diseño. No se puede cambiar al modo Código o Config si hay algún error en el flujo de trabajo.

    2. (Opcional) Para ver la ASL definición generada automáticamente de su flujo de trabajo, elija Definición.

    3. (Opcional) Para actualizar la definición del flujo de trabajo en Workflow Studio, pulse el botón Código.

      nota

      Si se observan errores en la definición del flujo de trabajo, deben corregirse en el modo Código. No se puede cambiar al modo Código o Config si hay algún error en la definición del flujo de trabajo.

  6. (Opcional) Para editar el nombre de la máquina de estado, seleccione el icono de edición situado junto al nombre de la máquina de estado predeterminado de MyStateMachiney especifique un nombre en el cuadro Nombre de la máquina de estado.

    También puede cambiar al Modo Config para editar el nombre predeterminado de la máquina de estado.

  7. Especifique la configuración del flujo de trabajo, como el tipo de máquina de estado y su función de ejecución.

  8. Seleccione Crear.

Ya ha creado un nuevo flujo de trabajo con recursos de marcadores de posición que se pueden utilizar para crear prototipos. Puede exportar la definición y gráfico de su flujo de trabajo.

  • Para exportar la definición del flujo de trabajo como un YAML archivo JSON o archivo, en el modo Diseño o Código, pulse el botón desplegable Acciones. A continuación, en Exportar definición, seleccione el formato que desee exportar. Puede utilizar esta definición exportada como punto de partida para el desarrollo local con el AWS Toolkit for Visual Studio Code.

  • Para exportar el gráfico de flujo de trabajo a un PNG archivo SVG o, en el modo Diseño o Código, selecciona el botón desplegable Acciones. A continuación, en Exportar definición, seleccione el formato que dese.