Atualizar ponte de recursos do Arc

Artigo
03/10/2024

Este artigo descreve como a ponte de recursos Arc é atualizada e as duas maneiras de atualizar podem ser executadas: atualização gerenciada na nuvem ou atualização manual. Atualmente, alguns provedores de nuvem privada diferem em como lidam com atualizações de ponte de recursos do Arc.

Provedores de nuvem privada

Atualmente, os provedores de nuvem privada diferem em como executam atualizações de ponte de recursos Arc. Analise as informações a seguir para ver como atualizar sua ponte de recursos Arc para um provedor específico.

Para VMware vSphere habilitado para Arc, o upgrade manual e o upgrade na nuvem estão disponíveis. Os dispositivos na versão 1.0.15 e superior são automaticamente ativados para a atualização gerenciada na nuvem. Para que qualquer opção de atualização funcione, os pré-requisitos de atualização devem ser atendidos . A Microsoft pode tentar executar uma atualização gerenciada na nuvem da sua ponte de recursos Arc a qualquer momento se o seu dispositivo em breve estiver sem suporte. Embora a Microsoft ofereça atualização gerenciada na nuvem, você ainda é responsável por garantir que sua ponte de recursos Arc esteja dentro das versões n-3 suportadas. Interrupções podem fazer com que a atualização gerenciada na nuvem falhe e talvez seja necessário atualizar manualmente a ponte de recursos do Arc. Se você estiver perto de ficar sem suporte, atualize manualmente para permanecer nas versões suportadas.  Não espere pela atualização gerenciada na nuvem. Todos os dispositivos anteriores à versão 1.0.15 devem ser atualizados manualmente.

Para o gerenciamento de VM do Azure Arc (visualização) no Azure Stack HCI, a versão do dispositivo 1.0.15 ou superior só está disponível na compilação 23H2 do Azure Stack HCI. No HCI 23H2, a ferramenta LCM gerencia atualizações em todos os componentes HCI, ponte de recursos Arc e extensão como um pacote de "receita validada". Qualquer versão de visualização da ponte de recursos Arc deve ser removida antes da atualização de 22H2 para 23H2. A tentativa de atualizar a ponte de recursos do Arc independentemente de outros componentes do ambiente HCI pode causar problemas em seu ambiente que podem resultar em um cenário de recuperação de desastres. Para obter mais informações, visite a página de perguntas frequentes sobre gerenciamento do Arc VM.

Para o System Center Virtual Machine Manager (SCVMM) habilitado para Arc, o recurso de atualização manual está disponível para o dispositivo versão 1.0.14 e superior. Os aparelhos abaixo da versão 1.0.14 precisam executar a opção de recuperação para chegar à versão 1.0.15 ou superior. Examine as etapas para executar a operação de recuperação, exclua a VM do dispositivo do SCVMM e execute as etapas de recuperação. Isso implanta uma nova ponte de recursos e reconecta recursos pré-existentes do Azure.

Pré-requisitos

Antes de atualizar uma ponte de recursos Arc, os seguintes pré-requisitos devem ser atendidos:

A VM do dispositivo deve estar online, saudável com um status de "Em execução". Você pode verificar o recurso do Azure da sua ponte de recursos Arc para verificar.
As credenciais na VM do dispositivo devem estar atualizadas. Para testar se as credenciais dentro da VM de ponte de recursos Arc são válidas, execute uma operação em uma VM habilitada para Arc do Azure ou atualize as credenciais para ter certeza.
Deve haver espaço suficiente na máquina de gerenciamento (~3,5 GB) e na VM do dispositivo (35 GB) para baixar as imagens necessárias.
Para VMware habilitado para Arc, o upgrade da ponte de recursos requer 200 GB de espaço livre no armazenamento de dados. Um novo modelo também é criado.
A conexão de saída dos IPs da VM do Appliance (k8snodeippoolstart/end, VM IP 1/2) para a msk8s.sb.tlu.dl.delivery.mp.microsoft.comporta 443 deve ser habilitada. Certifique-se de que a lista completa de pontos de extremidade necessários para a ponte de recursos Arc também esteja ativada.
Se você estiver executando uma atualização manual, o comando upgrade deverá ser executado a partir da máquina de gerenciamento usada inicialmente para implantar a ponte de recursos Arc e ainda conterá os arquivos de configuração do dispositivo ou um que atenda aos requisitos da máquina de gerenciamento e também contenha os arquivos de configuração do dispositivo.
A ponte de recursos Arc configurada com DHCP não pode ser atualizada e não é suportada em um ambiente de produção. Em vez disso, uma nova ponte de recursos Arc deve ser implantada usando a configuração IP estática.

