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 operació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 sucesivo. 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) en el grupo de recursos paralelo, task1 y task2 se ejecutan una tras otra en resource1 y resource2. Las tareas de resource1 y resource2 se ejecutan 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) en el grupo de recursos sucesivos, task1 y task2 se ejecutan secuencialmente en resource1. Una vez terminadas las tareas de resource1, task1 y task2 se ejecutan de forma secuencial 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: utilice esta propiedad para ejecutar un runbook en un destino cuando la condición sea verdadera. Esta opción es mejor 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: utilice esta propiedad cuando una tarea se deba ejecutar solo después de que finalice 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. Si selecciona Continuar, el libro de ejecución seguirá ejecutándose en el destino. Si selecciona Terminar, tanto el libro de ejecución del producto en el destino como el libro de ejecución de la pila de productos para la parada del grupo de acciones. Si selecciona Revertir, la operación de libro de ejecución se mueve al paso de rollback. 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 es verdadera.
-
Ejecutar en: especifica la condición mediante el nombre del producto de destino (para los libros de ejecución de la pila de productos), las propiedades del producto, el nombre del componente y las propiedades del componente del destino. Una tarea se ejecuta en el destino solo si la condición es 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 proceso de libro de ejecución: esta opción para la operación de libro de ejecución hasta que intervenga o hasta que finalice la duración definida. La pausa se produce antes de que se ejecute la siguiente 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. Al ejecutar el script Fleet Application Management, se rellena la variable de salida.
- 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:
|