Início Rápido: implantar a versão prévia do Azure Operator 5G Core

A versão prévia do Azure Operator 5G Core é implantada usando o provedor de recursos (RP) do Azure Operator 5G Core, que usa scripts do Bicep agrupados junto com arquivos de parâmetro vazios para cada recurso do Mobile Packet Core.

• Microsoft.MobilePacketCore/clusterServices – serviços PaaS por cluster
• Microsoft.MobilePacketCore/observabilityServices - serviços PaaS de observabilidade por cluster (elastic/elastalert/kargo/kafka/etc)
• Microsoft.MobilePacketCore/amfDeployments - função de rede AMF/MME
• Microsoft.MobilePacketCore/smfDeployments – função de rede SMF
• Microsoft.MobilePacketCore/nrfDeployments – função de rede NRF
• Microsoft.MobilePacketCore/nssfDeployments – função de rede NSSF
• Microsoft.MobilePacketCore/upfDeployments – função de rede UPF

Pré-requisitos

Antes de poder implantar com êxito o Azure Operator 5G Core, você deve:

• Registre e verifique os provedores de recursos para os namespaces HybridNetwork e MobilePacketCore.
• Conceda acesso de colaborador à entidade de serviço "Mobile Packet Core" no nível da assinatura (observe que este é um requisito temporário até que a etapa seja inserida como parte do registro de RP).
• Certifique-se de que os planos de rede, sub-rede e IP estejam prontos para os arquivos de parâmetro de recurso.

Conclua as etapas encontradas em Pré-requisitos para implantar o Azure Operator 5G Core Preview no Serviço de Kubernetes do Azure do Nexus

Pós-criação de cluster

Depois de concluir as etapas de pré-requisito e criar um cluster, você deverá habilitar os recursos usados para implantar o Azure Operator 5G Core. O fornecedor de recursos Azure Operator 5G Core gere o cluster remoto através de comunicações de linha de visão através do Azure ARC. A carga de trabalho do Azure Operator 5G Core é implantada através de serviços de operador de leme fornecidos pelo Network Function Manager (NFM). Para habilitar esses serviços, o cluster deve estar habilitado para ARC, a extensão NFM Kubernetes deve ser instalada e um local personalizado do Azure deve ser criado. Os seguintes comandos CLI do Azure descrevem como habilitar esses serviços. Execute os comandos em qualquer prompt de comando exibido ao entrar usando o comando az login.

Habilitar ARC o cluster

O ARC é usado para permitir a comunicação do fornecedor de recursos do Operador Azure Operator 5G Core para Kubernetes. Você deve ter acesso ao arquivo kubeconfig do cluster ou ao servidor API Kubernetes para executar o comando conectadoK8s. Consulte Utilize o controlo de acesso baseado em funções do Azure para definir o acesso ao ficheiro de configuração Kubernetes no Serviço Azure Kubernetes (AKS) para informações.

Habilitar ARC o cluster para serviços Azure Kubernetes

Utilize o seguinte comando CLI do Azure:

$ az connectedk8s connect --name <ARC NAME> --resource-group <RESOURCE GROUP> --custom-locations-oid <LOCATION> --kube-config <KUBECONFIG FILE>

Habilitar ARC o cluster para Nexus Azure Kubernetes Services

Recupere o ID do cluster conectado do Nexus AKS com o comando a seguir. Você precisa desse ID de cluster para criar o local personalizado.

$ az connectedk8s show -n <NAKS-CLUSTER-NAME> -g <NAKS-RESOURCE-GRUP>  --query id -o tsv

Instale a extensão Kubernetes do Network Function Manager

Execute o seguinte comando CLI do Azure para instalar a extensão Kubernetes do Network Function Manager (NFM):

$ az k8s-extension create
--name networkfunction-operator \
--cluster-name <YourArcClusterName> \ 
--resource-group <YourResourceGroupName> \
--cluster-type connectedClusters \
--extension-type Microsoft.Azure.HybridNetwork \
--auto-upgrade-minor-version true \
--scope cluster \
--release-namespace azurehybridnetwork \
--release-train preview \
--config Microsoft.CustomLocation.ServiceAccount=azurehybridnetwork-networkfunction-operator

Substitua YourArcClusterName pelo nome do cluster do Kubernetes habilitado para Azure/Nexus Arc e YourResourceGroupName pelo nome do grupo de recursos.

Crie um local personalizado do Azure

Insira o seguinte comando da CLI do Azure para criar um local personalizado do Azure:

$ az customlocation create \
  -g <YourResourceGroupName> \
  -n <YourCustomLocationName> \
  -l <YourAzureRegion> \ 
  --namespace azurehybridnetwork 
  --host-resource-id
/subscriptions/<YourSubscriptionId>/resourceGroups/<YourResourceGroupName>/providers/Microsoft.Kubernetes/connectedClusters/<YourArcClusterName> --cluster-extension-ids /subscriptions/<YourSubscriptionId>/resourceGroups/<YourResourceGroupName>/providers/Microsoft.Kubernetes/connectedClusters/<YourArcClusterName>/providers/Microsoft.KubernetesConfiguration/extensions/networkfunction-operator

Substitua YourResourceGroupName, YourCustomLocationName, YourAzureRegion, YourSubscriptionId e YourArcClusterName com o nome real do grupo de recursos, o nome do local personalizado, a região do Azure, a ID da assinatura e o nome do cluster do Kubernetes habilitado para Azure Arc, respectivamente.

