Atualizar ponte de recursos do Arc

  • Artigo

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

Provedores de nuvem privada

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

Para o VMware vSphere habilitado para Arc, estão disponíveis a atualização manual e a atualização gerenciada na nuvem. Dispositivos na versão 1.0.15 e superiores são automaticamente optados pela atualização gerenciada pela nuvem. A atualização gerenciada na nuvem ajuda a garantir que a VM do dispositivo seja mantida em n-3 versões com suporte, mas não na versão mais recente. Para utilizar a versão mais recente, faça a atualização manual. Para que qualquer uma das opções de atualização funcione, os pré-requisitos de atualização devem ser atendidos. A Microsoft pode tentar executar uma atualização gerenciada pela nuvem da ponte de recursos do Arc a qualquer momento se o seu dispositivo ficar sem suporte em breve. Embora a Microsoft ofereça atualização gerenciada na nuvem, você ainda é responsável por garantir que a ponte de recursos do Arc esteja dentro das versões n-3 com suporte. As interrupções podem fazer com que a atualização gerenciada pela nuvem falhe e talvez seja necessário atualizar manualmente a ponte de recursos do Arc. Se sua ponte de recursos do Arc estiver quase sem suporte, recomendamos uma atualização manual para garantir que você mantenha uma versão com suporte, em vez de esperar pela atualização gerenciada pela nuvem.

Para o gerenciamento de VM do Azure Arc (versão prévia) no Azure Stack HCI, o dispositivo versão 1.0.15 ou superior só está disponível no Azure Stack HCI build 23H2. Na versão 23H2 (versão prévia), a ferramenta LCM gerencia as atualizações em todos os componentes do HCI, ponte de recursos do Arc e de 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 de ambiente do HCI pode causar problemas em seu ambiente que podem resultar em um cenário de recuperação de desastre. Para obter mais informações, veja Sobre atualizações do Azure Stack HCI.

Para o Microsoft 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. Dispositivos que executam uma versão anterior à 1.0.15 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. Isso implanta uma nova ponte de recursos e reconecta recursos pré-existentes do Azure.

Pré-requisitos

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

  • A VM do dispositivo precisa estar em uma versão de Disponibilidade Geral (1.0.15 ou superior). Caso contrário, a VM da ponte de recursos do Arc precisa ser reimplantada. Se você estiver usando VMware/AVS habilitado para Arc, você pode executar recuperação de desastres. Se você estiver usando o SCVMM habilitado para Arc, siga esse guia de recuperação de desastres.

  • A VM do dispositivo deve estar online e íntegra com um status de Running. Você pode verificar o recurso do Azure da ponte de recursos do Arc para confirmar.

  • As credenciais na VM do dispositivo devem estar atualizadas. Para testar se as credenciais na VM da ponte de recursos do Arc são válidas, execute uma operação em uma VM habilitada para Arc do Azure. Você também pode atualizar as credenciais para ter certeza.

  • Deve haver espaço suficiente no computador de gerenciamento (aproximadamente 3,5 GB) e na VM do dispositivo (35 GB) para baixar as imagens necessárias.

  • Para VMware habilitado para Arc, a atualização 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 dispositivo (k8snodeippoolstart/end, IP da VM 1/2) para msk8s.sb.tlu.dl.delivery.mp.microsoft.com, a porta 443, deve estar habilitada. Verifique se a lista completa de pontos de extremidade necessários para a ponte de recursos do Arc também está habilitada.

  • Ao executar uma atualização manual, execute o comando de atualização na máquina de gerenciamento usada para implantar inicialmente a ponte de recursos do Arc, que ainda deve conter os arquivos de configuração do dispositivo. Você também pode executar o comando de atualização de uma máquina diferente que atenda aos requisitos da máquina de gerenciamento e também contenha os arquivos de configuração do dispositivo.

  • As pontes de recursos do Arc configuradas com o DHCP não podem ser atualizadas e não são suportadas num ambiente de produção. Uma nova ponte de recursos do Arc deve ser implantada usando a configuração de IP estático.

Visão geral

