Trabajos

Los trabajos se utilizan para realizar tareas de ejecución remota, aplicar estados e iniciar ejecutores de Salt. El área de trabajo Trabajos es donde se pueden crear, configurar y guardar los ajustes de trabajo para volver a utilizarlos. Por lo general, los trabajos se diseñan para operaciones del sistema que se deben automatizar y ejecutar varias veces. Estos permiten ahorrar tiempo de configuración.

Por ejemplo, se puede establecer un trabajo para crear una máquina virtual, implementarla e instalar un conjunto base de aplicaciones. Es posible ejecutar este trabajo cada vez que se necesite implementar una nueva máquina virtual para garantizar que se aplique el mismo conjunto de aplicaciones y ajustes a cada implementación.

Consulte Flujo de trabajo de SaltStack Config para obtener una descripción general de la forma de utilizar el área de trabajo Trabajos junto con las otras áreas de trabajo de SaltStack Config con el fin de crear y utilizar trabajos para la administración de la configuración.

Puede ejecutar trabajos desde el área de trabajo Trabajos, el área de trabajo Minions o desde otras pantallas de la interfaz de usuario de SaltStack Config, según la naturaleza del trabajo. También puede ejecutar trabajos con una programación regular o puede ejecutarlos solo según sea necesario. En general, los trabajos que se ejecutan solo cuando es necesario se conocen como trabajos ad hoc.

Para obtener más información sobre la ejecución de trabajos, consulte:

• Ejecutar un trabajo para obtener información sobre la ejecución de trabajos en el área de trabajo Trabajos
• Minions para obtener información sobre la ejecución de trabajos en el área de trabajo Minions
• Programaciones para obtener información sobre la ejecución de trabajos en una programación

Nota: Como parte de la iniciativa de VMware para eliminar terminología problemática, el término maestro de Salt se reemplazará por uno mejor en SaltStack Config, y en los productos y la documentación relacionados. Esta actualización de terminología puede tardar algunos ciclos de versión en completarse totalmente.

Requisitos de los trabajos

Cada trabajo del área de trabajo Trabajos tiene una configuración predefinida. Puede editar la configuración de los trabajos existentes o crear un nuevo trabajo con ajustes únicos.

Para que se ejecute un trabajo, este debe incluir:

• Una función (la tarea que el trabajo tiene el objetivo de realizar)
• Un destino, un maestro de Salt o varios maestros de Salt
• Permisos basados en funciones

Es posible definir un destino en la configuración de un trabajo o dejar el destino sin definir para seleccionar un destino cada vez que se ejecute el trabajo. Al definir el destino de un trabajo, también se evita que ese trabajo se ejecute en nodos en los que no se debe ejecutar. Consulte Minions para obtener más información.

El área de trabajo Trabajos permite definir un acceso basado en funciones en cada trabajo. Además de definir el acceso de funciones en el trabajo, también se deben asignar permisos de funciones para ejecutar las tareas correspondientes en el editor Funciones. Consulte Funciones y permisos para obtener más información.

Es posible crear trabajos nuevos y editar los existentes desde el área de trabajo Trabajos. Una vez definida la configuración de un trabajo, se pueden ejecutar trabajos ad hoc o crear programaciones para ejecutar los trabajos en el futuro. Consulte Programaciones para obtener más información.

SaltStack Config incluye el control Ejecutar comando que permite ejecutar un solo comando sin definir un trabajo reutilizable. Esto es útil para ejecutar comandos de forma rápida o ejecutar trabajos únicos que no forman parte del flujo de trabajo diario, por ejemplo, en la solución de problemas o durante la configuración inicial. Consulte Ejecutar un comando para obtener más información.

También es posible definir qué funciones pueden ver, editar, ejecutar y eliminar diferentes trabajos.

Acceder al área de trabajo Trabajos

Para utilizar el área de trabajo Trabajos, haga clic en Configuración > Trabajos en el menú lateral.

Crear un trabajo

Para crear un trabajo nuevo:

1. En el área de trabajo Trabajos, haga clic en Crear trabajo.
2. Introduzca los detalles del nuevo trabajo. Los detalles que se introduzcan dependerán del tipo de trabajo que se desea crear. Consulte Configuración del trabajo para obtener más información.
3. Haga clic en Guardar. El trabajo ahora está disponible para ejecutarse.

Ejecutar un trabajo

Para ejecutar un trabajo ad hoc:

1. En el área de trabajo Trabajos, haga clic en el menú junto al trabajo que desea ejecutar.
2. Haga clic en Ejecutar ahora.
3. En la ventana emergente, seleccione el destino donde se ejecutará el trabajo.
   Nota: Si el trabajo se configuró para incluir un destino o un maestro de Salt, esto se mostrará para confirmación.
