Commissiona il cluster del servizio Azure Kubernetes

Le istanze di base del pacchetto nel servizio 5G Core privato di Azure vengono eseguite in un cluster di servizio Azure Kubernetes (AKS) abilitato per Arc in un dispositivo Azure Stack Edge (A edizione Standard). Questa guida pratica illustra come commissionare il cluster del servizio Azure Kubernetes in A edizione Standard in modo che sia pronto per distribuire un'istanza di core del pacchetto.

Prerequisiti

• Completare le attività preliminari per la distribuzione di una rete mobile privata.
• Sarà necessaria l'autorizzazione Proprietario per il gruppo di risorse per la risorsa Azure Stack Edge.

  Nota

  Prendere nota del gruppo di risorse di Azure Stack Edge. Il cluster del servizio Azure Kubernetes e la posizione personalizzata, creati in questa procedura, devono appartenere a questo gruppo di risorse.

• Esaminare il ridimensionamento delle macchine virtuali di Azure Stack Edge per assicurarsi che a edizione Standard sia disponibile spazio sufficiente per commissionare il cluster.

Configurare Kubernetes per MEC privato di Azure nel dispositivo Azure Stack Edge

Questi passaggi modificano il cluster Kubernetes nel dispositivo Azure Stack Edge per ottimizzarlo per i carichi di lavoro MEC privati di Azure.

1. Nell'interfaccia utente locale selezionare Kubernetes nel menu a sinistra.
2. In Scegliere l'opzione che descrive meglio lo scenario selezionare una soluzione MEC privata di Azure nell'ambiente in uso.
3. Nella finestra popup di conferma del carico di lavoro selezionare Conferma di eseguire MEC privato di Azure nell'ambiente e fare clic su Applica per chiudere il popup.
4. Fare clic su Applica per salvare le modifiche.

Dopo aver applicato queste modifiche, nell'interfaccia utente locale dovrebbe essere visualizzata un'opzione aggiornata. Kubernetes diventa Kubernetes (anteprima), come illustrato nell'immagine seguente.

Se si passa al portale di Azure e si passa alla risorsa Azure Stack Edge, verrà visualizzata un'opzione servizio Azure Kubernetes. Il servizio Azure Kubernetes verrà configurato in Avviare il cluster e configurare Arc.

Configurare la rete avanzata

È ora necessario configurare commutatori virtuali e reti virtuali in tali commutatori. Per eseguire questa attività si userà la sezione Rete avanzata dell'interfaccia utente locale di Azure Stack Edge.

È possibile immettere tutte le impostazioni in questa pagina prima di selezionare Applica nella parte inferiore per applicarle tutte contemporaneamente.

2. Creare reti virtuali che rappresentano le interfacce seguenti (per cui sono state allocate subnet e indirizzi IP in Allocare subnet e indirizzi IP):

   • Interfaccia di accesso del piano di controllo
   • Interfaccia di accesso del piano utente
   • Interfacce dati del piano utente

   È possibile denominare manualmente queste reti, ma il nome deve corrispondere a quello configurato nella portale di Azure durante la distribuzione di Azure Private 5G Core. Ad esempio, è possibile usare i nomi N2, N3 e fino a dieci N6-DNX (dove X è il numero DN 1-10 in una distribuzione DN multipla o solo N6 per una singola distribuzione DN). Facoltativamente, è possibile configurare ogni rete virtuale con un identificatore di rete dell'area locale virtuale (ID VLAN) per abilitare la separazione del traffico di livello 2. L'esempio seguente è relativo a una distribuzione multi-DN 5G senza VLAN.

Aggiungere indirizzi IP e di calcolo

Nell'interfaccia utente locale di Azure Stack Edge passare alla pagina Kubernetes (anteprima). Si configurerà tutta la configurazione e quindi la si applicherà una sola volta, come è stato fatto in Configurare la rete avanzata.

1. In Commutatore virtuale di calcolo selezionare Modifica.
   1. Selezionare il vswitch con la finalità di calcolo (ad esempio, vswitch-port2)
   2. Immettere sei indirizzi IP in un intervallo per gli indirizzi IP del nodo nella rete di gestione.
   3. Immettere un indirizzo IP in un intervallo per l'indirizzo IP del servizio, anche nella rete di gestione. Verrà usato per accedere agli strumenti di monitoraggio locali per l'istanza di base del pacchetto.
   4. Selezionare Modifica nella parte inferiore del pannello per salvare la configurazione.
