Atualizar a instância principal do pacote em um site - modelo ARM

  • Artigo

Cada site do Azure Private 5G Core contém uma instância de núcleo de pacote, que é uma implementação nativa da nuvem do 5G Next Generation Core (5G NGC ou 5GC) definido pelos padrões 3GPP. Você precisará atualizar periodicamente suas instâncias de núcleo de pacote para obter acesso aos recursos mais recentes do Azure Private 5G Core e manter o suporte para sua rede móvel privada. Neste guia de instruções, você aprenderá como atualizar uma instância principal do pacote usando um modelo do Azure Resource Manager (modelo ARM).

Um modelo do Azure Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do seu projeto. O modelo utiliza sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

Se sua implantação contiver vários sites, recomendamos atualizar o núcleo do pacote em um único site primeiro e garantir que a atualização seja bem-sucedida antes de atualizar os núcleos de pacotes nos sites restantes.

Se seu ambiente atender aos pré-requisitos, você estiver familiarizado com o uso de modelos ARM e tiver planejado a atualização, selecione o botão Implantar no Azure . O modelo será aberto no portal do Azure.

Button to deploy the Resource Manager template to Azure.

Pré-requisitos

  • Você deve ter um núcleo de pacote em execução. Use as métricas da plataforma de monitoramento do Azure ou os painéis de núcleo de pacote para confirmar se sua instância de núcleo de pacote está funcionando normalmente.
  • Certifique-se de que pode iniciar sessão no portal do Azure utilizando uma conta com acesso à subscrição ativa que utilizou para criar a sua rede móvel privada. Essa conta deve ter a função interna de Colaborador ou Proprietário no escopo da assinatura.
  • Identifique o nome do site que hospeda a instância principal do pacote que você deseja atualizar.
  • Se você usar a ID do Microsoft Entra para autenticar o acesso às suas ferramentas de monitoramento local, verifique se sua máquina local tem acesso kubectl principal ao cluster Kubernetes habilitado para Azure Arc. Isso requer um arquivo kubeconfig principal, que você pode obter seguindo o acesso ao namespace Core.

Rever o modelo

O modelo utilizado neste início rápido pertence aos Modelos de Início Rápido do Azure. Para exibir o modelo, consulte azuredeploy.json.

O modelo modifica a versão de um recurso existente Microsoft.MobileNetwork/packetCoreControlPlanes. Isso causa uma desinstalação e reinstalação do núcleo do pacote com a nova versão do recurso. Nenhum outro recurso é modificado durante esse processo, a menos que você também altere a configuração da nova versão. O recurso fornece configuração para as funções de rede do plano de controle da instância principal do pacote, incluindo a configuração IP para a interface N2.

Planeje sua atualização

Recomendamos atualizar sua instância de núcleo de pacote durante uma janela de manutenção para minimizar o impacto da atualização em seu serviço.

Ao planejar sua atualização, certifique-se de que você está dando tempo suficiente para uma atualização e uma possível reversão no caso de quaisquer problemas. Uma atualização e reversão do núcleo do pacote podem levar até duas horas para serem concluídas.

Além disso, considere os seguintes pontos para as etapas pré e pós-atualização que você pode precisar planejar ao agendar sua janela de manutenção:

  • Consulte as notas de versão do núcleo do pacote para a versão do núcleo do pacote para a qual você está atualizando e se ele é suportado pela versão que o Azure Stack Edge (ASE) está executando no momento.
  • Se a sua versão do ASE for incompatível com a versão do núcleo do pacote para a qual você está atualizando, você precisará atualizar o ASE primeiro. Consulte Atualizar sua GPU do Azure Stack Edge Pro para obter a versão mais recente disponível do ASE.
    • Se você estiver executando atualmente uma versão de núcleo de pacote que a versão do ASE para a qual você está atualizando suporta, você pode atualizar o ASE e o núcleo do pacote independentemente.
    • Se você estiver executando uma versão de núcleo de pacote para a qual a versão do ASE para a qual você está atualizando não suporta, é possível que o núcleo do pacote não funcione normalmente com a nova versão do ASE. Nesse caso, recomendamos planejar uma janela de manutenção que permita que você tenha tempo para atualizar o ASE e o núcleo do pacote. Consulte Atualizar sua GPU do Azure Stack Edge Pro para saber quanto tempo a atualização do ASE levará.
  • Prepare um plano de teste com todas as etapas que você precisará seguir para validar sua implantação pós-atualização. Esse plano deve incluir o teste de alguns dispositivos e sessões registrados, e você o executará como parte da atualização Verificar.
  • Revise Restaurar informações de implantação de backup e Verificar atualização para as etapas pós-atualização que você precisará seguir para garantir que sua implantação esteja totalmente operacional. Certifique-se de que o seu plano de atualização permite tempo suficiente para estes passos.

Atualizar a instância principal do pacote

Fazer backup das informações de implantação