4. Seleccione opciones adicionales según sea necesario.
   • Establecer preferencias de notificación
   • Seleccione Ejecutar como prueba (simulacro) para ejecutar el trabajo como una prueba según sea necesario.
5. Haga clic en Ejecutar ahora.
   Nota: También puede ejecutar trabajos desde el área de trabajo Minions. Consulte Minions.

Buscar un trabajo

Para ver una lista de los trabajos disponibles que se crearon hasta el momento, acceda al área de trabajo Trabajos.

De forma predeterminada, solo se muestran 20 trabajos en una página a la vez. Para ver más trabajos, haga clic en el menú Elementos por página en la parte inferior de la tabla de trabajos y seleccione el número de trabajos que desea ver.

Para encontrar un trabajo específico:

1. En el área de trabajo Trabajos, haga clic en el botón de filtro de la columna donde desea buscar.
2. Comience a escribir los criterios de búsqueda para ver el filtro de filas de forma instantánea. Por ejemplo, puede buscar un trabajo por el módulo de Salt implicado en el trabajo. Para ello, filtre la columna Función.
   Nota: También puede hacer clic en cualquier nombre de columna una vez para ordenar las filas en orden descendente. Vuelva a hacer clic para invertir el orden. Para obtener más información sobre los filtros, consulte Filtrar y ordenar las columnas de las tablas.

Filtrar y ordenar las columnas de las tablas

Para filtrar cada columna, seleccione su icono de filtro y seleccione o escriba los criterios de filtro. Para borrar un filtro, haga clic en el botón Borrar filtros en la parte superior de la tabla de trabajos.

Para ordenar una columna, también puede seleccionar el nombre de la columna. Para personalizar las columnas que se muestran en la tabla, haga clic en el botón Mostrar columnas situado en la esquina inferior izquierda de la tabla.

Nota: Los ajustes de filtro, ordenación y visibilidad de columnas son persistentes para un usuario determinado, independientemente del dispositivo que este utilice para iniciar sesión. Esto significa que, cuando un usuario determinado inicia sesión, ve la misma configuración de filtro, ordenación y visibilidad la siguiente vez que inicia sesión hasta que se borran los filtros o se modifican los ajustes de ordenación y visibilidad.

Ver los resultados del trabajo

Para ver los resultados del trabajo:

1. En el menú lateral, haga clic en Actividad y, a continuación, en Completado para ver una lista de trabajos completados.
2. Seleccione un identificador de trabajo en la columna JID para ver detalles de los resultados del trabajo. Consulte Resultados de los trabajos para obtener más información.

Editar un trabajo

Para actualizar o cambiar un trabajo:

1. En el área de trabajo Trabajos, seleccione un trabajo.
2. Edite los detalles del trabajo según sea necesario y haga clic en Guardar cuando haya terminado.

Definir permisos de trabajo

Como administrador, puede restringir los usuarios que pueden ejecutar trabajos específicos. Para definir estos permisos:

1. En el área de trabajo Trabajos, seleccione un trabajo para abrir los detalles del trabajo.
2. En la página de detalles del trabajo, haga clic en Acceso de funciones.
3. En el cuadro de diálogo, seleccione el nivel de acceso que desea habilitar para las diferentes funciones y haga clic en Guardar.
4. En la página de detalles del trabajo, haga clic Guardar.
   Nota: Además de definir el acceso de funciones en el trabajo, también se deben asignar permisos de funciones para ejecutar las tareas correspondientes en el editor Funciones. Consulte Funciones y permisos para obtener más información.

Configuración del trabajo

Defina la configuración del trabajo en función de las siguientes opciones.

• Nombre: introduzca un nombre para el trabajo. Esto se mostrará en las áreas de trabajo Trabajos, Minions y Actividad, así como en el editor Funciones.
• Descripción: introduzca una descripción para el trabajo (opcional). Esta descripción se mostrará en su lista de trabajos en el área de trabajo Trabajos.
• Comando: especifique el comando que desea ejecutar. Elija entre:
  • salt: defina un trabajo para ejecutarlo en un grupo de minions.
  • salt-run: defina un trabajo para ejecutarlo en un maestro de Salt o en un grupo de maestros de Salt.
  Nota: SaltStack Config incluye el control Ejecutar comando que permite ejecutar un solo comando sin definir un trabajo reutilizable. Esto es útil para ejecutar comandos de forma rápida o ejecutar trabajos únicos que no forman parte del flujo de trabajo diario, por ejemplo, en la solución de problemas o durante la configuración inicial. Para obtener más información, consulte Ejecutar un comando.