Descrição geral

O processo de atualização implanta uma nova ponte de recursos usando o dispositivo reservado VM IP (k8snodeippoolend IP, VM IP 2). Quando a nova ponte de recursos estiver ativa, ela se tornará a ponte de recursos ativa. A ponte de recursos antiga é excluída e seu IP de VM de dispositivo (k8dsnodeippoolstart, VM IP 1) se torna o novo IP de VM de dispositivo reservado que será usado na próxima atualização.

A implantação de uma nova ponte de recursos consiste em baixar a imagem do dispositivo (~3,5 GB) da nuvem, usar a imagem para implantar uma nova VM do dispositivo, verificar se a nova ponte de recursos está em execução, conectá-la ao Azure, excluir a VM do dispositivo antigo e reservar o IP antigo para ser usado para uma atualização futura.

No geral, a atualização geralmente leva pelo menos 30 minutos, dependendo da velocidade da rede. Um curto tempo de inatividade intermitente pode acontecer durante a transferência entre a antiga ponte de recursos do Arc para a nova ponte de recursos do Arc. Tempo de inatividade adicional pode ocorrer se os pré-requisitos não forem atendidos ou se uma alteração na rede (DNS, firewall, proxy, etc.) afetar a conectividade de rede da ponte de recursos Arc.

Há duas maneiras de atualizar a ponte de recursos do Arc: atualizações gerenciadas na nuvem gerenciadas pela Microsoft ou atualizações manuais em que os comandos da CLI do Azure são executados por um administrador.

Atualização gerenciada na nuvem

As pontes de recursos Arc em um provedor de nuvem privada suportado com um dispositivo versão 1.0.15 ou superior são automaticamente ativadas na atualização gerenciada pela nuvem. Com a atualização gerenciada na nuvem, a Microsoft pode tentar atualizar sua ponte de recursos Arc a qualquer momento se ela estiver em uma versão do dispositivo que em breve estará sem suporte. Os pré-requisitos de atualização devem ser atendidos para que a atualização gerenciada na nuvem funcione. Embora a Microsoft ofereça atualização gerenciada na nuvem, você ainda é responsável por verificar se sua ponte de recursos está íntegra, online, em um status "Em execução" e dentro das versões n-3 suportadas. As interrupções podem fazer com que as atualizações gerenciadas na nuvem falhem. Se você estiver perto de ficar sem suporte, atualize manualmente para permanecer nas versões suportadas.  Não espere pela atualização gerenciada na nuvem.

Para verificar o status da ponte de recursos e a versão do dispositivo, execute o az arcappliance show comando da máquina de gerenciamento ou verifique o recurso do Azure da ponte de recursos do Arc. Se a VM do seu dispositivo não estiver em um estado íntegro, em execução, a atualização gerenciada na nuvem poderá falhar.

As atualizações geridas na nuvem são tratadas através do Azure. Uma notificação é enviada por push para o Azure para refletir o estado da VM do dispositivo à medida que ela é atualizada. À medida que a ponte de recursos progride na atualização, seu status pode alternar entre diferentes etapas de atualização. A atualização é concluída quando a VM status do dispositivo é Running e provisioningState é Succeeded.

Para verificar o status de uma atualização gerenciada na nuvem, verifique o recurso do Azure em ARM ou execute o seguinte comando da CLI do Azure na máquina de gerenciamento:

az arcappliance show --resource-group [REQUIRED] --name [REQUIRED]

Atualização manual

A ponte de recursos Arc pode ser atualizada manualmente a partir da máquina de gerenciamento. Você deve atender a todos os pré-requisitos de atualização antes de tentar atualizar. A máquina de gerenciamento deve ter os arquivos de configuração kubeconfig e appliance armazenados localmente ou você não poderá executar a atualização.

A atualização manual geralmente leva entre 30 a 90 minutos, dependendo da velocidade da rede. O comando upgrade leva sua ponte de recursos Arc para a próxima versão do dispositivo, que pode não ser a versão mais recente disponível do dispositivo. Várias atualizações podem ser necessárias para alcançar uma versão suportada. Você pode verificar a versão do seu dispositivo verificando o recurso do Azure da sua ponte de recursos do Arc.

Antes de atualizar, você precisará da extensão mais recente da CLI do Azure para arcappliance:

az extension add --upgrade --name arcappliance

Para atualizar manualmente sua ponte de recursos, use o seguinte comando:

