O espaço de trabalho Master Plugins fornece a capacidade de atualizar a versão do Master Plugin no seu mestre Salt para corresponder à versão do SaltStack Config. Esse recurso é compatível com implantações na nuvem e no local. Você também pode baixar a versão mais recente do Master Plugin.

O espaço de trabalho Master Plugins fornece informações sobre o status do plug-in, a versão do plug-in, a versão do Salt, o JID de última atualização e muito mais. A versão mais recente do sseapiclient também está disponível por meio do espaço de trabalho Master Plugins. Consulte Uso da API para obter mais informações.

O Master Plugin permite que os seus mestres Salt se comuniquem com o SaltStack Config. O plug-in também inclui uma variedade de configurações que você pode ajustar para melhorar o desempenho. Consulte a referência das definições de configuração do Master Plugin para obter mais informações.

O RaaS (serviço de recuperação de desastre) detém as versões atuais e anteriores do Master Plugin. Quando o mestre Salt se conecta ao RaaS, o mestre Salt verifica se o RaaS tem versões de plug-in que ele não tem. Se o mestre Salt não tiver essas versões de plug-in, o mestre Salt recuperará os plug-ins do RaaS e os armazenará em cache localmente no /var/cache/salt/master/plugin_cache/.

O plug-in não é atualizado automaticamente quando uma nova versão do SaltStack Config está disponível. Você mesmo deve iniciar o processo de atualização. Como prática recomendada, você deverá atualizar para a versão mais recente do plug-in quando ele estiver disponível.

O processo de atualização do Master Plugin depende do módulo service do Salt e do estado service.running para reiniciar o mestre Salt após a atualização do plug-in. O módulo service depende do seu gerente de inicialização de distribuição, como systemd.

Observação:

Se você estiver executando o mestre Salt em um contêiner ou em uma distribuição que não usa um gerenciador de inicialização, deverá reiniciar manualmente o mestre Salt após a atualização. Além disso, não é reiniciado o mestre Salt, o espaço de trabalho Master Plugins informará que o mestre Salt está executando uma versão de plug-in desatualizada.

Antes de começar

Antes de poder usar o espaço de trabalho Master Plugins, você deve concluir os seguintes pré-requisitos:

  • Instale o Master Plugin no mestre Salt. Consulte Instalar e configurar o Master Plugin para obter mais informações.
  • Verifique se a chave do mestre Salt foi aceita na interface de usuário do SaltStack Config.
  • Verifique se o mestre Salt está em execução como root. Se o mestre Salt estiver em execução como um usuário não raiz, a atualização falhará.
  • Certifique-se de que seu mestre Salt esteja executando o Salt versão 3002.1 ou posterior. Se o seu mestre Salt estiver executando a versão 3002 ou anterior, você deverá atualizar a versão do Salt antes de poder usar o Master Plugins. Consulte Fazer upgrade do Salt para obter mais informações.
  • Verifique se o seu mestre Salt está executando a versão 8.11.2 ou posterior do Master Plugin. Se o seu mestre Salt estiver executando o 8.11.1 ou anterior, você deverá fazer upgrade manualmente do plug-in do antes de poder usar o espaço de trabalho Master Plugins. Consulte Fazer upgrade do Master Plugin usando a CLI para obter mais informações.

Atualizar o Master Plugin

Você pode atualizar a versão do Master Plugin em um ou mais mestres Salt.

Observação:

Você só poderá atualizar a versão do Master Plugin por meio do espaço de trabalho Master Plugins se o status do plug-in for Precisa de atualização. Se o status do plug-in indicar que o mestre Salt requer intervenção manual, você deverá fazer login no mestre Salt para resolver o problema. Consulte Solucionar problemas de atualizações do plug-in para obter mais informações.

Para atualizar o Master Plugin:

  1. No SaltStack Config, selecione Administração > Master Plugins.
  2. Selecione um mestre do Salt com um status de plug-in Precisa de atualização.
  3. Clique em Atualizar.
  4. Revise as informações na caixa de diálogo para garantir que você selecionou o mestre Salt correto.
  5. Clique em Atualizar.
  6. Para monitorar o progresso da atualização, clique no JID de última atualização.
  7. No espaço de trabalho Master Plugins, confirme se o status do plug-in mudou para Até a data.

    Se a atualização falhar, consulte Solucionar problemas de atualizações do plug-in.

Solucionar problemas de atualizações do plug-in

Falha na atualização do plug-in. Você deverá resolver manualmente o problema fazendo login no mestre Salt. Não há reversão automatizada para atualizações de plug-in com falha.

As atualizações do plug-in podem falhar devido a:
  • Problemas de infraestrutura
  • Problemas de configuração com máquinas virtuais
  • Problemas de conexão com o mestre Salt

Tente as seguintes etapas para identificar a causa da falha na atualização:

  1. Verifique a JID de última atualização e revise os dados brutos em busca de quaisquer erros.
  2. Execute systemctl status salt-master para verificar o status do serviço salt-master.
  3. Execute salt-master -l debug para iniciar o mestre Salt no modo de depuração.
  4. Baixe o Master Plugin no espaço de trabalho Master Plugins e instale manualmente o plug-in.