Cómo crear destinos

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.

Puede crear destinos para sus trabajos en el área de trabajo Minions. 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.

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 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:

En el área de trabajo Minions, haga clic en Todos los minions en el panel lateral Destinos.
Haga clic en el botón Crear destino.
En el cuadro de diálogo Crear destino, en el campo Nombre, introduzca un nombre descriptivo para el nuevo destino.
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.
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.
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 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. Para obtener más información sobre la selección de destinos compuestos, consulte Configuración de destinos.
Cuando haya terminado, haga clic en Guardar.

El nuevo destino aparecerá en la lista de destinos en el área de trabajo Minions.

Crear un destino de lista simple

Para crear un nuevo destino mediante una lista simple:

En el área de trabajo Minions, haga clic en Todos los minions en el panel lateral Destinos.
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.
La lista seleccionada se incluirá como criterio.
Introduzca un nombre de destino y defina cualquier configuración de destino adicional. Consulte Configuración de destinos.
Cuando haya terminado, haga clic en Guardar.

Asignar un pilar a un destino

Los pilares se usan principalmente para almacena secretos u otros datos altamente confidenciales, como credenciales de cuenta, clave criptográficas o contraseñas. Los pilares también son útiles para almacenar datos no secretos que no quiera poner directamente en sus archivos de estado, como datos de configuración. Para asignar los datos de un pilar a un destino específico de minions:

En el área de trabajo Minions, seleccione un destino en el panel lateral Destinos.
Haga clic en Más acciones.
En el menú, haga clic en Asociar pilar.
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.
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.

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.


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 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	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. Al crear destinos compuestos mediante Grains, RaaS no devuelve ningún minion si el nombre de Grain 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`.
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 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. Para obtener más información sobre la selección de destinos compuestos, consulte Configuración de destinos.

Prácticas recomendadas para crear destinos

Crear reglas de destino simples

Aunque no hay límite para cuántos destinos puede crear en SaltStack Config, intente crear las reglas de destino más simples que abarquen todas las máquinas en las que necesite tomar medidas.

Identifique los casos prácticos necesarios

Antes de crear destinos para los trabajos, comience con una lista de casos prácticos para ayudarle a determinar qué tipos de destino utilizar. Por ejemplo, para aplicar revisiones, puede utilizar Grain para dirigirse a un sistema operativo específico. La siguiente tabla contiene algunos ejemplos de grupos de destino, casos prácticos comunes y tipo de destino recomendado.


Grupo de destino	Caso práctico	Tipo de destino
Sistema operativo	Aplicación de revisiones Detección o diagnóstico Conformidad estándar	Grain
Clúster de aplicaciones	Instalación de aplicaciones Conformidad dirigida Revisiones selectivas Administración de la configuración y detección o corrección de desfases	Glob o List
Centro de datos, subred, zona de disponibilidad u otro segmento de red	Conformidad Configuración regional o de red	Glob o Grain personalizados
Método personalizado	Paquetes aprobados o no autorizados Administración de usuarios basada en la presencia o ausencia de aplicaciones instaladas Cuentas de usuario	Grain personalizado

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.