az arcappliance upgrade <private cloud> --config-file <file path to ARBname-appliance.yaml>

Por exemplo, para fazer upgrade de uma ponte de recursos no VMware, execute: az arcappliance upgrade vmware --config-file c:\contosoARB01-appliance.yaml

Para atualizar uma ponte de recursos no SCVMM, execute: az arcappliance upgrade scvmm --config-file c:\contosoARB01-appliance.yaml

Para atualizar uma ponte de recursos no Azure Stack HCI, faça a transição para 23H2 e use a ferramenta de gerenciamento de atualização interna. Mais informações disponíveis aqui.

Versões

A versão da ponte de recursos Arc está vinculada às versões dos componentes subjacentes usados na imagem do dispositivo, como a versão do Kubernetes. Quando há uma alteração na imagem do aparelho, a versão da ponte de recursos Arc é incrementada. Isso geralmente acontece quando uma nova az arcappliance versão da extensão CLI é lançada. Uma nova extensão normalmente é lançada em uma cadência mensal no final do mês ou no início do mês. Para obter informações detalhadas sobre a versão, consulte as notas de versão da ponte de recursos Arc no GitHub.

Versões suportadas

Geralmente, a versão lançada mais recente e as três versões anteriores (n-3) da ponte de recursos Arc são suportadas, a partir da versão 1.0.15 do dispositivo e em diante. Uma ponte de recursos Arc com uma versão do dispositivo anterior à 1.0.15 deve ser atualizada ou reimplantada para estar, no mínimo, na versão 1.0.15 do dispositivo para estar em uma janela de suporte de produção.

Por exemplo, se a versão atual for 1.0.18, as versões suportadas típicas do n-3 são:

Versão atual: 1.0.18
n-1 versão: 1.0.17
n-2 versão: 1.0.16
n-3 versão: 1.0.15

Pode haver casos em que as versões suportadas não sejam sequenciais. Por exemplo, a versão 1.0.18 é lançada e mais tarde encontrada para conter um bug. Um hot fix é lançado na versão 1.0.19 e a versão 1.0.18 é removida. Nesse cenário, n-3 versões suportadas tornam-se 1.0.19, 1.0.17, 1.0.16, 1.0.15.

Arc resource bridge normalmente lança uma nova versão em uma cadência mensal, no final do mês, embora seja possível que atrasos possam empurrar a data de lançamento ainda mais. Independentemente de quando uma nova versão for lançada, se você estiver dentro das versões suportadas pelo n-3, sua versão Arc resource bridge será suportada. Para se manter atualizado sobre as versões, visite as notas de versão da ponte de recursos do Arc no GitHub.

Se uma ponte de recursos não for atualizada para uma das versões suportadas (n-3), ela ficará fora da janela de suporte e não terá suporte. Se isso acontecer, nem sempre será possível atualizar uma ponte de recursos sem suporte para uma versão mais recente, pois os serviços de componentes usados pela ponte de recursos Arc não podem mais ser compatíveis. Além disso, a ponte de recursos sem suporte pode não ser capaz de fornecer monitoramento confiável e métricas de integridade.

Se uma ponte de recursos Arc não puder ser atualizada para uma versão suportada, você deverá excluí-la e implantar uma nova ponte de recursos. Dependendo do produto de nuvem privada que você está usando, pode haver outras etapas necessárias para reconectar a ponte de recursos aos recursos existentes. Para obter detalhes, consulte a documentação de recuperação da ponte de recursos Arc do produto parceiro.

Notificação e disponibilidade de atualização

Se sua ponte de recursos Arc estiver na versão n-3, você poderá receber uma notificação por e-mail informando que sua ponte de recursos estará fora de suporte assim que a próxima versão for lançada. Se você receber essa notificação, atualize a ponte de recursos o mais rápido possível para permitir tempo de depuração para quaisquer problemas com a atualização manual ou envie um tíquete de suporte se a atualização gerenciada na nuvem não puder atualizar sua ponte de recursos.

Para verificar se a ponte de recursos do Arc tem uma atualização disponível, execute o comando:

az arcappliance get-upgrades --resource-group [REQUIRED] --name [REQUIRED]

Para ver a versão atual de um dispositivo de ponte de recursos Arc, execute az arcappliance show ou verifique o recurso do Azure da sua ponte de recursos Arc.

Próximos passos

Saiba mais sobre as operações de manutenção da ponte de recursos Arc.
Saiba mais sobre como solucionar problemas da ponte de recursos do Arc.

Share via