Atualizar ponte de recursos do Arc

Artigo
10/05/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 gerenciado 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. A atualização gerenciada na nuvem ajuda a garantir que a VM do dispositivo seja mantida nas versões compatíveis com n-3, mas não na versão mais recente. Se você gostaria de estar na versão mais recente, você precisa atualizar manualmente. 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 sua ponte de recursos Arc estiver perto de ficar sem suporte, recomendamos uma atualização manual para garantir que você mantenha uma versão suportada, em vez de esperar pela atualização gerenciada na nuvem.

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

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.15 e superior. Os dispositivos que executam uma versão inferior a 1.0.15 precisam executar a opção de recuperação para chegar à versão 1.0.15 ou superior. Analise as etapas para executar a operação de recuperação. Isso implanta uma nova ponte de recursos e reconecta recursos pré-existentes do Azure.

Pré-requisitos

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

A ponte de recursos do Arc deve estar online e saudável com um status de Running. Você pode verificar o recurso do Azure da sua ponte de recursos Arc para verificar.
As credenciais na VM do dispositivo devem ser válidas. Para testar as credenciais, execute uma operação em uma VM habilitada para Arc do Azure.
A ponte de recursos do Arc deve estar no mesmo caminho do local onde foi implantada originalmente.
A VM do dispositivo precisa de 35 GB de espaço livre.
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.
(Apenas atualização manual) Ao executar uma atualização manual, execute o comando upgrade a partir da máquina de gerenciamento usada para implantar inicialmente a ponte de recursos Arc. Os arquivos de configuração do dispositivo criados inicialmente na implantação também são necessários. Você também pode executar o comando upgrade de uma máquina diferente que atenda aos requisitos da máquina de gerenciamento.
(Apenas atualização manual) A máquina de gerenciamento precisa de 3,5 GB de espaço livre.

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 é um processo que consiste em várias etapas: 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 sua ponte de recursos Arc estiver perto de ficar sem suporte, recomendamos uma atualização manual para garantir que você mantenha uma versão suportada, em vez de esperar 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ê precisa 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 Local, faça a transição para 23H2 e use a ferramenta interna de gerenciamento de atualização. Para obter mais informações, consulte Sobre atualizações para o Azure Local, versão 23H2.

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 do Arc.

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. Uma ponte de recursos Arc em uma versão sem suporte deve ser atualizada ou reimplantada 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 Arc.

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. Nem sempre é 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 podem não ser mais 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.

Partilhar via