El área de trabajo Minions se utiliza para ver los detalles de los minions, buscar u ordenar minions por identificador y otras propiedades, ejecutar trabajos o comandos ad hoc y crear destinos nuevos. También se puede utilizar esta área de trabajo para ajustar la configuración de destino, como los pilares asociados, ejecutar trabajos, aceptar o rechazar claves, y asignar una función o un pilar a un destino. Consulte Minions para obtener más informació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.

Administrar minions y destinos

El área de trabajo Minions incluye una lista de todos los minions de Salt que ejecutan el servicio de minion y que actualmente administra SaltStack Config. Los minions son nodos que ejecutan el servicio de minion, y pueden escuchar los comandos de un maestro de Salt y realizar las tareas solicitadas. Los maestros de Salt pueden ejecutar el servicio de minion, lo que permite configurar y administrar el nodo donde se ejecuta el servicio de controladoras Salt según sea necesario.

El panel lateral del área de trabajo incluye una lista de 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. La definición de un destino para un trabajo o una operación también evita que la operación se ejecute en nodos que no deben ejecutarla. Los destinos pueden contener minions conectados a cualquier maestro de Salt del entorno. Puede asociar datos de pilares a diferentes destinos. Los pilares son estructuras de datos definidas en el maestro de Salt y transferidas a uno o varios minions mediante destinos. Estos elementos permiten enviar los datos confidenciales dirigidos de forma segura solo al minion relevante. Consulte Pilares para obtener más información.

De forma predeterminada, al abrir el área de trabajo, el destino Todos los minions se encuentra activo. El destino Todos los minions enumera todos los minions para los que el usuario tiene permiso de acceso.

Comandos o trabajos ad hoc

El área de trabajo Minions también incluye el control Ejecutar comando para ejecutar un único comando ad hoc en uno o varios minions sin crear un trabajo reutilizable. Esta función es útil para ejecutar comandos de forma rápida o ejecutar trabajos únicos que no forman parte del flujo de trabajo diario, como en la solución de problemas o durante la configuración inicial. Consulte Ejecutar un comando para obtener más información.

En el área de trabajo Minions, puede ejecutar un trabajo o comando ad hoc sobre:

  • Un solo minion
  • Una lista de minions
  • Un maestro de Salt o todos los maestros de Salt (con salt-run)
  • Un destino

Consulte Flujo de trabajo de SaltStack Config para obtener una descripción general de la forma de utilizar el área de trabajo Minions 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.

Acceder al área de trabajo Minions

Para utilizar el área de trabajo Minions, haga clic en Destinos en el menú lateral.

Ver detalles de minions

Para ver los detalles de un minion específico:

  1. En el área de trabajo Minions, seleccione un identificador de minion en la columna Identificador de minion para abrir la página de detalles del minion.
  2. En la página de detalles del minion, puede ver una lista de granos o información sobre el minion. También puede ejecutar un trabajo ad hoc con un solo minion.
  3. Seleccione la pestaña Actividad para ver el historial de trabajos del minion. Consulte Trabajos para obtener más información.

Descargar datos de minions

Para descargar los datos de todos los minions:

  1. En el área de trabajo Minions, haga clic en Más acciones para abrir un menú.
  2. En el menú, en la tabla Descargar, seleccione el formato requerido para iniciar la descarga.

Buscar un minion

Para encontrar un minion específico:

  1. En el área de trabajo Minions, haga clic en el botón de filtro icono 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 identificador de minion en la columna Minion.
    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 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 minions.

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 icono de mostrar columnas situado en la esquina inferior de la tabla de minions.

Nota:

Si filtra con el destino Todos los minions, ese filtro persistirá en todos los destinos.

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.

Para ordenar una columna, también puede seleccionar el nombre de la columna.

Ejecutar un trabajo ad hoc

En el área de trabajo Minions, puede ejecutar un trabajo o comando ad hoc sobre:

  • Un solo minion
  • Una lista de minions
  • Un maestro de Salt o todos los maestros de Salt (con salt-run)
  • Un destino
