Trabajando con AWS Step Functions

Puede usar el AWS Toolkit for Visual Studio Code (código VS) para realizar diversas operaciones con máquinas de estado.

Requisitos previos

• Asegúrese de que el sistema cumple los requisitos previos especificados en Instalación del kit de herramientas para VS Code y después instale el kit de herramientas.

• Asegúrese de que ha configurado sus credenciales antes de abrir el Explorador de AWS .

Trabajar con máquinas de estado en VS Code

Puede utilizar VS Code para interactuar con máquinas de estado remotas y desarrollar máquinas de estado localmente en formato JSON o YAML. Puede crear o actualizar máquinas de estado, mostrar las máquinas de estado existentes, ejecutarlas y descargarlas. VS Code también le permite crear nuevas máquinas de estado a partir de plantillas, ver una visualización de su máquina de estado y proporciona fragmentos de código, finalización de código y validación de código.

Mostrar las máquinas de estado existentes

Si ya ha creado máquinas de estado, puede ver una lista de ellas:

1. Abra AWS Explorer.

2. Seleccione Step Functions.

3. Compruebe que muestra todas las máquinas de estado de su cuenta.

   

Descargar una máquina de estado

Para descargar una máquina de estado:

1. Desde el Explorador de AWS , haga clic con el botón derecho en la máquina de estado que desea descargar.

2. Seleccione Download (Descargar) y, a continuación, seleccione la ubicación en la que desea descargar la máquina de estado.

3. Verifique que se haya descargado correctamente.

   

Creación de una máquina de estado

Puede crear una nueva máquina de estado usted mismo o puede utilizar una plantilla. Para obtener más información sobre cómo crear una máquina de estado a partir de una plantilla, consulte la sección State Machine Template (Plantillas de máquina de estado). Para crear una nueva máquina de estado:

1. Cree un nuevo archivo de Lenguaje de estados de Amazon (ASL) con la definición de máquina de estado. Utiliza el menú de la parte inferior derecha para configurarlo como lenguaje de estados de Amazon.

2. Seleccione Publish to Step Functions (Publicar en Step Functions).

   

3. Seleccione Quick Create (Creación rápida), elija un rol y asigne un nombre a su máquina de estado.

   
   
   

Actualización de la máquina de estado

Para actualizar una máquina de estado

1. Edite el archivo ASL con la definición de máquina de estado.

2. Seleccione Publish to Step Functions (Publicar en Step Functions).

   

3. Seleccione Quick Update (Actualización rápida), y, a continuación, seleccione la máquina de estado que desea actualizar.

   
   

Ejecución de una máquina de estado

Para ejecutar una máquina de estado:

1. Desde el Explorador de AWS , haga clic con el botón derecho en la máquina de estado que desea ejecutar.

2. Proporcione la entrada de la máquina de estado. Puede probar la entrada desde un archivo y la entrada en un cuadro de texto.

3. Inicie la máquina de estado y verifique que se ejecuta correctamente.

   
   

Plantillas de máquina de estado

Cuando crea una máquina de estado, tiene la opción de crearla a partir de una plantilla. La plantilla contiene una definición de máquina de estado de ejemplo con varios estados de uso común y proporciona un punto de partida. Para utilizar plantillas de máquina de estado:

1. Abra la paleta de comandos en VS Code.

2. Seleccione Kit de herramientas de AWS : crear una nueva máquina de estado Step Functions.

3. Elija la plantilla que desea utilizar.

   

4. Elija si quiere usar el formato de plantilla JSON o YAML.

   

Visualización de gráfico de máquina de estado

Las visualizaciones de gráficos le permiten ver cómo se ve su máquina de estado en formato gráfico. Cuando cree una visualización gráfica, se abrirá otra pestaña y mostrará una visualización del JSON o YAML de la máquina de estado. A continuación, puede comparar la definición de máquina de estado que está escribiendo simultáneamente con su visualización. A medida que cambie la definición de la máquina de estado, la visualización se actualizará.

nota

Para crear una visualización de una definición de máquina de estado, la definición debe estar abierta en el editor activo. Si cierra o cambia el nombre del archivo de definición, la visualización se cerrará.

Para crear una visualización de gráfico de máquina de estado:

1. Defina su máquina de estado.

2. Abra la paleta de comandos en VS Code.

3. Para crear una visualización, utilice el botón de visualización en la esquina superior derecha o elija Gráfico de representación de AWS .

   

Fragmentos de código

Los fragmentos de código le permiten insertar secciones cortas de código. Para usar fragmentos de código:

1. Abra un archivo y guárdelo con la extensión .asl.json para el formato JSON o .asl.yaml para el formato YAML.

2. Cree una nueva máquina de estado con la propiedad States (Estados).

3. Coloque el cursor dentro de States (Estados).

4. Utilice la combinación de teclas Control + Space y seleccione su fragmento de código preferido.

5. Utilice Tab para recorrer la variable y los parámetros en el fragmento de código.

6. Pruebe los fragmentos Retry y Catch colocando el cursos en el estado relacionado.

   

Finalización y validación de código

Para ver cómo funciona la finalización del código:

1. Cree varios estados.

2. Coloque el cursor después de una propiedad siguiente o predeterminada. StartAt

3. Utilice la combinación de teclas Control + Space para enumerar las finalizaciones disponibles. Se puede acceder a propiedades adicionales utilizando Control + Space de nuevo y se basarán en el Type de State.

4. A medida que trabaje, se llevará a cabo la validación de código para:

   • Propiedades que faltan

   • Valores incorrectos

   • Estado no terminal

   • Estados inexistentes a los que se señala