A lista a seguir contém os dados que serão perdidos durante uma atualização do núcleo do pacote. Faça backup de qualquer informação que você gostaria de preservar; Após a atualização, você pode usar essas informações para reconfigurar sua instância principal do pacote.

  1. Dependendo do seu método de autenticação ao entrar nos painéis de rastreamento distribuído e núcleo de pacotes:
    • Se você usar o Microsoft Entra ID, salve uma cópia do arquivo YAML do objeto secreto do Kubernetes criado em Criar objetos secretos do Kubernetes.
    • Se você usa nomes de usuário e senhas locais e deseja continuar usando as mesmas credenciais, salve uma cópia das senhas atuais em um local seguro. 
  2. Todos os rastreamentos são excluídos durante a atualização e não podem ser recuperados. Se quiser reter quaisquer vestígios, exporte-os e guarde-os de forma segura antes de continuar.
  3. Quaisquer personalizações feitas nos painéis principais do pacote não serão transferidas durante a atualização. Consulte Exportando um painel na documentação do Grafana para salvar uma cópia de backup de seus painéis.
  4. A maioria das UEs se registrará novamente automaticamente e recriará todas as sessões após a conclusão da atualização. Se você tiver dispositivos especiais que exijam operações manuais para se recuperar de uma interrupção do núcleo do pacote, reúna uma lista dessas UEs e suas etapas de recuperação.

Atualizar ASE

Se você determinou em Planejar sua atualização que precisa atualizar seu ASE, siga as etapas em Atualizar sua GPU do Azure Stack Edge Pro.

Atualizar núcleo do pacote

  1. Selecione o link a seguir para entrar no Azure e abrir o modelo.

    Button to deploy the Resource Manager template to Azure.

  2. Selecione ou insira os seguintes valores, usando as informações recuperadas em Pré-requisitos.

    • Subscrição: selecione a subscrição do Azure que utilizou para criar a sua rede móvel privada.
    • Grupo de recursos: selecione o grupo de recursos que contém o recurso de rede móvel que representa sua rede móvel privada.
    • Região: selecione a região na qual você implantou a rede móvel privada.
    • Núcleo de pacote existente: selecione o nome da instância do núcleo do pacote que você deseja atualizar.
    • Nova versão: insira a versão para a qual você deseja atualizar a instância principal do pacote.

    Screenshot of the Azure portal showing the configuration fields for the upgrade ARM template.

    Nota

    Se aparecer um aviso sobre uma incompatibilidade entre a versão principal do pacote selecionada e a versão atual do Azure Stack Edge, você precisará atualizar o ASE primeiro. Selecione Atualizar ASE no prompt de aviso e siga as instruções em Atualizar sua GPU do Azure Stack Edge Pro. Depois de concluir a atualização do ASE, volte ao início desta etapa para atualizar o núcleo do pacote.

  3. Selecione Rever + criar.

  4. O Azure agora validará os valores de configuração que você inseriu. Você verá uma mensagem indicando que seus valores passaram na validação.

    Se a validação falhar, você verá uma mensagem de erro e as guias Configuração contendo a configuração inválida serão sinalizadas. Selecione a(s) guia(s) sinalizada(s) e use as mensagens de erro para corrigir a configuração inválida antes de retornar à guia Revisar + criar .

  5. Depois que a configuração tiver sido validada, selecione Criar para atualizar a instância principal do pacote. O portal do Azure exibirá uma tela de confirmação quando a instância principal do pacote tiver sido atualizada.

Rever os recursos implementados

  1. Selecione Ir para o grupo de recursos.

    Screenshot of the Azure portal showing a deployment confirmation for the ARM template.

  2. Selecione o recurso Plano de Controle Principal de Pacote que representa a função de plano de controle da instância principal do pacote no site.

  3. Verifique o campo Versão sob o título Configuração para confirmar se ele exibe a nova versão do software.

Restaurar informações de implantação de backup

Reconfigure sua implantação usando as informações coletadas em Fazer backup das informações de implantação.

  1. Dependendo do seu método de autenticação ao entrar nos painéis de rastreamento distribuído e núcleo de pacotes:

  2. Se você fez backup de qualquer painel de núcleo de pacote, siga Importando um painel na documentação do Grafana para restaurá-los.

  3. Se você tiver UEs que exigem operações manuais para se recuperar de uma interrupção do núcleo do pacote, siga as etapas de recuperação.

Verificar atualização

Quando a atualização for concluída, verifique se a implantação está funcionando normalmente.

  1. Use as métricas da plataforma do Azure Monitor ou os painéis do núcleo do pacote para confirmar se sua instância principal do pacote está funcionando normalmente.
  2. Execute o plano de teste que preparou em Planejar a atualização.

Reversão

Se você encontrou problemas após a atualização, poderá reverter a instância principal do pacote para a versão anterior.

Nesta etapa, você reverterá o núcleo do pacote usando uma solicitação de API REST. Siga Reversão - portal do Azure se quiser reverter usando o portal do Azure.

Se qualquer uma das opções de configuração definidas enquanto a instância principal do pacote estava executando uma versão mais recente não for suportada na versão para a qual você deseja reverter, você precisará reverter para a configuração anterior antes de poder executar uma reversão. Verifique as notas de versão do núcleo do pacote para obter informações sobre quando novos recursos foram introduzidos.

  1. Certifique-se de ter um backup de suas informações de implantação. Se você precisar fazer backup novamente, siga as informações de implantação de backup.

  2. Execute uma solicitação POST de reversão.

    Gorjeta

    Para obter mais informações sobre como usar APIs REST, consulte Referência da API REST do Azure.

  3. Siga as etapas em Restaurar informações de implantação de backup para reconfigurar sua implantação.

  4. Siga as etapas em Verificar atualização para verificar se a reversão foi bem-sucedida.

Próximos passos

Você concluiu a atualização da instância principal do pacote.

  • Se sua implantação contiver vários sites, atualize a instância principal do pacote em outro site.
  • Use as métricas da plataforma Azure Monitor ou os painéis principais dopacote para monitorar sua implantação.