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 Automation 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 da ú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 Usando a API para obter mais informações.

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

O RaaS 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 Automation Config está disponível. Você mesmo deve iniciar o processo de atualização. Como prática recomendada, você deve atualizar para a versão mais recente do plug-in quando ela 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 gerente de inicialização da sua 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. Se você não reiniciar 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 seu mestre Salt. Para obter mais informações, consulte Instalar e configurar o Master Plugin.
  • Verifique se a chave do mestre Salt foi aceita na interface de usuário do Automation 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 root, a atualização falhará.
  • Certifique-se de que seu mestre Salt esteja executando o Salt versão 3002.1 ou posterior. Se o mestre Salt estiver executando a versão 3002 ou anterior, você deverá atualizar a versão do Salt antes de poder usar o espaço de trabalho 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 mestre Salt estiver executando a versão 8.11.1 ou anterior, você deverá fazer upgrade do plug-in manualmente antes de poder usar o espaço de trabalho Master Plugins. Para obter mais informações, consulte Fazer upgrade do Master Plugin usando a CLI.

Atualizar o Master Plugin

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

Observação:

Você apenas 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 com atualizações de plug-ins para obter mais informações.

Para atualizar o Master Plugin:

  1. No Automation Config, selecione Administração > Master Plugins.
  2. Selecione um mestre 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 da última atualização.
  7. No espaço de trabalho Master Plugins, confirme se o status do plug-in mudou para Atualizado.

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

Solucionar problemas com atualizações de plug-ins

Se a atualização do seu plug-in falhar, 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 de plug-ins 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 o JID da última atualização e revise os dados brutos em busca de 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.