Guida introduttiva: Distribuire una rete e un sito per dispositivi mobili privati - Interfaccia della riga di comando di Azure
Azure Private 5G Core è un servizio cloud di Azure per la distribuzione e la gestione delle funzioni di rete di base 5G in un dispositivo Azure Stack Edge, come parte di una rete mobile privata locale per le aziende. Questa guida introduttiva descrive come usare un'interfaccia della riga di comando di Azure per distribuire le risorse seguenti nell'area di Azure Stati Uniti orientali. Vedere Prodotti disponibili in base all'area per le aree di Azure in cui è disponibile Azure Private 5G Core.
- Una rete mobile privata.
- Un sito.
- Il servizio predefinito e i criteri allow-all SIM (come descritto in Servizio predefinito e criteri allow-all SIM).
- Facoltativamente, uno o più SIM e un gruppo SIM.
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.
Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito
- Completare le attività preliminari per la distribuzione di una rete mobile privata e la Commissione per il cluster del servizio Azure Kubernetes.
- Assicurarsi di poter accedere al portale di Azure usando un account con accesso alla sottoscrizione attiva identificata in Completare le attività dei prerequisiti per la distribuzione di una rete mobile privata. Questo account deve avere il ruolo predefinito Collaboratore o Proprietario nell'ambito della sottoscrizione.
- Raccogliere le informazioni necessarie per distribuire una rete mobile privata. Se si vuole effettuare il provisioning di MACCHINE VIRTUALI, è necessario preparare un file JSON contenente le informazioni sim, come descritto in Formato di file JSON per il provisioning di MACCHINE VIRTUALI.
- Identificare i nomi delle interfacce corrispondenti alle porte 5 e 6 nel dispositivo Azure Stack Edge Pro nel sito.
- Raccogliere le informazioni necessarie per un sito.
- Vedere le note sulla versione relative al Packet Core corrente per verificare se è compatibile con la versione di Azure Stack Edge (ASE) attualmente in esecuzione. Se la versione di ASE non è compatibile con il Packet Core più recente, aggiornare la GPU di Azure Stack Edge Pro.
Comandi dell'interfaccia della riga di comando di Azure usati in questo articolo
- az mobile-network create
- az mobile-network site create
- az mobile-network pccp create
- az mobile-network pcdp create
- az mobile-network data-network create
- az mobile-network sim group create
- az mobile-network slice create
- az mobile-network service create
- az mobile-network sim policy create
- az mobile network sim create
- az mobile-network attached-data-network create
Avviare Azure Cloud Shell
Azure Cloud Shell è una shell interattiva gratuita che può essere usata per eseguire la procedura di questo articolo. Include strumenti comuni di Azure preinstallati e configurati per l'uso con l'account.
Per aprire Cloud Shell, basta selezionare Prova nell'angolo superiore destro di un blocco di codice. È anche possibile avviare Cloud Shell in una scheda separata del browser visitando https://shell.azure.com.
Quando si apre Cloud Shell, verificare che Bash sia selezionato per l'ambiente in uso. Le sessioni successive useranno l'interfaccia della riga di comando di Azure in un ambiente Bash, selezionare Copia per copiare i blocchi di codice, incollarli in Cloud Shell e premere INVIO per eseguirlo.
Accedere ad Azure
Cloud Shell viene autenticato automaticamente con l'account iniziale con cui è stato eseguito l'accesso. Usare lo script seguente per accedere usando una sottoscrizione diversa, sostituendo <Subscription ID> con l'ID sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Per altre informazioni, vedere Impostare una sottoscrizione attiva o accedere in modo interattivo
Distribuire una rete mobile privata, un sito e una SIM
Per distribuire correttamente una rete mobile privata, un sito e una SIM, è necessario completare i passaggi seguenti. Ogni passaggio deve essere completato completamente prima di procedere con il passaggio successivo.
Creare una risorsa di rete mobile
Usare az mobile-network create per creare una nuova risorsa di rete mobile. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<MOBILENETWORK> |
Immettere un nome per la rete mobile privata. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
az mobile-network create --location eastus -n <MOBILENETWORK> -g <RESOURCEGROUP> --identifier mcc=001 mnc=01
Creare una risorsa sito
Usare az mobile-network site per creare una nuova risorsa sito . Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<MOBILENETWORK> |
Immettere il nome della rete mobile privata creata. |
<SITE> |
Immettere il nome del sito. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
az mobile-network site create --mobile-network-name <MOBILENETWORK> -n <SITE> -g <RESOURCEGROUP>
Creare una risorsa del piano di controllo di Packet Core
Usare az mobile-network pccp create per creare una nuova risorsa del piano di controllo pacchetti core. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<ASE> |
Immettere il nome del edizione Standard A. |
<CUSTOMLOCATION> |
Immettere il nome del percorso personalizzato. |
<MOBILENETWORK> |
Immettere il nome della rete mobile. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
<CONTROLPLANE> |
Immettere il nome del piano di controllo di base del pacchetto. |
<SITE> |
Immettere il nome del sito. |
<IPV4ADDRESS> |
Immettere l'indirizzo IPv4 del sito. |
Ottenere l'ID A edizione Standard e assegnarlo a una variabile.
ASE_ID=$(databoxedge device show --device-name <ASE> -g <RESOURCEGROUP> --query "id")
Ottenere l'ID percorso personalizzato e assegnarlo a una variabile.
CUSTOM_LOCATION_ID=$(customlocation show --name <CUSTOMLOCATION> -g <RESOURCEGROUP> --query "id")
Ottenere l'ID sito e assegnarlo a una variabile.
SITE_ID=$(mobile-network site show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SITE> --query "id")
Creare il piano di controllo di base del pacchetto.
az mobile-network pccp create -n <CONTROLPLANE> -g <RESOURCEGROUP> --access-interface name=N2 ipv4Address=<IPV4ADDRESS> --local-diagnostics authentication-type=Password --platform type=AKS-HCI azure-stack-edge-device="{id:$ASE_ID}" customLocation="{id:$CUSTOM_LOCATION_ID}" --sites "[{id:$SITE_ID}]" --sku G0 --location eastus
Creare una risorsa del piano dati packet core
Usare az mobile-network pcdp create per creare una nuova risorsa piano dati Packet Core. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<DATAPLANE> |
Immettere il nome del piano dati. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
<CONTROLPLANE> |
Immettere il nome del piano di controllo di base del pacchetto. |
az mobile-network pcdp create -n <DATAPLANE> -g <RESOURCEGROUP> --pccp-name <CONTROLPLANE> --access-interface name=N3
Creare una rete dati
Usare az mobile-network data-network create per creare una nuova risorsa di rete dati. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<DATANETWORK> |
Immettere il nome della rete dati. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
<MOBILENETWORK> |
Immettere il nome della rete mobile privata. |
az mobile-network data-network create -n <DATANETWORK> -g <RESOURCEGROUP> --mobile-network-name <MOBILENETWORK> --location eastus
Creare un gruppo SIM
Usare az mobile-network sim group create per creare una nuova risorsa piano dati Packet Core. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
Usare '' per creare un nuovo gruppo SIM. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Variabile | Segnaposto | Valore |
|---|---|---|
<MOBILENETWORK> |
Immettere il nome della rete mobile privata. | |
<SIMGROUP> |
Immettere il nome del gruppo sim. | |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
Ottenere l'ID di rete mobile e assegnarlo a una variabile.
NETWORK_ID=$(mobile-network show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Creare il gruppo SIM.
az mobile-network sim group create -n <SIMGROUP> -g <RESOURCEGROUP> --mobile-network "{id:$NETWORK_ID}"
Creare una sezione
Usare az mobile-network slice create per creare una nuova sezione. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<MOBILENETWORK> |
Immettere il nome della rete mobile privata. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
<SLICE> |
Immettere il nome della sezione. |
az mobile-network slice create --mobile-network-name <MOBILENETWORK> -n <SLICE> -g <RESOURCEGROUP> --snssai "{sst:1,sd:123abc}"
Creare un servizio
Usare az mobile-network service create per creare un nuovo servizio. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<SERVICE> |
Immettere il nome del servizio. |
<MOBILENETWORK> |
Immettere il nome della rete mobile privata. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
az mobile-network service create -n <SERVICE> -g <RESOURCEGROUP> --mobile-network-name <MOBILENETWORK> --pcc-rules "[{ruleName:default-rule,rulePrecedence:10,serviceDataFlowTemplates:[{templateName:IP-to-server,direction:Uplink,protocol:[ip],remoteIpList:[10.3.4.0/24]}]}]" --service-precedence 10
Creare un criterio SIM
Usare az mobile-network sim policy create per creare un nuovo criterio SIM. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<SLICE> |
Immettere il nome della sezione. |
<DATANETWORK> |
Immettere il nome della rete dati. |
<SERVICE> |
Immettere il nome del servizio. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
<SIMPOLICY> |
Immettere il nome per il criterio SIM. |
<MOBILENETWORK> |
Immettere il nome della rete mobile privata. |
Ottenere l'ID sezione e assegnarlo a una variabile.
SLICE_ID=$(mobile-network slice show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SLICE> --query "id")
Ottenere l'ID rete dati e assegnarlo a una variabile.
DATANETWORK_ID=$(mobile-network data-network show -n <DATANETWORK> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Ottenere l'ID del servizio e assegnarlo a una variabile.
SERVICE_ID=$(mobile-network service show -n <SERVICE> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Creare i criteri sim.
az mobile-network sim policy create -g <RESOURCEGROUP> -n <SIMPOLICY> --mobile-network-name <MOBILENETWORK> --default-slice '{id:$SLICE_ID}' --slice-config "[{slice:{id:$SLICE_ID},defaultDataNetwork:{id:$DATANETWORK_ID},dataNetworkConfigurations:[{dataNetwork:{id:$DATANETWORK_ID},allowedServices:[{id:$SERVICE_ID}],sessionAmbr:{uplink:'500 Mbps',downlink:'1 Gbps'}}]}]" --ue-ambr "{uplink:'500 Mbps',downlink:'1 Gbps'}" --location eastus
Creare una SIM
Usare az mobile-network sim create per creare una nuova SIM. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<SIMGROUP> |
Immettere il nome del gruppo SIM. |
<SIM> |
Immettere il nome della SIM. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
az mobile-network sim create -g <RESOURCEGROUP> --sim-group-name <SIMGROUP> -n <SIM> --international-msi 0000000000 --operator-key-code 00000000000000000000000000000000 --authentication-key 00000000000000000000000000000000
Collegare la rete dati
Usare az mobile-network attached-data-network create per collegare la rete dati creata. Il comando di esempio usa i valori segnaposto seguenti, sostituirli con le informazioni raccolte in Prerequisito: Preparare la distribuzione di una rete mobile privata e di un sito.
| Segnaposto | Valore |
|---|---|
<DATANETWORK> |
Immettere il nome della rete dati. |
<CONTROLPLANE> |
Immettere il nome del piano di controllo di base del pacchetto. |
<DATAPLANE> |
Immettere il nome del piano dati di base del pacchetto. |
<RESOURCEGROUP> |
Immettere il nome del gruppo di risorse. |
az mobile-network attached-data-network create -n <DATANETWORK> -g <RESOURCEGROUP> --pccp-name <CONTROLPLANE> --pcdp-name <DATAPLANE> --dns-addresses "[1.1.1.1]" --data-interface name=N6 --address-pool 192.168.1.0/24
Pulire le risorse
Se non si vuole mantenere la distribuzione, eliminare il gruppo di risorse.
Passaggi successivi
Se la distribuzione è stata mantenuta, è possibile iniziare a progettare il controllo dei criteri per determinare il modo in cui la rete mobile privata gestisce il traffico oppure aggiungere altri siti alla rete mobile privata.