Nota:

Los destinos son dinámicos. Se agregan automáticamente minions nuevos a todas las definiciones de destinos que coincidan. Asegúrese de revisar los minions que se incluyen en un destino antes de ejecutar un trabajo.

Consulte Flujo de trabajo de SaltStack Config para obtener una descripción general de la forma de utilizar el área de trabajo Minions 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.

Para ejecutar un trabajo ad hoc:

  1. En el área de trabajo Minions, seleccione en qué minion, destino o lista de minions desea ejecutar el trabajo:
    • Para seleccionar un solo minion o una lista de minions, seleccione la casilla situada junto a los minions de la tabla.
    • Para seleccionar un destino, haga clic en el nombre del destino en el panel lateral Destinos. El nombre del destino seleccionado actualmente se mostrará sobre la lista de minions.
  2. Haga clic en Ejecutar trabajo para ejecutar un trabajo.
  3. En el cuadro de diálogo de confirmación, seleccione el trabajo que desea ejecutar y confirme que se seleccionaron el destino o los minions correctos.
  4. Seleccione opciones adicionales según sea necesario y haga clic en Ejecutar ahora.

Para obtener más información sobre los trabajos y las diferentes opciones disponibles al ejecutar un trabajo, consulte Trabajos.

Nota:

También puede ejecutar un trabajo en un solo minion si selecciona su Identificador de minion y consulta la página de detalles del minion.

Ejecutar un comando

En el área de trabajo Minions, puede ejecutar un trabajo o comando ad hoc sobre:

  • Un solo minion
  • Una lista de minions
  • Un maestro de Salt o todos los maestros de Salt (con salt-run)
  • Un destino
Nota:

Los destinos son dinámicos. Se agregan automáticamente minions nuevos a todas las definiciones de destinos que coincidan. Asegúrese de revisar los minions que se incluyen en un destino antes de ejecutar un trabajo.

Consulte Flujo de trabajo de SaltStack Config para obtener una descripción general de la forma de utilizar el área de trabajo Minions 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.

Para ejecutar un comando en uno o varios minions:

  1. En el área de trabajo Minions, seleccione en qué minion, destino o lista de minions desea ejecutar el trabajo:
    • Para seleccionar un solo minion o una lista de minions, seleccione la casilla situada junto a los minions de la tabla.
    • Para seleccionar un destino, haga clic en el nombre del destino en el panel lateral Destinos. El nombre del destino seleccionado actualmente se mostrará sobre la lista de minions.
  2. Haga clic en Ejecutar comando.
  3. En el cuadro de diálogo Ejecutar comando, confirme que se seleccionaron el comando y el destino correctos y, a continuación, seleccione una función.
    Nota:

    Si selecciona el comando salt-run, puede ejecutar el comando en todos los maestros de Salt o en un maestro de Salt específico. Esto se conoce como un ejecutor de Salt. Consulte Ejecutores de Salt para obtener más información.

    Incluya los argumentos según sea necesario. Para obtener más información sobre los comandos y las funciones de Salt, consulte Trabajos.

  4. Haga clic en Ejecutar comando.

El comando se ejecuta como un trabajo. Puede realizar un seguimiento de su progreso y resultados, al igual que en otros trabajos de SaltStack Config. Consulte Resultados de los trabajos.

Crear un nuevo destino

