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.
En este tema
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
-
Abra la consola de Step Functions
y seleccione Crear máquina de estado. -
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.
-
-
Elija Siguiente para continuar.
-
Seleccione Ejecutar una demostración para crear un ready-to-deploy flujo de trabajo y de solo lectura, o bien elija Crear a partir de ella para crear una definición de máquina de estados editable sobre la que pueda crear e implementar posteriormente.
-
Elija Utilizar plantilla para continuar con la selección.
Los siguientes pasos dependen de la elección anterior:
-
Realice una demostración: puede revisar la máquina de estados antes de crear un proyecto de solo lectura con los recursos desplegados por AWS CloudFormation usted. Cuenta de AWS
Puede ver la definición de la máquina de estados y, cuando esté listo, seleccione Implementar y ejecutar para implementar el proyecto y crear los recursos.
La creación de recursos y permisos puede tardar hasta 10 minutos en implementarse. Puedes usar el enlace Stack ID para monitorear el progreso AWS CloudFormation.
Una vez completada la implementación, deberías ver tu nueva máquina de estados en la consola.
-
Aproveche esta información: puede revisar y editar la definición del flujo de trabajo. Es posible que tengas que establecer valores para los marcadores de posición en el proyecto de ejemplo antes de intentar ejecutar tu flujo de trabajo personalizado.
nota
Es posible que se apliquen cargos estándar por los servicios implementados en tu cuenta.
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.
-
Abra la consola de Step Functions
. -
Elija Crear máquina de estado.
-
En el cuadro de diálogo Elegir una plantilla, seleccione En blanco.
-
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.
-
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 del 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:
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 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 Espera a que te devuelvan la 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 rellenado 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, podrá ejecutarlo y ver su ejecución desde la consola Step Functions
Para ejecutar un flujo de trabajo en Workflow Studio
-
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.
-
En el cuadro de diálogo Iniciar ejecución, haga lo siguiente:
-
(Opcional) Introduzca un nombre de ejecución personalizado para anular el valor predeterminado generado.
ASCIINombres no identificables y registro
Step Functions acepta nombres para máquinas de estados, ejecuciones, actividades y etiquetas que no contengan ASCII caracteres. Como estos personajes no funcionan con Amazon CloudWatch, te recomendamos que utilices solo ASCII caracteres para poder hacer un seguimiento de las métricas CloudWatch.
-
(Opcional) En el cuadro de entrada, introduce los valores de entrada en el JSON formato adecuado para ejecutar tu flujo de trabajo.
-
Seleccione Iniciar ejecución.
-
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 Descripción general de los detalles de ejecución.
-
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
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.
Al guardar los cambios en el flujo de trabajo, tiene la opción de publicar también una nueva versión. Con las versiones, puedes elegir ejecutar la versión original o la alternativa de tu flujo de trabajo. Para obtener más información sobre la administración de flujos de trabajo con versiones, consulte Versiones de máquinas de estado en los flujos de trabajo de Step Functions
Exportar el flujo de trabajo
Puedes exportar la definición de tu flujo de trabajo Amazon States Language (ASL) y el gráfico del flujo de trabajo:
-
Elija su flujo de trabajo en la consola de Step Functions
. -
En la página Detalle de la máquina de estado, elija Editar.
-
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 utilizar Workflow Studio o Workflow Studio en Infrastructure Composerpara 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:
-
Inicie sesión en la consola de Step Functions
. -
Elija Crear máquina de estado.
-
En el cuadro de diálogo Elegir una plantilla, seleccione En blanco.
-
Elija Seleccionar para abrir Workflow StudioModo Diseño.
-
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:
-
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.
-
-
(Opcional) Para ver la ASL definición generada automáticamente de su flujo de trabajo, elija Definición.
-
(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.
-
-
(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.
-
Especifique la configuración del flujo de trabajo, como el tipo de máquina de estado y su función de ejecución.
-
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.