2. In Rete virtuale selezionare una rete virtuale da N2, N3, N6-DNX (dove X è il numero DN 1-10). Nel pannello laterale:
   1. Abilitare la rete virtuale per Kubernetes e aggiungere un pool di indirizzi IP.
   2. Per una distribuzione standard, aggiungere un intervallo di un indirizzo IP per l'indirizzo appropriato (N2, N3 o N6-DNX come raccolto in precedenza). Ad esempio, 10.10.10.20-10.10.10.20.
   3. Per una distribuzione a disponibilità elevata, aggiungere un intervallo di due indirizzi IP per ogni rete virtuale, in cui gli indirizzi IP dei pod N2 e N3 si trovano nella subnet di accesso locale e gli indirizzi IP dei pod N6 si trovano nella subnet dati locale appropriata.
   4. Ripetere la ripetizione per ognuna delle reti virtuali N2, N3 e N6-DNX.
   5. Selezionare Modifica nella parte inferiore del pannello per salvare la configurazione.
3. Selezionare Applica nella parte inferiore della pagina e attendere l'applicazione delle impostazioni. L'applicazione delle impostazioni richiederà circa 5 minuti.

La pagina dovrebbe ora essere simile all'immagine seguente:

Abilitare la gestione delle macchine virtuali in A edizione Standard

1. Accedere al portale di Azure e passare alla risorsa Azure Stack Edge creata nel portale di Azure.
2. Selezionare Servizi perimetrali.
3. Selezionare Macchine virtuali.
4. Selezionare Abilita.

Avviare il cluster e configurare Arc

Se si eseguono altre macchine virtuali in Azure Stack Edge, è consigliabile arrestarle ora e riavviarle dopo la distribuzione del cluster. Il cluster richiede l'accesso a risorse CPU specifiche che eseguono macchine virtuali potrebbero già essere in uso.

1. Accedere al portale di Azure e passare alla risorsa Azure Stack Edge creata nel portale di Azure.

2. Per distribuire il cluster, selezionare l'opzione Kubernetes e quindi selezionare il pulsante Aggiungi per configurare il cluster.

   

3. Per Dimensioni nodo selezionare Standard_F16s_HPN.

4. Verificare che la casella di controllo Kubernetes abilitata per Arc sia selezionata.

5. Selezionare il collegamento Cambia e immettere l'ID oggetto dell'applicazione Microsoft Entra (OID) per la posizione personalizzata ottenuta da Recupera l'ID oggetto (OID).

   

6. Il servizio Kubernetes con abilitazione di Arc viene creato automaticamente nello stesso gruppo di risorse della risorsa Azure Stack Edge . Se il gruppo di risorse di Azure Stack Edge non si trova in un'area che supporta Azure Private 5G Core, è necessario modificare l'area.

7. Fare clic su Configura per applicare la configurazione.

8. Controllare i campi Region e Microsoft Entra application Object ID (OID) mostrano i valori appropriati e quindi fare clic su Crea.

9. Eseguire le istruzioni per configurare il servizio.

La creazione del cluster Kubernetes richiede circa 20 minuti. Durante la creazione, potrebbe essere visualizzato un allarme critico nella risorsa Azure Stack Edge . Questo allarme è previsto e dovrebbe scomparire dopo alcuni minuti.

Dopo la distribuzione, il portale dovrebbe mostrare che il servizio Kubernetes è in esecuzione nella pagina di panoramica.

Configurare l'accesso kubectl

È necessario l'accesso kubectl per verificare che il cluster sia stato distribuito correttamente. Per l'accesso kubectl di sola lettura al cluster, è possibile scaricare un file kubeconfig dall'interfaccia utente locale A edizione Standard. In Dispositivo selezionare Scarica configurazione.

Il file scaricato viene chiamato config.json. Questo file dispone dell'autorizzazione per descrivere i pod e visualizzare i log, ma non per accedere ai pod con kubectl exec.

Configurare l'accesso al portale

Aprire la risorsa Azure Stack Edge nel portale di Azure. Passare al riquadro servizio Azure Kubernetes (illustrato in Avviare il cluster e configurare Arc) e selezionare il collegamento Gestisci per aprire il riquadro Arc.

Esplorare il cluster usando le opzioni nel menu risorse Kubernetes (anteprima):

