La definición de un destino para trabajos u operaciones ayuda a evita que la operación se ejecute en nodos que no deben ejecutarla. Puede organizar los destinos mediante Grains, Globs, Lists o Compounds.

Qué es un destino

Un destino es un grupo de minions, en uno o varios maestros de Salt, al que se aplica el comando de Salt de un trabajo. Los destinos pueden contener minions conectados a cualquier maestro de Salt del entorno. Un maestro de Salt también se puede administrar como un minion y puede ser un destino si ejecuta el servicio de minion.

Antes de comenzar

Antes de crear los destinos, debe pensar en los grupos de destino que desea crear. Por ejemplo, es posible que desee crear un grupo de destino para una zona de seguridad o una sola subred. La forma en que organice los grupos de destino dependerá de las necesidades de su organización.

Crear nuevos destinos

Cada destino de SaltStack Config requiere 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 Destinos, haga clic en el botón Crear.
  2. Complete el formulario.

    Página de creación de destino en SaltStack Config

    1. En el campo Nombre, escriba un nombre descriptivo para el nuevo destino.
    2. (Opcional) Proporcione una descripción para el nuevo destino.
    3. 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.

    4. Haga clic en el menú Grain y seleccione el tipo de destino que desea utilizar.

      Puede seleccionar minions como destinos mediante Grains, Globs, Lists o Compounds. 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.

  3. Cuando haya terminado, haga clic en Guardar.

    El nuevo destino aparecerá en el área de trabajo Destinos.

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 Compound como el primer criterio, debe seguir la sintaxis de selección de destinos incluida en la Referencia de selección de destinos de Salt y debe incluir los criterios secundarios en la definición de destinos de Compound. 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.

Asignar un pilar a un destino

Para asignar un pilar a un destino:

  1. En el área de trabajo Destinos, haga clic en el menú icono de menú junto al destino donde desea asignar los datos del pilar.
  2. Haga clic en Adjuntar pilar.
  3. En el cuadro de diálogo Adjuntar pilar, seleccione los pilares que desea aplicar al destino.

    Cuadro de diálogo Adjuntar pilar

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

  4. 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. Para obtener más información, consulte Cómo crear archivos de estado y datos del pilar.

Asignar una función a un destino

Para asignar una función a un destino:

  1. En el área de trabajo Destinos, haga clic en el menú icono de menú junto al destino al que desea asignarle funciones.
  2. Haga clic en Asignar función.
  3. En el cuadro de diálogo Asignar función, seleccione las funciones que desea asignar.

    Asignar funciones en SSC

    Para obtener más información sobre las funciones de usuario en SaltStack Config, consulte Cómo definir las funciones de usuario.

  4. Haga clic en Actualizar destino.

Las funciones con permisos de recursos se agregan al grupo de destino. Puede ver las funciones nuevas o actualizadas en la cuadrícula de datos Destinos.

Configuración de destinos

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

Cada destino de SaltStack Config incluye un nombre, un maestro de Salt y criterios de destino, como muestra la tabla a continuación.

Ajuste Descripció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 varios nodos 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 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

Los destinos son dinámicos. Se agregan automáticamente minions nuevos a todas las definiciones de destinos que coincidan. Si no desea incluir nuevos minions que puedan coincidir con el destino dinámico en el futuro, guarde el destino como una lista en su lugar.

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

Tipo de destino Descripción
Grain

Busque coincidencias con un valor específico de Grain, por ejemplo, osfullname es Debian. Una vez seleccionado un Grain, 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.

Glob

Busque coincidencias de comodines con el identificador de minion. Por ejemplo, puede introducir webserver* para seleccionar varios minions, denominados webserver01, webserver02 y webserver03.

List

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

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.

Compound

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

Si selecciona Compound como el primer criterio, debe seguir la sintaxis de selección de destinos incluida en la Referencia de selección de destinos de Salt y debe incluir los criterios secundarios en la definición de destino de Compound. SaltStack Config no permite agregar ningún otro criterio en el editor de destinos.

Pasos siguientes

Después de crear los destinos que necesita, puede crear trabajos que ejecutarán tareas y procesos en los minions de destino. Consulte Cómo crear trabajos para obtener más información.