Cada destino de SaltStack Config incluye un nombre, un maestro de Salt y criterios de destino. Para definir un nuevo destino con uno o varios minions incluidos:

  1. En el área de trabajo Minions, haga clic en Todos los minions en el panel lateral Destinos.
  2. Haga clic en el botón Crear destino.
  3. En el cuadro de diálogo Crear destino, en el campo Nombre, introduzca un nombre descriptivo para el nuevo destino.
  4. De forma predeterminada, el ajuste Todos los maestros se encuentra habilitado, lo que significa que es posible incluir en el destino los minions que administra cualquier maestro de Salt. Haga clic en este botón para aplicar este destino a un solo subconjunto de minions asociados con uno o varios maestros de Salt.

    Si deshabilita este ajuste, se mostrará un menú que puede utilizar para seleccionar el o los maestros de Salt a los que se debe aplicar el destino. Consulte Configuración de destinos para obtener más información.

  5. Haga clic en el menú Grano y seleccione el tipo de destino que desea utilizar. Puede seleccionar minions como destinos mediante granos, globs, listas o compuestos. Consulte Configuración de destinos para obtener más información sobre estas opciones de selección de destinos. Para obtener información más general sobre los destinos de Salt, consulte Seleccionar minions como destinos.
  6. Existen diferentes criterios y ajustes de destino disponibles según el tipo de destino seleccionado en el paso anterior. Para obtener más información sobre estos ajustes, consulte Configuración de destinos.
    Nota:

    Si selecciona Compuesto como el primer criterio, debe seguir la sintaxis de selección de destinos incluida en Referencia de selección de destinos de Salt y debe incluir los criterios secundarios en la definición del destino compuesto. SaltStack Config no permite agregar ningún otro criterio en el editor de destinos. Para obtener más información sobre la selección de destinos compuestos, consulte Configuración de destinos.

  7. Cuando haya terminado, haga clic en Guardar.

Definir un destino de lista simple

Para crear un nuevo destino mediante una lista simple:

  1. En el área de trabajo Minions, haga clic en Todos los minions en el panel lateral Destinos.
  2. Haga clic en la casilla de verificación situada junto a los minions que desea incluir en la lista y haga clic en Crear destino.
    Nota:

    Puede ser útil filtrar u ordenar los minions para definir una lista. Consulte Filtrar y ordenar las columnas de las tablas.

    La lista seleccionada se incluirá como criterio.

  3. Introduzca un nombre de destino y defina cualquier configuración de destino adicional. Consulte Configuración de destinos.
  4. Cuando haya terminado, haga clic en Guardar.

Asignar un pilar a un destino

Para asignar los datos de un pilar a un destino específico de minions:

  1. En el área de trabajo Minions, seleccione un destino en el panel lateral Destinos.
  2. Haga clic en Más acciones.
  3. En el menú, haga clic en Asociar pilar.
  4. En el cuadro de diálogo, seleccione los pilares que desea aplicar al destino.

    Además de seleccionar un pilar, seleccione Actualizar pilar de modo que el pilar esté disponible inmediatamente para el destino seleccionado.

  5. Haga clic en Actualizar destino.

    Los datos del pilar seleccionado estarán disponibles para todos los minions del destino.

    Nota:

    También puede asignar un pilar a un destino en el área de trabajo Pilares. Consulte Pilares.

Presencia de minions

La columna Presencia indica si SaltStack Config ha recibido datos de trabajos del minion recientemente, dentro de un intervalo definido llamado raas_presence_expiration. De forma predeterminada, este intervalo se establece en 3600 segundos. La presencia puede proporcionar un indicador del estado de la máquina mediante la señal Presencia instalada en los minions.

Si se establece la señal Presencia, los minions envían cargas útiles de estado de forma periódica a sus maestros de Salt y SaltStack Config recupera esto, lo que influye en el estado que se muestra en la columna Presencia.

Las señales se utilizan para supervisar los procesos que no son de Salt. Cuando se produce una actividad supervisada, se envía un evento que se puede configurar para activar un reactor. Para obtener más información sobre las señales, consulte Referencia de señales de Salt.

Nota: Puede comprobar las señales que se encuentran instaladas y activas en un minion mediante la ejecución de un trabajo con beacons.list en el destino correspondiente de un minion. Consulte Trabajos para obtener más información.

SaltStack Config proporciona los siguientes estados de Presencia.