Inizialmente verrà visualizzata una casella di richiesta di accesso. Il token da usare per l'accesso viene ottenuto dal file kubeconfig recuperato dall'interfaccia utente locale in Configurare l'accesso kubectl. È presente una stringa preceduta dal token: vicino alla fine del file kubeconfig . Copiare questa stringa nella casella nel portale (assicurandosi che non siano stati copiati caratteri di interruzione di riga) e selezionare Accedi.

È ora possibile visualizzare informazioni su ciò che è in esecuzione nel cluster. Di seguito è riportato un esempio del riquadro Carichi di lavoro :

Verificare la configurazione del cluster

È necessario verificare che il cluster del servizio Azure Kubernetes sia configurato correttamente eseguendo i comandi kubectl seguenti usando kubeconfig scaricato dall'interfaccia utente in Configurare l'accesso kubectl:

kubectl get nodes

Questo comando deve restituire due nodi, uno denominato nodepool-aaa-bbb e uno denominato target-cluster-control-plane-ccc.

Per visualizzare tutti i pod in esecuzione, eseguire:

kubectl get pods -A

Inoltre, il cluster del servizio Azure Kubernetes dovrebbe essere visibile dalla risorsa di Azure Stack Edge nel portale.

Raccogliere variabili per le estensioni Kubernetes

Raccogliere ognuno dei valori nella tabella seguente.

Installare le estensioni Kubernetes

La rete mobile privata di Azure 5G Core richiede una posizione personalizzata e estensioni Kubernetes specifiche che è necessario configurare usando l'interfaccia della riga di comando di Azure in Azure Cloud Shell.

1. Accedere all'interfaccia della riga di comando di Azure usando Azure Cloud Shell e selezionare Bash dal menu a discesa.

2. Impostare le variabili di ambiente seguenti usando i valori necessari per la distribuzione:

   SUBSCRIPTION_ID=<subscription ID>
   RESOURCE_GROUP_NAME=<resource group name>
   LOCATION=<deployment region, for example eastus>
   CUSTOM_LOCATION=<custom location for the AKS cluster>
   ARC_CLUSTER_RESOURCE_NAME=<resource name>
   TEMP_FILE=./tmpfile
   

3. Preparare l'ambiente shell:

   az account set --subscription "$SUBSCRIPTION_ID"
   az extension add --upgrade --name k8s-extension
   az extension add --upgrade --name customlocation
   

4. Creare l'estensione Kubernetes dell'operatore della funzione di rete:

   cat > $TEMP_FILE <<EOF
   {
     "helm.versions": "v3",
     "Microsoft.CustomLocation.ServiceAccount": "azurehybridnetwork-networkfunction-operator",
     "meta.helm.sh/release-name": "networkfunction-operator",
     "meta.helm.sh/release-namespace": "azurehybridnetwork",
     "app.kubernetes.io/managed-by": "helm",
     "helm.release-name": "networkfunction-operator",
     "helm.release-namespace": "azurehybridnetwork",
     "managed-by": "helm"
   }
   EOF 
   

   az k8s-extension create \
   --name networkfunction-operator \
   --cluster-name "$ARC_CLUSTER_RESOURCE_NAME" \
   --resource-group "$RESOURCE_GROUP_NAME" \
   --cluster-type connectedClusters \
   --extension-type "Microsoft.Azure.HybridNetwork" \
   --auto-upgrade-minor-version "true" \
   --scope cluster \
   --release-namespace azurehybridnetwork \
   --release-train preview \
   --config-settings-file $TEMP_FILE 
   

5. Creare l'estensione Kubernetes di Packet Core Monitor:

   az k8s-extension create \
   --name packet-core-monitor \
   --cluster-name "$ARC_CLUSTER_RESOURCE_NAME" \
   --resource-group "$RESOURCE_GROUP_NAME" \
   --cluster-type connectedClusters \
   --extension-type "Microsoft.Azure.MobileNetwork.PacketCoreMonitor" \
   --release-train stable \
   --auto-upgrade true 
   

