Uso de la experiencia de diseño visual
Aprenda a crear, editar y ejecutar flujos de trabajo de manual de procedimientos utilizando la experiencia de diseño visual. Una vez que el flujo de trabajo esté listo, puede guardarlo o exportarlo. También puede utilizar la experiencia de diseño visual para crear prototipos rápidamente.
Cree de un flujo de trabajo del manual de procedimientos
-
Inicie sesión en la consola de automatización de Systems Manager
. -
Seleccione Crear runbook.
-
En el cuadro Nombre , escriba un nombre para el manual de procedimientos, por ejemplo,
.MyNewRunbook
-
Junto a los botones Diseño y Código, seleccione el icono del lápiz e introduzca un nombre para el manual de procedimientos.
Ahora puede diseñar un flujo de trabajo para su nuevo manual de procedimientos.
Diseñe un manual de procedimientos
Para diseñar un flujo de trabajo de manual de procedimientos utilizando la experiencia de diseño visual, arrastre una acción de automatización desde el navegador de Acciones al lienzo y sitúela en el lugar que desee en el flujo de trabajo del manual de procedimientos. También puede reordenar las acciones de su flujo de trabajo arrastrándolas a una ubicación diferente. A medida que arrastra una acción al lienzo, aparece una línea en el lugar donde puede colocar la acción en el flujo de trabajo. Cuando una acción se coloca en el lienzo, su código se genera automáticamente y se añade al contenido del manual de procedimientos.
Si sabe el nombre de la acción que quiere añadir, utilice el cuadro de búsqueda situado en la parte superior del navegador de Acciones para buscarla.
Después de colocar una acción en el lienzo, configúrela mediante el panel Formulario de la derecha. Este panel contiene las pestañas General, Entradas, Salidas y Configuración para cada acción de automatización o acción de API que coloque en el lienzo. Por ejemplo, la pestaña General contiene las siguientes secciones:
-
El Nombre del paso identifica el paso. Especifique un valor único para el nombre del paso.
-
La Descripción le ayuda a describir lo que está haciendo la acción en el flujo de trabajo de su manual de procedimientos.
La pestaña Entradas contiene campos que varían en función de la acción. Por ejemplo, la acción de automatización de aws:executeScript
contiene las siguientes secciones:
-
El Tiempo de ejecución es el lenguaje a usar para ejecutar el script proporcionado.
-
El Controlador es el nombre de su función. Debe asegurarse de que la función definida en el controlador tenga dos parámetros:
events
ycontext
. El tiempo de ejecución de PowerShell no admite este parámetro. -
El Script es un script insertado que desea ejecutar durante el flujo de trabajo.
-
(Opcional) El Archivo adjunto es para scripts independientes o archivos.zip que la acción puede invocar. Este parámetro es obligatorio para los manuales de procedimientos JSON.
La pestaña Salidas le ayuda a especificar los valores que desea generar de una acción. Puede hacer referencia a los valores de salida en acciones posteriores de su flujo de trabajo o generar resultados para fines de registro. No todas las acciones tendrán una pestaña de Salidas porque no todas las acciones admiten salidas. Por ejemplo, la acción aws:pause
no admite salidas. En el caso de las acciones que son compatibles con salidas, la pestaña Salidas consta de las siguientes secciones:
-
El Nombre es el nombre que se utilizará para el valor de salida. Puede hacer referencia a los resultados en acciones posteriores de su flujo de trabajo.
-
El Selector es una expresión de cadena JSONPath que comienza con
"$."
que se utiliza para seleccionar uno de varios componentes dentro de un elemento JSON. -
El Tipo es el tipo de datos del valor de salida. Por ejemplo, escriba tipo de dato
String
oInteger
.
La pestaña Configuración contiene propiedades y opciones que pueden utilizar todas las acciones de automatización. La acción consta de las secciones siguientes:
-
La propiedad Cantidad máxima de intentos es el número de veces que se reintenta una acción si se produce un error.
-
La propiedad Tiempo de espera en segundos especifica el valor de tiempo de espera de una acción.
-
La propiedad Es crítico determina si el error de la acción detiene toda la automatización.
-
La propiedad Siguiente paso determina la siguiente acción que debe realizar la automatización en el manual de procedimientos.
-
La propiedad En caso de error determina la siguiente acción de la automatización en el manual de procedimientos en caso de que la acción falle.
-
La propiedad Al cancelar determina la siguiente acción de la automatización en el manual de procedimientos si un usuario cancela la acción.
Para eliminar una acción, puedes usar la barra de herramientas situada sobre el lienzo o hacer clic con el botón derecho del ratón y seleccionar Eliminar acción.
A medida que el flujo de trabajo vaya creciendo, es posible que no quepa en el lienzo. Pruebe una de las siguientes opciones para que el flujo de trabajo encaje en el lienzo:
-
Use los controles de los paneles laterales para cambiar el tamaño de los paneles o cerrarlos.
-
Utilice la barra de herramientas situada en la parte superior del lienzo para acercar o alejar el gráfico del flujo de trabajo.
Actualice su manual de procedimientos
Puedes actualizar el flujo de trabajo de un manual de procedimientos existente creando una nueva versión del manual. Las actualizaciones de sus manuales de procedimientos se pueden realizar utilizando la experiencia de diseño visual o editando el código directamente. Para actualizar un manual de procedimientos existente, siga el siguiente procedimiento:
-
Inicie sesión en la consola de automatización de Systems Manager
. -
Elija el manual de procedimientos que desea actualizar.
-
Elija Create new version (Crear nueva versión).
-
La experiencia de diseño visual tiene dos paneles: un panel de códigos y un panel de flujo de trabajo visual. Elija Diseño en el panel de flujo de trabajo visual para editar su flujo de trabajo con la experiencia de diseño visual. Cuando haya terminado, elija Crear nueva versión para guardar los cambios y salir.
-
(Opcional) Use el panel de códigos para editar el contenido del manual de procedimientos en YAML o JSON.
Exporte su manual de procedimientos
Para exportar el código YAML o JSON del flujo de trabajo de su manual de procedimientos y también un gráfico del flujo de trabajo, siga el siguiente procedimiento:
-
Elija tu manual de procedimientos en la consola Documentos.
-
Elija Create new version (Crear nueva versión).
-
En el menú desplegable Acciones, elige si quiere exportar el gráfico o el manual de procedimientos y el formato que prefiera.