• Destinos: un destino es el grupo de minions, en uno o varios maestros de Salt, al que se aplica el comando de Salt de un trabajo. Un maestro de Salt también se puede administrar como un minion y puede ser un destino si ejecuta el servicio de minion. Cuando se selecciona salt en Comandos, existe la opción de especificar el grupo de minions de destino en el que se desea ejecutar el trabajo. Si el campo queda en blanco, se le pedirá que seleccione un destino cada vez que se ejecute el trabajo.
• Todos los maestros: el maestro de Salt es un nodo central que se utiliza para emitir comandos a los minions. Cuando se selecciona salt-run en Comandos, es posible especificar el maestro de Salt en el que se debe ejecutar el trabajo. De forma predeterminada, se selecciona Todos los maestros. Si desactiva esta opción, se mostrará el menú Maestro.

  Los trabajos salt-run se conocen también como ejecutores de Salt. Los ejecutores de Salt son módulos que se utilizan para ejecutar funciones de conveniencia en el maestro de Salt. Para obtener más información sobre el uso de salt-run, consulte Configuración del trabajo.

• Maestros de Salt: cuando se selecciona salt-run en Comandos y se desactiva Todos los maestros, se muestra el menú Maestro. Haga clic en este menú y seleccione el maestro de Salt específico en el que desea ejecutar el trabajo. Puede seleccionar varios maestros de Salt si es necesario.
• Función: introduzca una función para definir lo que sucede cuando se ejecuta el trabajo. Puede definir un solo trabajo de ejecución remota, un trabajo de archivo de estado o un trabajo de ejecutor de Salt. Para obtener una lista de las funciones de Salt, consulte Referencia de módulos de Salt.
  • Trabajos únicos de ejecución remota: para definir un solo trabajo de ejecución remota, incluya una función y los argumentos necesarios en la configuración del trabajo.
  • Trabajos de archivo de estado: un trabajo de archivo de estado aplica estados a un destino y puede basarse en al menos un comando. Una función de estado es una función dentro de un módulo de estado que puede administrar la aplicación de un estado determinado en un sistema. A menudo, las funciones de estado llaman a uno o varios módulos de ejecución para realizar una tarea determinada. Un estado alto aplica todos los estados definidos en el archivo superior. Puede ver y agregar archivos de estado en el servidor de archivos. Consulte Servidor de archivos.

    Para aplicar un archivo de estado a un trabajo, utilice la función state.apply. Para ejecutar un estado alto, use la función state.apply o state.highstate en la configuración del trabajo.

    Al agregar una llamada de estado a un trabajo, se muestran campos adicionales donde puede seleccionar los archivos de estado que desea aplicar. También puede transferir anulaciones de pilares opcionales en formato JSON.

    Nota: Los datos de pilares proporcionados en la página del trabajo se envían junto con el trabajo. Es posible que otros minions autenticados puedan verlos. Para aumentar la protección de datos, asigne datos confidenciales en pilares estándar. Consulte Pilares.

    Para obtener más información sobre los estados de Salt, consulte Documentación de Salt: Cómo se utilizan los estados de Salt.

  • Ejecutores de Salt: un trabajo salt-run se aplica a un maestro de Salt o a un grupo de maestros de Salt. Los trabajos salt-run se conocen también como ejecutores de Salt. Los ejecutores de Salt son módulos que se utilizan para ejecutar funciones de conveniencia en el maestro de Salt. Puede utilizar ejecutores de Salt para ejecutar una orquestación, activar minions de forma remota, llamar a webhooks, etc. Son útiles para ejecutar tareas de forma centralizada o desde un punto de partida central. Por ejemplo, puede aplicar un estado alto a todos los minions asociados con un maestro de Salt determinado.

    Para configurar un trabajo de ejecutor de orquestación, utilice la función state.orchestrate. Al agregar una llamada de orquestación a un trabajo, se muestran campos adicionales donde puede enumerar los archivos de orquestación que desea aplicar. También puede transferir anulaciones de pilares opcionales en formato JSON.

    Nota: Los datos de pilares proporcionados en la página del trabajo se envían junto con el trabajo. Es posible que otros minions autenticados puedan verlos. Para aumentar la protección de datos, asigne datos confidenciales en pilares estándar. Consulte Pilares.

    Para obtener más información sobre los ejecutores de Salt, consulte Referencia de ejecutores de Salt.

• Entornos: seleccione el entorno en el que se encuentra el archivo de estado o de orquestación. Este es un subdirectorio del directorio raíz en el servidor de archivos. Consulte Servidor de archivos.
• Probar (simulacro): ejecute un trabajo de prueba y genere un resultado de trabajo ficticio. Si selecciona Probar, el trabajo no se ejecutará y no se realizará ningún cambio. Si deja esta opción sin seleccionar, puede optar por ejecutar el trabajo como una prueba más adelante cuando lo ejecute. La prueba (simulacro) solo está disponible para ciertas funciones. Para obtener más información, póngase en contacto con el administrador.