6. Creare la posizione personalizzata:

   az customlocation create \
   -n "$CUSTOM_LOCATION" \
   -g "$RESOURCE_GROUP_NAME" \
   --location "$LOCATION" \
   --namespace azurehybridnetwork \
   --host-resource-id "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP_NAME/providers/Microsoft.Kubernetes/connectedClusters/$ARC_CLUSTER_RESOURCE_NAME" \
   --cluster-extension-ids "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP_NAME/providers/Microsoft.Kubernetes/connectedClusters/$ARC_CLUSTER_RESOURCE_NAME/providers/Microsoft.KubernetesConfiguration/extensions/networkfunction-operator"
   

La nuova posizione personalizzata verrà visualizzata come risorsa nel portale di Azure all'interno del gruppo di risorse specificato. L'uso del kubectl get pods -A comando (con accesso al file kubeconfig ) dovrebbe anche mostrare nuovi pod corrispondenti alle estensioni installate. Deve essere presente un pod nello spazio dei nomi azurehybridnetwork e uno nello spazio dei nomi packet-core-monitor .

Rollback

Se si è verificato un errore nella configurazione di Azure Stack Edge, è possibile usare il portale per rimuovere il cluster del servizio Azure Kubernetes . Vedere Distribuire il servizio Azure Kubernetes in Azure Stack Edge. È quindi possibile modificare le impostazioni tramite l'interfaccia utente locale.

In alternativa, è possibile eseguire una reimpostazione completa usando il pannello Reimpostazione del dispositivo nell'interfaccia utente locale (vedere Reimpostazione e riattivazione del dispositivo Azure Stack Edge) e quindi riavviare questa procedura. In questo caso, è anche necessario eliminare le risorse associate lasciate nel portale di Azure dopo aver completato la reimpostazione di Azure Stack Edge. Questo includerà alcuni o tutti gli elementi seguenti, a seconda della distanza del processo:

• Risorsa Azure Stack Edge
• KeyVault generato automaticamente associato alla risorsa Azure Stack Edge
• Archiviazione Account generato automaticamente associato alla risorsa Azure Stack Edge
• Cluster Azure Kubernetes (se creato correttamente)
• Percorso personalizzato (se creato correttamente)

Modifica della configurazione A edizione Standard dopo la distribuzione

Potrebbe essere necessario aggiornare la configurazione A edizione Standard dopo aver distribuito il core del pacchetto, ad esempio per aggiungere o rimuovere una rete dati collegata o per modificare un indirizzo IP. Per modificare la configurazione di A edizione Standard, eliminare definitivamente la posizione personalizzata e le risorse servizio Azure Kubernetes, apportare le modifiche alla configurazione A edizione Standard e quindi ricrearle. In questo modo è possibile disconnettere temporaneamente il core del pacchetto anziché eliminarlo e ricrearlo, riducendo al minimo la riconfigurazione necessaria. Potrebbe anche essere necessario apportare modifiche equivalenti alla configurazione del core del pacchetto.

1. Passare alla panoramica del gruppo di risorse nella portale di Azure (per il gruppo di risorse contenente il core del pacchetto). Selezionare la risorsa Packet Core Control Plane e selezionare Modify packet core (Modifica core pacchetto). Impostare Posizione personalizzata di Azure Arc su Nessuno e selezionareModifica.
2. Passare al gruppo di risorse contenente la risorsa Percorso personalizzato. Selezionare la casella di graduazione per la risorsa percorso personalizzato e selezionare Elimina. Conferma l'eliminazione.
3. Passare alla risorsa Azure Stack Edge e rimuovere tutte le configurazioni per il servizio Azure Kubernetes.
4. Accedere all'interfaccia utente locale di A edizione Standard e aggiornare la configurazione in base alle esigenze.
5. Ricreare il cluster Kubernetes. Vedere Avviare il cluster e configurare Arc.
6. Ricreare la risorsa percorso personalizzata. Selezionare la risorsa Packet Core Control Plane e selezionare Configura una posizione personalizzata.

Il core del pacchetto dovrebbe ora essere in servizio con la configurazione A edizione Standard aggiornata. Per aggiornare la configurazione di base del pacchetto, vedere Modificare un'istanza di base del pacchetto.

Passaggi successivi

Il dispositivo Azure Stack Edge è ora pronto per Azure Private 5G Core. Per una distribuzione a disponibilità elevata, è anche necessario configurare i router. In caso contrario, il passaggio successivo consiste nel raccogliere le informazioni necessarie per distribuire la rete privata.

• Configurare i router per una distribuzione a disponibilità elevata
• Raccogliere le informazioni necessarie per distribuire una rete mobile privata