Implantar o Azure Operator 5G Core por meio de scripts do Bicep

A implantação do Azure Operator 5G Core consiste em vários recursos, incluindo (clusterServices, amfDeployments, smfDeployments, upfDeployments, nrfDeployments, nssfDeployments e observabilityServices). Cada recurso é implantado por um script do Bicep individual e um arquivo de parâmetros correspondente. Fale com o seu contato de conta Microsoft para obter acesso aos arquivos necessários do Azure Operator 5G Core.

Desempacotar o arquivo zip fornece um script do Bicep para cada recurso do Azure Operator 5G Core e o arquivo de parâmetro correspondente. Observe o local do arquivo descompactado. As próximas seções descrevem os parâmetros que você precisa definir para cada recurso e como implantar por meio de comandos da CLI do Azure.

Preencha os arquivos de parâmetros

Os recursos do Mobile Packet Core são implantados por meio de scripts do Bicep que assumem parâmetros como entrada. As tabelas a seguir descrevem os parâmetros a serem fornecidos para cada tipo de recurso.

Parâmetros dos serviços de cluster

Parâmetros de implantações AMF

Parâmetros de implantação do SMF

Parâmetros de implantação da UPF

Parâmetros de implantação NRF

Parâmetros de implantação do NSSF

Parâmetros dos serviços de observabilidade

Implantar o Azure Operator 5G Core por meio do Azure Resource Manager

Você pode implantar recursos do Azure Operator 5G Core usando a CLI do Azure. O comando a seguir implanta um único recurso de núcleo de pacote móvel. Para implantar um ambiente AO5GC completo, todos os recursos devem ser implantados.

O comando de exemplo é executado para o recurso nrfDeployments. Comandos semelhantes são executados para os outros tipos de recursos (SMF, AMF, UPF, NRF, NSSF). Os componentes de observabilidade também podem ser implantados com o recurso de serviços de observabilidade fazendo outra solicitação. Há um total de sete recursos a serem implantados para uma implantação completa do Azure Operator 5G Core.

Implantar usando a CLI do Azure

Configure as seguintes variáveis de ambiente:

$ export resourceGroupName=<Name of resource group> 
$ export templateFile=<Path to resource bicep script> 
$ export resourceName=<resource Name> 
$ export location <Azure region where resources are deployed> 
$ export templateParamsFile <Path to bicep script parameters file>

Insira o seguinte comando para implantar o Azure Operator 5G Core:

az deployment group create \
--name $deploymentName \
--resource-group $resourceGroupName \
--template-file $templateFile \
--parameters $templateParamsFile

O seguinte mostra uma implantação de exemplo:

PS C:\src\teest> az deployment group create ` 
--resource-group ${ resourceGroupName } ` 
--template-file ./releases/2403.0-31-lite/AKS/bicep/nrfTemplateSecret.bicep ` 
--parameters resourceName=${ResourceName} ` 
--parameters locationName=${location} ` 
--parameters ./releases/2403.0-31-lite/AKS/params/nrfParams.json ` 
--verbose 

INFO: Command ran in 288.481 seconds (init: 1.008, invoke: 287.473) 

{ 
 "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName /providers/Microsoft.Resources/deployments/nrfTemplateSecret", 
 "location": null, 
 "name": "nrfTemplateSecret", 
 "properties": { 
   "correlationId": "00000000-0000-0000-0000-000000000000", 
   "debugSetting": null, 
   "dependencies": [], 
   "duration": "PT4M16.5545373S", 
   "error": null, 
   "mode": "Incremental", 
   "onErrorDeployment": null, 
   "outputResources": [ 
     { 
       "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ resourceGroupName /providers/Microsoft.MobilePacketCore/nrfDeployments/test-505", 
       "resourceGroup": " resourceGroupName " 
     } 
   ], 

   "outputs": null, 
   "parameters": { 
     "locationName": { 
       "type": "String", 
       "value": " location " 
     }, 
     "replacement": { 
       "type": "SecureObject" 
     }, 
     "resourceName": { 
       "type": "String", 
       "value": " resourceName " 
     } 
   }, 
   "parametersLink": null, 
   "providers": [ 
     { 
       "id": null, 
       "namespace": "Microsoft.MobilePacketCore", 
       "providerAuthorizationConsentState": null, 
       "registrationPolicy": null, 
       "registrationState": null, 
       "resourceTypes": [ 
         { 
           "aliases": null, 
           "apiProfiles": null, 
           "apiVersions": null, 
           "capabilities": null, 
           "defaultApiVersion": null, 
           "locationMappings": null, 
           "locations": [ 
             " location " 
           ], 
           "properties": null, 
           "resourceType": "nrfDeployments", 
           "zoneMappings": null 
         } 
       ] 
     } 
   ], 
   "provisioningState": "Succeeded", 
   "templateHash": "3717219524140185299", 
   "templateLink": null, 
   "timestamp": "2024-03-12T16:07:49.470864+00:00", 
   "validatedResources": null 
 }, 
 "resourceGroup": " resourceGroupName ", 
 "tags": null, 
 "type": "Microsoft.Resources/deployments" 
} 

PS C:\src\test>

Próxima etapa

• Monitore o status da implantação do Azure Operator 5G Core Preview