Atualizações de pods do Horizon Cloud: etapas para compatibilidade e suporte contínuos de agentes

Este artigo descreve a importância de garantir que os agentes instalados em imagens, farms e áreas de trabalho VDI do pod permaneçam compatíveis com a versão do manifesto de seu pod e descreve as soluções que você deve usar para evitar problemas de compatibilidade relacionados ao agente.

Antes de iniciar uma atualização do pod, você deve atualizar os agentes até que todos os indicadores de ponto azul no console tenham desaparecido. Em seguida, após a atualização do pod, se descobrir que qualquer indicador de ponto azul retornou no console, você deverá atualizar esses agentes novamente.

Dica: O objetivo é remover todos os indicadores de ponto azul exibidos no console, antes de uma atualização do pod e também depois dela.

Sua responsabilidade

Conforme descrito no Guia de Serviços em Nuvem, você é responsável por garantir a proteção adequada do conteúdo implantado ou acessado com o Serviço em Nuvem, incluindo, entre outros, a aplicação de patches das máquinas virtuais que compõem suas imagens e atribuições (pools). Se você não garantir que os agentes em imagens, farms e atribuições de área de trabalho do pod sejam atualizados para a versão mais recente do agente compatível com a versão do pod, o pod estará em uma configuração não compatível.

Portanto, antes de uma atualização do pod começar, você deve garantir que os agentes sejam atualizados para as versões mais recentes do agente. Além disso, após a conclusão da atualização do pod, você deve garantir que nenhum indicador de ponto azul tenha retornado no console. Se vir que os indicadores de ponto azul retornaram na exibição do console, você deverá atualizar novamente os agentes para os itens indicados.

Remover todos os pontos azuis antes da manutenção agendada da atualização do pod e depois dela

No console, examine os conjuntos de VMs de imagem, os farms e as atribuições de área de trabalho VDI. Há indicadores de ponto azul? O console exibirá um indicador de ponto azul ao lado de imagens e atribuições de área de trabalho VDI dedicadas em que o agente não está atualizado. O objetivo é remover todos os indicadores de ponto azul antes que o pod seja atualizado para uma nova versão do manifesto.

A captura de tela a seguir ilustra o tipo de ponto azul a ser procurado.

• Antes de a atualização do pod começar, execute os procedimentos do Agente de Atualização para remover todos os pontos azuis

  Execute os fluxos de trabalho Atualizar Agente até chegar a zero ponto azul. No console, você pode examinar todas as listas de VMs nas páginas de detalhes dos farms e nas páginas de detalhes das atribuições de área de trabalho VDI para confirmar que eles estão usando a versão de agente compatível mais alta. Siga todas as instruções descritas em cada um dos tópicos:

  • Execute o Agente de Atualização nas imagens que têm pontos azuis. Para saber as etapas específicas a serem executadas para atualizar uma imagem, consulte Agentes de Atualização para farms RDSH, Agentes de Atualização para imagens de área de trabalho VDI dedicadas e Agentes de Atualização para imagens de área de trabalho VDI flutuantes.
  • Edite farms e atribuições de área de trabalho VDI para usar essas imagens atualizadas em vez da imagem atual. Essa etapa atualiza todo o farm, as VMs de área de trabalho VDI flutuantes e as VMs de área de trabalho VDI dedicadas não atribuídas para usar as imagens com a nova versão do agente.
  • Execute o Agente de Atualização nas atribuições de área de trabalho VDI dedicadas para atualizar as VMs de área de trabalho VDI dedicada atribuídas à nova versão do agente. Consulte Agentes de Atualização para áreas de trabalho VDI dedicadas atribuídas. Depois que você conclui esses procedimentos, as VMs do farm, as VMs de área de trabalho em atribuições de área de trabalho VDI flutuantes e as VMs de área de trabalho não atribuídas nas atribuições de área de trabalho VDI dedicadas devem ser atualizadas e executar a mais recente versão do agente compatível. No console, você pode examinar todas as listas de VMs nas páginas de detalhes dos farms e nas páginas de detalhes das atribuições de área de trabalho VDI para confirmar.