Estado Descripción
Desconocido SaltStack Config nunca ha obtenido una respuesta del minion. Este es el estado predeterminado para los minions recién conectados. Una vez que los minions reciben un comando, el estado se actualiza a Presente.
Presente SaltStack Config ha obtenido respuestas del minion en el último intervalo de raas_presence_expiration, establecido en 3600 segundos de forma predeterminada.
Desconectado SaltStack Config ha obtenido una respuesta del minion, pero no en el último intervalo de raas_presence_expiration.

Configuración de destinos

La selección de destinos en SaltStack Config es similar a la selección de destinos en Salt de código abierto, pero SaltStack Config ofrece una interfaz simplificada para seleccionar destinos, donde también es posible guardar definiciones de destinos para su reutilización. Para obtener más información sobre la selección de destinos en Salt, consulte Referencia de selección de destinos de Salt.

Cada destino de SaltStack Config incluye un nombre, un maestro de Salt y criterios de destino, los cuales se describen en detalle a continuación.

Nombre

Introduzca un nombre de destino. Los nombres de destino no tienen que ser únicos. Esto puede provocar que se muestren diferentes elementos con el mismo nombre en la interfaz de usuario de SaltStack Config.

Todos los maestros de Salt

De forma predeterminada, el destino incluye todos los maestros de Salt. Sin embargo, es posible seleccionar como destinos los minions que solo pertenecen a un maestro de Salt específico. Por ejemplo, si el entorno tiene varias máquinas responsables de ejecutar una aplicación específica y el usuario particionó la infraestructura de Salt de modo que estas máquinas se conecten a un solo maestro de Salt, es posible seleccionar únicamente el maestro de Salt para crear un destino que incluya el subconjunto completo de minions.

Si desea habilitar la selección de destinos por maestro de Salt, haga clic en este botón de radio para desactivar este ajuste. Se mostrará un nuevo grupo de ajustes.

En el campo Maestro, seleccione un maestro de Salt cuyos minions desee utilizar como destino. Todos los criterios de destino adicionales se aplicarán únicamente al subconjunto de minions asociado con el maestro de Salt seleccionado.

Criterios de destino

Utilice los criterios de destino para especificar un grupo de minions, que hacen referencia a las siguientes descripciones de campos.

Los destinos son dinámicos. Se agregan automáticamente minions nuevos a todas las definiciones de destinos que coincidan. Guardar el destino como una lista evita que los nuevos minions que coincidan con la configuración dinámica de destino se agreguen automáticamente a un destino.

Tipo de destino Descripción
Grano

Busque coincidencias con un valor específico de grano, por ejemplo, osfullname es Debian. Una vez seleccionado un grano, la lista de valores se rellenará automáticamente para que pueda hacer clic en el campo y ver las opciones disponibles o comenzar a escribir.

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

Nota: Al crear destinos compuestos mediante granos, RaaS no devolverá ningún minion si el nombre del grano tiene un espacio en el nombre. Por este motivo, cualquier espacio se convierte automáticamente en un signo ?.
Glob Busque coincidencias de comodines con el identificador de minion. Por ejemplo, puede introducir webserver* para seleccionar varios minions, denominados webserver01, webserver02 y webserver03.
Lista

Especifique una lista de minions para incluir en el destino. Por ejemplo, dc3-north-db1,dc3-north-db2.

Nota: Especificar una lista es útil si no desea conceder acceso a los destinos de forma dinámica. Esto evita que los nuevos minions que coincidan con los criterios dinámicos de destino se agreguen automáticamente a un destino.
Compuesto

Combine varias interfaces de destino, separadas por conjunciones y , o , y no.

Para aprovechar la selección de destinos compuestos en SaltStack Config, primero revise la selección de destinos compuestos en Referencia de selección de destinos de Salt.

Nota: Si selecciona Compuesto como criterio, debe seguir la sintaxis de selección de destinos compuestos de Salt e incluir los criterios secundarios en la definición del destino compuesto. SaltStack Config no permite incluir ningún otro tipo de criterio además de un criterio Compuesto.