Diseño de un Runbook con Visual Designer
Utilice el diseñador visual para diseñar y crear runbooks personalizados en Fleet Application Management. El diseñador proporciona una interfaz de arrastrar con la opción de agregar código para que pueda crear y editar libros de ejecución más fácilmente. Runbook se puede escribir en YAML o JSON. Sin embargo, puede crear un runbook sin necesidad de crearlo en JSON o YAML nativo mediante el diseñador visual.
Con el diseñador visual, puede realizar las siguientes tareas:
- Diseñar un runbook mediante los componentes de runbook.
- Optimice la ejecución del runbook.
- Configure sentencias condicionales con el creador de condiciones.
- Configure ejecuciones de tareas condicionales basadas en componentes de producto, variables de entrada y salida, o ambas.
- Configurar el manejo de errores.
- Ilustra los runbooks proporcionados por Fleet Application Management.
- Clone runbooks ilustrados para ayudarle a crear runbooks personalizados donde agregue su código en el modo de origen o diseñador.
A medida que crea un runbook, el diseñador visual valida su trabajo y genera automáticamente código. Puede revisar el código generado o exportarlo para desarrollo local. Después de crear el runbook, puede guardarlo, publicarlo y examinar los resultados en la consola.
- El panel actions en el lado derecho contiene los separadores Components (Componentes) y Properties (Propiedades).
- El lienzo en el centro es un marcador de posición donde se diseña el runbook. Puede arrastrar los componentes desde el panel de acciones, como grupos de recursos paralelos o dinámicos, y arrastrar tareas a estos grupos. Puede cambiar el orden de los componentes en el lienzo colocándolos en el orden en el que desea que se ejecuten las tareas, o bien seleccionar acciones para configurar propiedades o gestionar errores.
El lienzo también contiene el icono de edición junto a cada componente de tarea para ver y modificar la tarea del libro de ejecución.
Para ver el código YAML o JSON generado automáticamente para el libro de ejecución mientras utiliza el diseñador visual, seleccione Vista de código en el lienzo. Al actualizar YAML o JSON, los cambios se generan automáticamente en el modo de diseñador.
Panel Acciones
En el panel de acciones, puede seleccionar los componentes que desea arrastrar al área de trabajo del lienzo. El panel contiene los siguientes elementos:
Separador Componentes
Para agregar una tarea, primero debe agregar un grupo de recursos paralelo o dinámico. Una tarea debe estar dentro de un grupo. Para obtener más información sobre el uso de tipos de grupo, consulte Creación de un libro de ejecución.
- Nueva tarea: utilice este botón para crear tareas para un libro de ejecución. Ahora puede agregar una tarea que pueda ejecutar un script especificando el tipo de acción como un script.
- Grupo de tareas paralelo: cualquier tarea que forme parte de un grupo de tareas paralelo se ejecuta en paralelo en un recurso (recursos informáticos y de base de datos) que forme parte de un conjunto.
Por ejemplo, si un conjunto tiene dos recursos y dos tareas (task1 y task2) que forman parte del grupo de tareas paralelo, task1 y task2 se ejecutan en paralelo en resource1 y resource2.
- Grupo de recursos paralelo: todas las tareas que forman parte de un grupo de recursos paralelo se ejecutan en paralelo entre recursos (recursos informáticos y de base de datos) que forman parte de un conjunto. Dentro de un recurso, las tareas que forman parte de un grupo de recursos paralelo se ejecutan secuencialmente.
Por ejemplo, si un conjunto tiene dos recursos y dos tareas (task1 y task2) que forman parte del grupo de recursos paralelo, task1 y task2 se ejecutan secuencialmente en resource1 y resource2, y la ejecución en resource1 y resource2 se produce en paralelo.
- Grupo de recursos sucesivos: cualquier tarea que forme parte de un grupo de recursos sucesivos se ejecuta secuencialmente en los recursos (recursos informáticos y de base de datos) que formen parte de un conjunto. Dentro de un recurso, las tareas que forman parte de un grupo de recursos sucesivos se ejecutan secuencialmente.
Por ejemplo, si un conjunto tiene dos recursos y dos tareas (task1 y task2) que forman parte del grupo de recursos sucesivos, task1 y task2 se ejecutan secuencialmente en resource1. Una vez finalizadas las tareas de resource1, task1 y task2 se ejecutan secuencialmente en resource2.
Separador Propiedades
El separador Propiedades proporciona valores para controlar las sentencias condicionales y configurar el manejo de errores de los componentes que agrega al lienzo. Después de agregar un componente al área de trabajo del lienzo en Tareas o Tareas de rollback, configúrelo para que se ajuste a su caso de uso. Seleccione el icono de propiedades (
) del componente para configurar sus propiedades y opciones. También puede ver el código YAML o JSON seleccionando Vista de código. Las propiedades están disponibles para un libro de ejecución, grupos y tareas.
Propiedades de Runbook
Las dos propiedades de un libro de ejecución son las siguientes:
- En caso de fallo de tareas: la opción que seleccione para esta propiedad es el valor por defecto para todos los grupos y tareas dentro de un runbook.
- Ejecutar el: la opción que seleccione describe dónde y cómo se ejecutan las tareas. Puede implicar instancias programadas, entornos autoalojados o instancias seleccionadas en función de los resultados de tareas anteriores. A continuación, se muestran las subpropiedades de Run on:
- Instancias especificadas por programa: esta propiedad se utiliza para la ejecución condicional de un runbook en un destino cuando la condición se evalúa como true. Es más adecuado para gestionar flujos de trabajo de pila de productos dentro de un runbook.
- Instancia autoalojada: esta propiedad le ayuda a localizar y seleccionar una instancia autoalojada para tareas posteriores al aprovisionamiento
- Instancia especificada por la tarea anterior: esta propiedad indica que la ejecución de una tarea depende de la finalización de una tarea anterior.
Propiedades del Grupo
Las cinco propiedades de un grupo son las siguientes:
- En caso de fallo: la opción que seleccione para esta propiedad decide el siguiente juego de acciones si falla una de las tareas de un grupo. La ejecución del runbook en el destino continúa si selecciona Continuar, la ejecución del runbook del producto en el destino se detiene y la ejecución del runbook de la pila de productos en el grupo de acciones se detiene si selecciona Abortar y la ejecución del runbook se mueve al paso de rollback si selecciona Revertir. Según el ámbito de rollback, la acción de rollback puede estar en el nivel de grupo de acción o destino.
- Condición previa: especifica la condición mediante variables de entrada de la tarea actual y variables de salida de todas las tareas anteriores. Una tarea se ejecuta en el destino solo si la condición se evalúa como verdadera.
- Ejecutar el: especifica la condición mediante el nombre del producto de destino (para el libro de ejecución de pila de productos), las propiedades del producto y el nombre del componente, así como las propiedades del componente de un destino. Una tarea se ejecuta en el destino solo si la condición se evalúa como verdadera.
Por ejemplo, en el runbook de pila de productos de aplicación de parches de Oracle WebLogic Server y Java, para ejecutar una tarea solo en el destino de Oracle WebLogic Server si su valor de propiedad java_version es
1.8.0_391y cuando el componente ADMIN_SERVER está disponible, introduzca la siguiente condición.target.product.name == "Oracle Weblogic Server" AND target.product.properties.java_home == "1.8.0_391" AND target.product.components.ADMIN_SERVER.properties.Server == "AdminServer" - Pausar ejecución: opción que detiene la ejecución de runbook hasta que intervenga o la duración definida se interrumpa. La pausa se produce antes de ejecutar una tarea.
- Notificación: le notifica mediante el servicio OCI Notification sobre el estado de la tarea.
Propiedades de Tarea
Las tareas incluyen una propiedad adicional en comparación con un grupo. A continuación se muestra la descripción de la propiedad:
Asignación de variables de salida: para el tipo de tarea Ejecutar un script, la salida de los logs de script se analiza para evaluar el valor de la VARIABLE de entrada con una coincidencia de patrón de $$VARIABLE=VALUE$$.
- Seleccione la casilla de control de la variable de salida y agregue una variable de salida. La ejecución del script Fleet Application Management garantiza que la variable de salida se rellena.
- En la siguiente tarea, seleccione la casilla de control Variable de entrada y agregue una variable de entrada.
- Asigne el nombre de la variable de entrada al nombre de la variable de salida de tareas anteriores mediante Asignación de variables de salida.
El script Fleet Application Management analiza ahora los logs de salida para identificar un patrón como $$VARIABLE=VALUE$$.
Separador de Biblioteca
El separador Biblioteca de tareas proporciona una lista de tareas reutilizables listas para usar que existen en la gestión de aplicaciones de conjunto o que ha creado. Puede utilizar el icono de arrastrar manejador (
) en la esquina derecha de una tarea para arrastrarla al área de trabajo del libro de ejecución en el lienzo. La biblioteca muestra solo las tareas relevantes para un libro de ejecución en función de la pila de productos o productos y el tipo de sistema operativo.
Tareas de rollback
Para realizar un rollback de una tarea definida si falla, puede agregar un grupo y, a continuación, agregar las tareas para realizar un rollback dentro del marcador de posición Tareas de rollback en el área de trabajo del lienzo. Para realizar un rollback, asegúrese de seleccionar la propiedad de tarea On Failure como Rollback en Tasks (Tareas) para la tarea específica.
Puede definir el ámbito del rollback en los niveles de destino o grupo de acciones. Este ámbito significa que Fleet Application Management ejecuta las tareas de rollback en un destino específico o en todos los grupos de destinos. Las tareas de rollback se ejecutan en el destino que falla si define un destino, mientras que las tareas de rollback se ejecutan en todo el grupo de destinos si define un grupo de acciones.
Lienzo
Después de determinar una acción que agregar al diseñador visual, arrastre un componente al área de trabajo del lienzo. Para cambiar el orden de los componentes, utilice el icono de arrastrar manejador () en la esquina derecha de un componente para arrastrarlo a un lugar diferente en el área de trabajo del runbook. Esta nueva acción se agrega al área de trabajo y su código se genera automáticamente.
Métodos abreviados del teclado para la navegación
| Acceso Directo de Teclado | Acción |
|---|---|
| Separador | Navegue al foco hasta el siguiente elemento de runbook. |
| Mayús + Tabulador | Navegue al foco hasta el elemento anterior del libro de ejecución. |
| Teclas de dirección | Mueva un componente después de que esté en el lienzo. Por ejemplo:
|
| Barra espaciadora o Intro/Intro | Seleccione un componente en el separador Componentes o Propiedades, o un elemento de libro de ejecución. |
| Esc | Cancelar el movimiento de un componente en el lienzo o cualquier acción antes de que se dispare. |
| Barra espaciadora o entrar | Active una actividad adecuada cuando el foco esté en cualquiera de los componentes, propiedades o elementos del libro de ejecución. Por ejemplo:
|