Trabajo con AWS Step Functions - Kit de herramientas de AWS 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

Trabajo con AWS Step Functions

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

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

Para ver los archivos de ASL existentes que contienen definiciones de máquina de estado en el Explorador del kit de herramientas de AWS, complete los siguientes pasos:

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

  2. Expanda el encabezado Step Functions.

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

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

En el kit de herramientas de AWS, puede crear una nueva máquina de estado de Step Functions a partir de un archivo o bien 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 el Diseñador de flujo de trabajo mediante el kit de herramientas de AWS, consulte el tema Uso del Diseñador de flujo de trabajo 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 su creación, el kit de herramientas de AWS abrirá el nuevo archivo en el Diseñador de flujo de trabajo de AWS Step Functions.

  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 kit de herramientas de AWS, puede crear una máquina de estado 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. En el procedimiento siguiente se describe cómo crear una máquina de estado de Step Functions a partir de una plantilla del kit de herramientas de AWS.

  1. En el Explorador del kit de herramientas de AWS, expanda la región en la que desea crear una máquina de estado 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. En el Explorador del kit de herramientas de AWS, expanda la región que contiene la máquina de estado de Step Functions que desea 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

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

  1. En el Explorador del kit de herramientas de AWS, expanda la región que contiene la máquina de estado de Step Functions que desea 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