• Após a conclusão da atualização do pod, verifique se há pontos azuis. Em seguida, execute os procedimentos do Agente de Atualização para remover todos os pontos azuis

  Por que os indicadores de ponto azul poderão retornar no console após uma atualização do pod se você os remover antes da atualização do pod? Porque, quando um novo manifesto de pod é lançado, uma nova versão do agente também é lançada. Essa combinação de manifesto de pod e versão de agente é usada para a configuração do agente de pod compatível.

  No entanto, o processo de atualização do pod que leva um pod existente para esse novo nível de manifesto de pod não afeta os agentes já instalados nas VMs de imagem, de farm e de área de trabalho VDI existentes desse pod. Esses agentes ainda estarão em suas versões anteriores instaladas, que podem ou não ser compatíveis com esse manifesto de pod. Se suas VMs de farm e de área de trabalho forem versões criadas no passado, de modo que a atualização do pod avance o pod para uma versão acima da matriz de compatibilidade da versão do agente de pod, o pod estará em uma configuração não compatível.

  Veja um exemplo. A captura de tela a seguir mostra um exemplo de quando um pod que foi implantado durante a versão 2204 do serviço é atualizado para a versão 2404 do serviço. A versão do agente que é a versão mais recente padrão para esse pod será incompatível (caixa cinza) quando o pod for atualizado para a versão 2404 do serviço.

  

Como saber qual é a versão mais recente do agente disponível para um manifesto de pod específico

Para cada pod, o gerenciador de pods faz um emparelhamento com o agente que está instalado em uma VM de imagem, de farm e de área de trabalho VDI e em uma VM importada (quando a ação de emparelhamento do agente foi executada nessa VM importada). Esse emparelhamento baseia-se na comunicação segura necessária entre o gerenciador de pods e essas VMs. Uma nova versão do agente é lançada ao mesmo tempo que uma nova versão (manifesto) do software do gerenciador de pods, e ambas as versões são compatíveis uma com a outra. Ao mesmo tempo, cada nova versão do software do gerenciador de pods destina-se a ser compatível com algumas versões anteriores do agente. Isso significa que o software do gerenciador de pods mais recente pode continuar a se comunicar com e interoperar com agentes mais antigos até um certo ponto. Quando a diferença entre o software de gerenciador de pods mais recente e os agentes mais antigos fica muito grande, a comunicação e a interoperabilidade entre o gerenciador de pods e esses agentes é interrompida.

Para determinar a interoperabilidade de uma versão específica do agente com um manifesto de pod específico para um dos seus pods, você precisa relatar informações de vários pontos: a versão do manifesto do pod, a versão do produto chamado Horizon Cloud no Microsoft Azure em que a versão do manifesto do pod foi lançada e a versão do Horizon Agents Installer (HAI). O software do HAI instala o software do agente nas VMs importadas, nas VMs de imagem, nas VMs de farm e nas VMs de área de trabalho VDI do pod.

1. Primeiro, use a página Capacidade ou a página de detalhes do pod para obter a versão do manifesto do pod.
2. Em seguida, abra as Notas da versão do Horizon Cloud de primeira geração e procure na página essa versão do manifesto para localizar a seção "Atualizar" na qual esse manifesto foi lançado.
3. Na mesma seção, localize o número da versão exibido após o nome do produto Horizon Cloud no Microsoft Azure, como 2201.
4. Em seguida, acesse as Matrizes de interoperabilidade de produto e selecione para comparar Horizon Cloud no Microsoft Azure com Horizon Agents Installer.
   • Horizon Cloud no Microsoft Azure na seção Comparar .
   • Horizon Agents Installer na seção Com .

Se a sua combinação de manifesto de pod e versão do agente na matriz ficar fora de um ponto verde, os problemas inesperados com as VMs no pod que estão executando essas versões do agente provavelmente ocorrerão.

• Exemplo

  Imagine um pod que está executando o manifesto 3821.x. De acordo com as Notas da versão, esse manifesto foi lançado no Horizon Cloud no Microsoft Azure 2210. A matriz ilustra que o pod interoperará com a versão do agente com a qual foi lançado (22.3) e com as versões anteriores do agente 22.2, 22.1.0, 21.3 e 21.2. Na seção Notas da Versão — 25 de outubro de 2022, é possível ver que a versão 22.3 do HAI foi lançada ao mesmo tempo que essa Horizon Cloud na versão 2210 do Microsoft Azure. Neste exemplo, a matriz está indicando que o agente mais antigo com o qual um pod do 3821.x pode operar é o agente 21.2. O agente mais recente é o 22.3. Antes de atualizar um pod que executa o 3821.x, a boa prática é garantir que os agentes nas VMs de imagem, de farm e de área de trabalho VDI sejam atualizados para a versão do agente mais recente indicada na respectiva coluna.

  A seguinte captura de tela é uma ilustração do parágrafo anterior e da matriz de compatibilidade como era no momento da redação deste artigo.