El área de trabajo Highstate se utiliza para administrar y supervisar la configuración del sistema. Puede acceder a una vista histórica de las ejecuciones de highstate en la infraestructura para obtener información y tendencias relacionadas con la discrepancia de configuración en todos los minions.
Como administrador del sistema, es consciente de la importancia de mantener la configuración del sistema en conformidad, de identificar los sistemas con errores o cambios y de que los sistemas vuelvan a cumplir con la directiva lo antes posible. El área de trabajo Highstate proporciona información importante sobre la configuración del sistema e incluye herramientas que pueden ayudarlo a administrar la discrepancia de configuración.
¿Qué es highstate?
En lugar de configurar manualmente cada minion y cada aplicación uno por uno, puede utilizar el sistema de administración de estados de SaltStack Config para crear archivos de estado que se pueden aplicar a muchos minions de forma simultánea. Estos archivos de estado pueden incluir un conjunto de instrucciones que le indican a SaltStack Config qué operaciones se deben ejecutar en el minion y en qué orden. El sistema de administración de estado también garantiza que cada minion esté configurado correctamente y de la forma más eficiente posible.
Sin embargo, si tiene cientos de archivos de estado y miles de minions, la ejecución de cada archivo de estado lleva tiempo. Una forma más rápida e intuitiva de aplicar archivos de estado a los minions es ejecutar un highstate. Cuando se ejecuta un highstate, se llama a la función state.highstate. La función state.highstate aplica todos los estados de Salt detallados en un archivo top.sls que se crea en el maestro de Salt.
- Está configurando la infraestructura por primera vez y necesita estandarizar las configuraciones en todo su entorno.
- Tiene sistemas críticos que deben cumplir con la directiva. El área de trabajo Programaciones en SaltStack Config se puede utilizar para programar un trabajo de highstate que se ejecute una vez a la semana para garantizar que los equipos estén configurados correctamente.
El archivo top.sls asigna los estados de Salt a un grupo de destinos y consiste en el entorno de Salt, los criterios de destino y los archivos de estado que se ejecutarán. Los minions descargan el archivo top.sls e intentan hacer coincidir las expresiones que contiene. Si un minion coincide con la expresión, ejecuta los archivos de estado especificados. Por ejemplo, puede organizar que el archivo top.sls aplique determinados archivos de estado a todos los minions, algunos a minions de CentOS y otros a minions cuyos identificadores contienen la cadena web.
base:
'*':
- vim
- scripts
'os:CentOS':
- match: grain
- centos-config
'*web*':
- apache
- django
Al ejecutar el highstate, si una configuración cambió, SaltStack Config puede devolver los minions y las aplicaciones a su estado de configuración que cumple con la directiva. Si es necesario cambiar una configuración, SaltStack Config implementa rápidamente esos cambios en los minions afectados. A continuación, puede utilizar el área de trabajo Highstate para ver los cambios realizados durante la última ejecución de highstate. Los gráficos y los informes en el área de trabajo también ayudan a visualizar los cambios en toda la infraestructura.
Considere probar los cambios en un entorno de desarrollo o en uno provisional. Si los estados son correctos, puede aplicarlos a su entorno de producción.
También puede ejecutar highstate en el modo de simulacro. Si ejecuta el highstate en modo de simulacro, SaltStack Config genera un retorno de trabajo que muestra los cambios que se realizarían en cada minion si se aplicaran los estados. Para obtener más información sobre el modo de simulacro, consulte Cómo crear trabajos.
Antes de ejecutar el highstate por primera vez, debe crear y configurar el archivo top.sls en el maestro de Salt. Para obtener más información sobre los estados de Salt y el archivo top.sls, consulte Organizar estados en la guía del usuario de Salt.
Ejecutar el highstate
Después de configurar el archivo top.sls, puede ejecutar el primer highstate.
Para ejecutar el highstate:
- Haga clic en la pestaña Estados en el área de trabajo Highstate.
- Haga clic en Ejecutar highstate.
- En el cuadro de diálogo, seleccione el destino donde se ejecutará el highstate.
- Haga clic en Ejecutar highstate.
Una vez finalizada la ejecución del highstate, puede ver los resultados de la primera ejecución del highstate en varios niveles:
- Nivel global: consulte los resultados del highstate en todo el entorno.
- Nivel de destino: consulte los resultados del highstate por grupo de destino.
- Nivel de minion: consulte los resultados del highstate por minion.
Nivel global
Puede ver el cumplimiento del highstate en el entorno desde las pestañas Estados y Minions. El nivel global lo ayuda a evaluar el estado general de la configuración del sistema desde la última ejecución de highstate.
En todos los niveles, se extraen los últimos datos del highstate de cada minion, tanto si los datos proceden de una ejecución de highstate reciente como de muchas ejecuciones de highstate. Puede utilizar el menú desplegable Limitar por en la pestaña Estados para asegurarse de que el área de trabajo Highstate solo muestre los datos más recientes.
El nivel global incluye la siguiente información para todos los estados:
| Término | Descripción |
|---|---|
| Estado | La declaración del identificador para el estado, por ejemplo, common-centos-packages. |
| Archivo SLS | El archivo que contiene la declaración de estado, por ejemplo, centos-config.sls. |
| Minions | El número de minions que ejecutaron el estado. |
| Errores | Indica si se produjeron errores al ejecutar el estado. El estado contiene errores por varios motivos. Por ejemplo:
La columna Comentarios proporciona más detalles sobre la causa de los errores en el estado. |
| Correcto | Indica el porcentaje general de estados que se ejecutaron correctamente. |
| Modificado | Indica el porcentaje general de minions que informaron cambios para cada estado. |
| Cambios | Indica si la ejecución de highstate más reciente generó cambios. La columna Comentarios proporciona más detalles sobre los cambios realizados. |
| Duración media | Duración media de la ejecución del estado en milisegundos (ms). |
| Entornos | El entorno de Salt que contiene el archivo de estado, por ejemplo, base o dev. |
| JID | El número de identificación del trabajo para la ejecución de state.highstate. |
Si hace clic en un estado de la pestaña Estados, puede ver la ejecución de highstate más reciente en cada uno de los minions de Salt.
Se proporciona la siguiente información para cada estado:
| Término | Descripción |
|---|---|
| ID de minion | El identificador del minion que ejecutó el estado. |
| Estado | Indica si el estado se ejecutó correctamente o si generó errores. |
| Cambios | Indica si la ejecución de highstate más reciente generó cambios. La columna Comentarios proporciona más detalles sobre los cambios realizados. |
| Entorno | El entorno de Salt que contiene el archivo de estado, por ejemplo, base o dev. |
| Clúster/maestro | El maestro de Salt asociado con el minion. |
| Duración | Duración de la ejecución del estado en milisegundos (ms). |
| Comentario | Un mensaje que proporciona más detalles sobre la correcta ejecución del estado o los errores generados. |
| JID | El número de identificación del trabajo para la ejecución de state.highstate. |
También puede ejecutar un trabajo de highstate ad hoc a nivel global:
- En SaltStack Config, abra el espacio de trabajo Highstate.
- Haga clic en Ejecutar highstate.
- En el cuadro de diálogo, seleccione el destino donde se ejecutará el highstate.
- Haga clic en Ejecutar highstate.
Puede supervisar el progreso del trabajo en la pestaña Actividad del área de trabajo Highstate. Una vez completado el trabajo, puede ver los informes actualizados y los detalles de la ejecución del highstate a nivel global, de destino o de minion.
Nivel de destino
Para ver los resultados del highstate a nivel de destino, puede abrir el área de trabajo Destinos. Si hace clic en un destino, se pueden ver todas las ejecuciones de estado anteriores de todos los minions del grupo de destino.
El nivel de destino proporciona la siguiente información acerca de cada minion del grupo de destino:
| Término | Descripción |
|---|---|
| ID de minion | El identificador del minion. |
| Ejecuciones de estado | El número de ejecuciones de estado de un minion. |
| Errores | Indica si se produjeron errores al ejecutar el estado. El estado puede generar errores por varios motivos. Por ejemplo:
La columna Comentarios proporciona más detalles sobre la causa de los errores en el estado. |
| Correcto | Indica el porcentaje general de estados que se ejecutaron correctamente. |
| Modificado | Indica el porcentaje general de estados que generaron cambios. |
| Cambios | Indica si la ejecución de highstate más reciente generó cambios. La columna Comentarios proporciona más detalles sobre los cambios realizados. |
| Duración | Duración de la ejecución del estado en milisegundos (ms). |
| Entornos | El entorno de Salt que contiene el archivo de estado, por ejemplo, base o dev. |
| JID | El número de identificación del trabajo para la ejecución de state.highstate. |
Para ejecutar un trabajo de highstate ad hoc a nivel de destino:
- En SaltStack Config, abra el área de trabajo Destinos.
- Seleccione el grupo de destino en el que desea ejecutar el highstate.
- Haga clic en la pestaña Highstate.
- Haga clic en Ejecutar highstate.
- En el cuadro de diálogo, confirme el grupo de destino en el que desea ejecutar el highstate.
- Haga clic en Ejecutar highstate.
Nivel de minion
Para ver los resultados del highstate a nivel de minion, puede abrir la pestaña Minions en el área de trabajo Highstate.
El nivel de minion proporciona la siguiente información para todos los minions:
| Término | Descripción |
|---|---|
| ID de minion | El identificador del minion. |
| Ejecuciones de estado | El número de ejecuciones de estado de un minion. |
| Errores | Indica si se produjeron errores al ejecutar el estado. El estado puede generar errores por varios motivos:
La columna Comentarios proporciona más detalles sobre la causa de los errores en el estado. |
| Correcto | Indica el porcentaje general de estados que se ejecutaron correctamente. |
| Modificado | Indica el porcentaje general de estados que generaron cambios para el minion. |
| Cambios | Indica si la ejecución de highstate más reciente generó cambios. |
Si hace clic en un ID de minion, se pueden ver todas las ejecuciones de estado anteriores de un minion.
Se proporciona la siguiente información:
| Término | Descripción |
|---|---|
| Correcto | Indica si el estado se ejecutó correctamente o si generó errores. |
| Cambios | Indica si la ejecución de highstate más reciente generó cambios. |
| Entorno | El entorno de Salt que contiene el archivo de estado, por ejemplo, base o dev. |
| Archivo SLS | El archivo que contiene la declaración de estado, por ejemplo, centos-config.sls. |
| Estado | La declaración del identificador para el estado, por ejemplo, common-centos-packages. |
| Duración | Duración de la ejecución del estado en milisegundos (ms). |
| Comentario | Un mensaje que proporciona más detalles sobre la correcta ejecución del estado o los errores generados. |
| JID | El número de identificación del trabajo para la ejecución de state.highstate. |
Para ejecutar un trabajo de highstate ad hoc a nivel de minion:
- En SaltStack Config, abra el espacio de trabajo Highstate.
- Seleccione los minions en los que desea ejecutar el highstate.
- Haga clic en Ejecutar highstate.
- En el cuadro de diálogo, haga clic en Ejecutar highstate.
Ver la actividad del highstate
La pestaña Actividad del área de trabajo Highstate se utiliza para supervisar el estado de las ejecuciones de highstate. La pestaña Actividad permite ver muchos tipos de eventos y actividades, como los trabajos programados o los trabajos ad hoc.
El gráfico interactivo de la pestaña Actividad incluye varios informes que proporcionan una descripción general de las ejecuciones de highstate anteriores en el entorno de SaltStack Config. Puede ver los resultados de las últimas 24 horas a los últimos 30 días en cada informe.
| Informe | Descripción |
|---|---|
| Minion: duración media | Muestra la duración media de las ejecuciones de estado en todos los minions, en el tiempo. |
| Minions: con cambios y sin cambios | Muestra el número de minions que informaron cambios frente a los minions que no lo hicieron, en el tiempo. |
| Minions: ejecución correcta y con errores | Muestra la cantidad de minions que informaron ejecuciones de estado correctas frente a los minions que notificaron ejecuciones de estado con errores, en el tiempo. |
| Estados: con cambios y sin cambios | Muestra la cantidad de estados que generaron cambios frente a los estados que no lo hicieron, en el tiempo. |
| Estados: ejecución correcta y con errores | Muestra la cantidad de estados que se ejecutaron correctamente frente a los estados con errores. |
La pestaña Actividad contiene tres secciones donde se clasifican los trabajos por estado:
- Completado: se utiliza para supervisar el estado de los trabajos de highstate completados.
- En curso: se utiliza para supervisar el estado de los trabajos de highstate que se encuentran en ejecución.
- Próximo: se utiliza para supervisar el estado de los próximos trabajos de highstate.
La tabla de la pestaña Actividad muestra información sobre el estado, el origen, la programación (si está disponible), el trabajo, el grupo de destino y el identificador de trabajo asociado (JID). Puede filtrar las columnas según sea necesario.