O processo de atualização implanta uma nova ponte de recursos usando o IP da VM do dispositivo reservado (k8snodeippoolend IP, IP da VM 2). Depois que a nova ponte de recursos estiver pronta, ela se tornará a ponte de recursos ativa. A ponte de recursos antiga é excluída e seu IP da VM do dispositivo (k8dsnodeippoolstart, IP da VM 1) torna-se o novo IP da VM do 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 antiga VM do dispositivo e reservar o antigo IP para ser usado em 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 entrega entre a ponte de recursos do Arc antiga para a nova ponte de recursos do Arc. Um tempo de inatividade adicional poderá 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 do Arc.

Há duas maneiras de atualizar a ponte de recursos do Arc: atualizações gerenciadas pela 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 pela nuvem

As pontes de recursos do Arc em um provedor de nuvem privada com suporte com um dispositivo versão 1.0.15 ou superior são automaticamente incluídas na atualização gerenciada pela nuvem. Com a atualização gerenciada pela nuvem, a Microsoft poderá tentar atualizar sua ponte de recursos do Arc a qualquer momento se 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 pela nuvem funcione. Embora a Microsoft ofereça atualização gerenciada por nuvem, você ainda é responsável por verificar se a ponte de recursos está íntegra, online, em um status "Em execução" e dentro das versões n-3 com suporte. As interrupções podem fazer com que as atualizações gerenciadas pela nuvem falhem. Se sua ponte de recursos do Arc estiver quase sem suporte, recomendamos uma atualização manual para garantir que você mantenha uma versão com suporte, em vez de esperar pela atualização gerenciada pela nuvem.

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

As atualizações gerenciadas pela nuvem são tratadas por meio do Azure. Uma notificação é enviada por push para o Azure para refletir o estado da VM do dispositivo conforme ela é atualizada. À medida que a ponte de recursos avança 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 pela nuvem, verifique o recurso do Azure no ARM ou execute o seguinte comando da CLI do Azure no computador de gerenciamento:

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

Atualização manual

A ponte de recursos do Arc pode ser atualizada manualmente a partir do computador 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 kubeconfig e de configuração do dispositivo armazenados localmente, ou você não poderá executar a atualização.

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

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

az extension add --upgrade --name arcappliance

Para atualizar manualmente a ponte de recursos, use o comando a seguir:

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

Por exemplo, para atualizar 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 o 23H2 e use a ferramenta de gerenciamento de atualização integrada. Para obter mais informações, veja Sobre atualizações do Azure Stack HCI, versão 23H2.

Lançamentos da versão

A versão da ponte de recursos do 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 dispositivo, a versão da ponte de recursos do Arc é incrementada. Isso geralmente acontece quando uma nova versão de extensão da CLI az arcappliance é lançada. Uma nova extensão normalmente é lançada mensalmente no final do mês ou no início do mês. Para obter informações detalhadas sobre a versão, veja as notas de versão do Arc Resource Bridge.

Versões suportadas

Geralmente, há suporte para a versão mais recente lançada e para as três versões anteriores (n-3) da ponte de recursos do Arc. Uma ponte de recursos do 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 típicas com suporte n-3 serão:

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

Pode haver instâncias em que as versões com suporte não são sequenciais. Por exemplo, a versão 1.0.18 foi lançada e posteriormente descobriu-se que continha um bug. A versão 1.0.19 trouxe uma correção e a versão 1.0.18 foi removida. Nesse cenário, as versões n-3 com suporte se tornam 1.0.19, 1.0.17, 1.0.16, 1.0.15.

A ponte de recursos do Arc normalmente libera uma nova versão mensalmente, no final do mês, embora seja possível que os atrasos possam atrasar ainda mais a data de lançamento. Independentemente de quando uma nova versão for lançada, se você estiver nas versões suportadas por n-3, então sua versão da ponte de recursos Arc será suportada. Para se manter atualizado sobre os lançamentos, visite as notas de lançamento do Arc Resource Bridge.

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 será mais suportada. 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 do Arc podem não ser mais compatíveis. Além disso, a ponte de recursos sem suporte pode não ser capaz de fornecer métricas confiáveis de monitoramento e integridade.

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

Disponibilidade de notificação e atualização

Se a ponte de recursos do Arc estiver na versão n-3, você poderá receber uma notificação por email informando que a ponte de recursos ficará sem suporte quando 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 o tempo de depuração para quaisquer problemas com a atualização manual ou envie um tíquete de suporte se a atualização gerenciada pela 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 do Arc, execute az arcappliance show ou verifique o recurso do Azure da ponte de recursos do Arc.

Próximas etapas