Trabajando con AWS Step Functions - AWS Kit de herramientas para VS Code
Visualización de máquinas de estado de Step FunctionsCreación de una máquina de estado de Step FunctionsCreación de una máquina de estado de Step Functions a partir de una plantillaDescarga de una máquina de estado de Step FunctionsCómo guardar cambios en una máquina de estado de Step FunctionsEjecución de una máquina de estado de Step FunctionsUso de fragmentos de códigoValidación de código

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.

Trabajando con AWS Step Functions

En las siguientes secciones se describe cómo trabajar con AWS Step Functions Amazon State Language (ASL) archivos que contienen definiciones de máquinas de estados en el AWS kit de herramientas. Para obtener información detallada sobre las máquinas de AWS Step Functions estado, consulte el tema Más información sobre las máquinas de estado en Step Functions de la Guía para AWS Step Functionsdesarrolladores.

Visualización de máquinas de estado de Step Functions

Para ver los ASL archivos existentes que contienen definiciones de máquinas de estado en el explorador del AWS kit de herramientas, complete los siguientes pasos.

  1. En el explorador del AWS kit de herramientas, expanda la región que contiene el ASL archivo que desea ver.

  2. Expanda el encabezado Step Functions.

  3. Los ASL archivos se muestran en el AWS Explorador.

Creación de una máquina de estado de Step Functions

En el AWS kit de herramientas, puede crear una nueva máquina de estados de Step Functions a partir de un archivo o puede usar una plantilla. En el procedimiento siguiente se describe cómo crear una máquina de estado de Step Functions a partir de un archivo. Para obtener más información sobre cómo crear una máquina de estado de SFN; a partir de una plantilla, consulte la sección Plantillas de máquina de estado que se encuentra más abajo, en este tema de la Guía del usuario.

nota

Para trabajar con Step Functions en VS Code, la extensión del archivo Amazon State Language(ASL) que contiene la definición de máquina de estado debe terminar en asl.json, asl.yml o .asl.yaml.

De forma predeterminada, los archivos de Step Functions pertinentes se abren en el Diseñador de flujo de trabajo. Para obtener información detallada sobre cómo trabajar en Workflow Studio mediante el AWS kit de herramientas, consulte el tema Cómo trabajar con Workflow Studio de esta Guía del usuario.

  1. En el espacio de trabajo de VS Code, cree un archivo.

  2. Asígnele un nombre y especifique la extensión de archivo como asl.json, asl.yml o.asl.yaml.

  3. Tras la creación, el AWS kit de herramientas abre el nuevo archivo en AWS Step Functions Workflow Studio.

  4. En Diseñador de flujo de trabajo, elija el botón Guardar del menú de utilidades para guardar el nuevo archivo de ASL.

Creación de una máquina de estado de Step Functions a partir de una plantilla

En el AWS kit de herramientas, puede crear una máquina de estados de Step Functions a partir de una plantilla. El proceso de plantilla crea un archivo de ASL que contiene una definición de máquina de estado, lo que proporciona un punto de partida para el proyecto. El siguiente procedimiento describe cómo crear una máquina de estados de Step Functions a partir de una plantilla del AWS kit de herramientas.

  1. Desde el explorador del AWS kit de herramientas, expanda la región en la que desee crear una máquina de estados de Step Functions.

  2. Abra el menú contextual (con el botón derecho) de Step Functions y elija Crear una máquina de estado de Step Functions para abrir el asistente Select a starter template (1/2) en VS Code.

  3. En el asistente Select a starter template (1/2), elija el tipo de plantilla para la máquina de estado de Step Functions a fin de continuar.

  4. En la pantalla Select template format (2/2), elija YAML o JSON como formato de plantilla.

  5. Se abrirá un nuevo archivo de ASL que contiene la definición de máquina de estado en el editor de VS Code.

Descarga de una máquina de estado de Step Functions

Para descargar una máquina de estado de Step Functions almacenada de forma remota en su instancia local de VS Code, complete los siguientes pasos:

  1. Desde el explorador de AWS kits de herramientas, expanda la región que contiene la máquina de estados Step Functions que desee descargar.

  2. Expanda Step Functions y, a continuación, haga clic con el botón derecho en la máquina de estado de Step Functions que desea descargar y elija Descargar definición….

  3. Especifique una ubicación donde almacenar la máquina de estado de Step Functions de forma local para continuar.

  4. La máquina de estado de Step Functions se abre en el Diseñador de flujo de trabajo una vez completado el procedimiento.

Cómo guardar cambios en una máquina de estado de Step Functions

En el procedimiento siguiente se describe cómo guardar los cambios realizados en la máquina de estado de Step Functions.

nota

Las ediciones realizadas en el Diseñador de flujo de trabajo se sincronizan con el archivo local, pero no se guardan hasta que el trabajo se guarde en el editor de VS Code o el Diseñador de flujo de trabajo. Si el archivo local se modifica y se guarda mientras el Diseñador de flujo de trabajo está abierto y no se detectan errores en el archivo de ASL, recibirá la notificación Correcto en el Diseñador de flujo de trabajo cuando se haya completado el proceso de guardado. Sin embargo, si el archivo local contiene JSON o YAML no válido e intenta guardarlo, dicho archivo no se sincroniza y recibirá la notificación Advertencia en el Diseñador de flujo de trabajo.

  1. En un archivo de ASL abierto que contenga una definición de máquina de estado en el Diseñador de flujo de trabajo, diríjase a los botones de utilidades.

  2. Seleccione el botón Guardar.

  3. VS Code le avisará una vez que se haya guardado el archivo.

Ejecución de una máquina de estado de Step Functions

El siguiente procedimiento describe cómo ejecutar una máquina de estados Step Functions en el AWS kit de herramientas.

  1. En el explorador del AWS kit de herramientas, expanda la región que contiene la máquina de estados Step Functions que desee ejecutar.

  2. Expanda Step Functions y, a continuación, haga clic con el botón derecho en la máquina de estado de Step Functions que desea ejecutar.

  3. En el menú contextual, elija Iniciar la ejecución para iniciar el proceso de lanzamiento.

  4. El estado del lanzamiento se muestra en la ventana de Salida del kit de herramientas de AWS en VS Code.

Uso de fragmentos de código

Los fragmentos de código son sugerencias automatizadas que se generan en función del código en el que está trabajando. Para trabajar con fragmentos de código con Step Functions en el kit de herramientas, complete los siguientes pasos.

nota

Para trabajar con fragmentos de código de Step Functions en VS Code, la extensión del archivo de ASL que contiene la definición de máquina de estado debe terminar en .asl.json, .asl.yml o .asl.yaml.

De forma predeterminada, los archivos de Step Functions pertinentes se abren en el Diseñador de flujo de trabajo.

  1. En VS Code, abra un archivo de ASL que contenga la definición de máquina de estado que desea modificar o bien cree un archivo de ASL.

  2. En el Diseñador de flujo de trabajo, cambie al modo Código si está en el modo Diseño.

  3. En el editor de código del Diseñador de flujo de trabajo, coloque el cursor en la propiedad "States".

  4. Pulse control + space para abrir el menú de fragmentos de código; para acceder a propiedades adicionales basadas en los valores "State" "Type", pulse control + space.

  5. Elija el fragmento de código que desee de la lista.

Validación de código

Mientras trabaja en Step Functions en el Diseñador de flujo de trabajo, la validación de código identifica los errores de forma activa y hace sugerencias respecto a lo siguiente:

  • Propiedades que faltan

  • Valores incorrectos

  • Estado no terminal

  • Estados inexistentes a los que se señala