El área de trabajo Complementos principales proporciona la capacidad de actualizar la versión del complemento principal en el maestro de Salt para que coincida con la versión de SaltStack Config. Esta característica es compatible con las implementaciones locales y en la nube. También puede descargar la versión más reciente del complemento principal.

El área de trabajo Complementos principales proporciona información sobre el estado del complemento, la versión del complemento, la versión de Salt, el JID de la última actualización, etc. La versión más reciente de sseapiclient también está disponible a través del área de trabajo Complementos principales. Consulte Usar la API para obtener más información.

El complemento principal permite que los maestros de Salt se comuniquen con SaltStack Config. El complemento también incluye diferentes opciones que puede ajustar para mejorar el rendimiento. Consulte la referencia de los ajustes de configuración de los complementos principales para obtener más información.

RaaS contiene las versiones actual y anterior del complemento principal. Cuando el maestro de Salt se conecta a RaaS, comprueba si RaaS tiene versiones de complemento que no tiene. Si el maestro de Salt no tiene esas versiones del complemento, recupera los complementos de RaaS y los almacena en caché de forma local en /var/cache/salt/master/plugin_cache/.

El complemento no se actualiza automáticamente cuando hay disponible una nueva versión de SaltStack Config. Debe iniciar el proceso de actualización de forma manual. Como práctica recomendada, debe actualizar a la versión más reciente del complemento cuando esté disponible.

El proceso de actualización del complemento principal se basa en el módulo service y el estado service.running de Salt para reiniciar el maestro de Salt después de la actualización del complemento. El módulo service depende del administrador de init de su distribución, como systemd.

Nota:

Si ejecuta el maestro de Salt en un contenedor o en una distribución que no utiliza un administrador de init, debe reiniciar manualmente el maestro de Salt después de la actualización. Si no reinicia el maestro de Salt, el área de trabajo Complementos principales informará de que el maestro de Salt está ejecutando una versión de complemento obsoleta.

Antes de comenzar

Antes de poder utilizar el área de trabajo Complementos principales, debe completar los siguientes requisitos previos:

  • Instale el complemento principal en el maestro de Salt. Consulte Instalar y configurar el complemento principal para obtener más información.
  • Compruebe que la clave del maestro de Salt se haya aceptado en la interfaz de usuario de SaltStack Config.
  • Compruebe que el maestro de Salt se esté ejecutando como root. Si el maestro de Salt se ejecuta como usuario no root, se produce un error en la actualización.
  • Asegúrese de que el maestro de Salt ejecute la versión 3002.1 o posterior de Salt. Si el maestro de Salt ejecuta la versión 3002 o una anterior, debe actualizar la versión de Salt antes de poder usar el área de trabajo Complementos principales. Consulte Actualizar Salt para obtener más información.
  • Asegúrese de que el maestro de Salt ejecute la versión 8.11.2 o posterior del complemento principal. Si el maestro de Salt ejecuta la versión 8.11.1 o una anterior, debe actualizar manualmente el complemento para poder usar el área de trabajo Complementos principales. Para obtener más información, consulte Actualizar el complemento principal mediante la CLI.

Actualizar el complemento principal

Puede actualizar la versión del complemento principal en uno o varios maestros de Salt.

Nota:

Solo puede actualizar la versión del complemento principal a través del área de trabajo Complementos principales si el estado del complemento es Actualización necesaria. Si el estado del complemento indica que el maestro de Salt requiere intervención manual, debe iniciar sesión en el maestro de Salt para resolver el problema. Consulte Solucionar problemas de actualizaciones de complementos para obtener más información.

Para actualizar el complemento principal:

  1. En SaltStack Config, seleccione Administración > Complementos principales.
  2. Seleccione un maestro de Salt con un estado del complemento Actualización necesaria.
  3. Haga clic en Actualizar.
  4. Revise la información del cuadro de diálogo para asegurarse de que seleccionó el maestro de Salt correcto.
  5. Haga clic en Actualizar.
  6. Para supervisar el progreso de la actualización, haga clic en el JID de la última actualización.
  7. En el área de trabajo Complementos principales, confirme que el estado del complemento haya cambiado a Actualizado.

    Si la actualización falla, consulte Solucionar problemas de actualizaciones de complementos.

Solucionar problemas de actualizaciones de complementos

Si se produce un error en la actualización del complemento, debe resolver el problema manualmente iniciando sesión en el maestro de Salt. No existe ninguna reversión automatizada para las actualizaciones de complementos con errores.

Las actualizaciones del complemento pueden fallar debido a:
  • Problemas de infraestructura
  • Problemas de configuración con máquinas virtuales
  • Problemas de conexión con el maestro de Salt

Siga estos pasos para identificar la causa de la actualización fallida:

  1. Compruebe el JID de la última actualización y revise los datos sin procesar para detectar errores.
  2. Ejecte systemctl status salt-master para comprobar el estado del servicio salt-master.
  3. Ejecute salt-master -l debug para iniciar el maestro de Salt en modo de depuración.
  4. Descargue el complemento principal del área de trabajo Complementos principales e instale manualmente el complemento.