Guia de início rápido: implantar uma rede móvel privada e um site - CLI do Azure
O Azure Private 5G Core é um serviço de nuvem do Azure para implantar e gerenciar funções de rede principal 5G em um dispositivo Azure Stack Edge, como parte de uma rede móvel privada local para empresas. Este guia de início rápido descreve como usar uma CLI do Azure para implantar os seguintes recursos na região do Azure Leste dos EUA. Consulte Produtos disponíveis por região para as regiões do Azure onde o Azure Private 5G Core está disponível.
- Uma rede móvel privada.
- Um site.
- O serviço padrão e a política de SIM de permissão para todos (conforme descrito em Serviço padrão e política de SIM de permissão para todos).
- Opcionalmente, um ou mais SIMs e um grupo SIM.
Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.
Pré-requisito: Preparar para implantar uma rede móvel privada e um site
- Conclua as tarefas de pré-requisito para implantar uma rede móvel privada e comissione o cluster AKS.
- Certifique-se de que pode iniciar sessão no portal do Azure utilizando uma conta com acesso à subscrição ativa que identificou em Concluir as tarefas de pré-requisito para implementar uma rede móvel privada. Essa conta deve ter a função interna de Colaborador ou Proprietário no escopo da assinatura.
- Colete as informações necessárias para implantar uma rede móvel privada. Se quiser provisionar SIMs, será necessário preparar um arquivo JSON contendo as informações do SIM, conforme descrito no formato de arquivo JSON para provisionamento de SIMs.
- Identifique os nomes das interfaces correspondentes às portas 5 e 6 no dispositivo Azure Stack Edge Pro no site.
- Coletar as informações necessárias para um site.
- Consulte as notas de versão da versão atual do núcleo do pacote e se ela é suportada pela versão que o Azure Stack Edge (ASE) está executando no momento. Se sua versão ASE for incompatível com o núcleo de pacote mais recente, atualize sua GPU do Azure Stack Edge Pro.
Comandos da CLI do Azure usados neste artigo
- az mobile-network criar
- az mobile-network site criar
- az rede móvel pccp criar
- az rede móvel pcdp criar
- az rede móvel de dados criar
- az mobile-network sim group criar
- az mobile-network slice criar
- az serviço de rede móvel criar
- az mobile-network sim policy create
- az rede móvel sim criar
- az mobile-network attached-data-network criar
Iniciar o Azure Cloud Shell
O Azure Cloud Shell é um shell interativo gratuito que pode utilizar para executar os passos neste artigo. Tem as ferramentas comuns do Azure pré-instaladas e configuradas para utilização com a sua conta.
Para abrir o Cloud Shell, basta selecionar Experimentar no canto superior direito de um bloco de código. Também pode iniciar o Cloud Shell num separador do browser separado ao aceder a https://shell.azure.com.
Quando o Cloud Shell abrir, verifique se o Bash está selecionado para o seu ambiente. As sessões subsequentes usarão a CLI do Azure em um ambiente Bash, selecione Copiar para copiar os blocos de código, cole-o no Cloud Shell e pressione Enter para executá-lo.
Iniciar sessão no Azure
O Cloud Shell é autenticado automaticamente na conta inicial com a qual entrou conectado. Use o script a seguir para entrar usando uma assinatura diferente, substituindo <Subscription ID> por sua ID de Assinatura do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Para obter mais informações, consulte definir assinatura ativa ou fazer login interativamente
Implantar uma rede móvel privada, site e SIM
Você deve concluir as etapas a seguir para implantar com êxito uma rede móvel privada, um site e um SIM. Cada etapa deve estar totalmente concluída antes de prosseguir para a próxima.
Criar um recurso de Rede Móvel
Use az mobile-network create para criar um novo recurso de Rede Móvel. O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<MOBILENETWORK> |
Insira um nome para a rede móvel privada. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
az mobile-network create --location eastus -n <MOBILENETWORK> -g <RESOURCEGROUP> --identifier mcc=001 mnc=01
Criar um recurso do Site
Use az mobile-network site para criar um novo recurso do Site . O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<MOBILENETWORK> |
Introduza o nome da rede móvel privada que criou. |
<SITE> |
Insira o nome do site. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
az mobile-network site create --mobile-network-name <MOBILENETWORK> -n <SITE> -g <RESOURCEGROUP>
Criar um recurso de Plano de Controle Principal de Pacote
Use az mobile-network pccp create para criar um novo recurso de Plano de Controle Principal de Pacote . O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<ASE> |
Insira o nome do ASE. |
<CUSTOMLOCATION> |
Insira o nome do local personalizado. |
<MOBILENETWORK> |
Digite o nome da rede móvel. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
<CONTROLPLANE> |
Digite o nome do plano de controle do núcleo do pacote. |
<SITE> |
Insira o nome do site. |
<IPV4ADDRESS> |
Insira o endereço IPv4 do site. |
Obtenha o ID ASE e atribua-o a uma variável.
ASE_ID=$(databoxedge device show --device-name <ASE> -g <RESOURCEGROUP> --query "id")
Obtenha o ID de local personalizado e atribua-o a uma variável.
CUSTOM_LOCATION_ID=$(customlocation show --name <CUSTOMLOCATION> -g <RESOURCEGROUP> --query "id")
Obtenha o ID do site e atribua-o a uma variável.
SITE_ID=$(mobile-network site show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SITE> --query "id")
Crie o plano de controle do núcleo do pacote.
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
Criar um recurso de Plano de Dados Principal de Pacote
Use az mobile-network pcdp create para criar um novo recurso de Plano de Dados Principal de Pacote . O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<DATAPLANE> |
Insira o nome do plano de dados. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
<CONTROLPLANE> |
Digite o nome do plano de controle do núcleo do pacote. |
az mobile-network pcdp create -n <DATAPLANE> -g <RESOURCEGROUP> --pccp-name <CONTROLPLANE> --access-interface name=N3
Criar uma rede de dados
Use az mobile-network data-network create para criar um novo recurso de Rede de Dados. O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<DATANETWORK> |
Insira o nome da rede de dados. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
<MOBILENETWORK> |
Introduza o nome da rede móvel privada. |
az mobile-network data-network create -n <DATANETWORK> -g <RESOURCEGROUP> --mobile-network-name <MOBILENETWORK> --location eastus
Criar um grupo de SIM
Use az mobile-network sim group create para criar um novo recurso de Plano de Dados Principal de Pacote . O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
Use '' para criar um novo Grupo de SIM. O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Variável | Marcador de Posição | Valor |
|---|---|---|
<MOBILENETWORK> |
Introduza o nome da rede móvel privada. | |
<SIMGROUP> |
Digite o nome do grupo de sim. | |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
Obtenha o ID da rede móvel e atribua-o a uma variável.
NETWORK_ID=$(mobile-network show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Crie o grupo SIM.
az mobile-network sim group create -n <SIMGROUP> -g <RESOURCEGROUP> --mobile-network "{id:$NETWORK_ID}"
Criar uma fatia
Use az mobile-network slice create para criar uma nova fatia. O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<MOBILENETWORK> |
Introduza o nome da rede móvel privada. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
<SLICE> |
Insira o nome da fatia. |
az mobile-network slice create --mobile-network-name <MOBILENETWORK> -n <SLICE> -g <RESOURCEGROUP> --snssai "{sst:1,sd:123abc}"
Criar um serviço
Use az mobile-network service create para criar um novo Serviço. O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<SERVICE> |
Insira o nome do serviço. |
<MOBILENETWORK> |
Introduza o nome da rede móvel privada. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
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
Criar uma política de SIM
Use az mobile-network sim policy create para criar uma nova Política de SIM. O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<SLICE> |
Insira o nome da fatia. |
<DATANETWORK> |
Insira o nome da rede de dados. |
<SERVICE> |
Insira o nome do serviço. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
<SIMPOLICY> |
Insira o nome da política do SIM. |
<MOBILENETWORK> |
Introduza o nome da rede móvel privada. |
Obtenha o ID da fatia e atribua-o a uma variável.
SLICE_ID=$(mobile-network slice show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SLICE> --query "id")
Obtenha o ID da rede de dados e atribua-o a uma variável.
DATANETWORK_ID=$(mobile-network data-network show -n <DATANETWORK> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Obtenha o ID do serviço e atribua-o a uma variável.
SERVICE_ID=$(mobile-network service show -n <SERVICE> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Crie a política do 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
Criar um cartão SIM
Use az mobile-network sim create para criar um novo SIM. O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<SIMGROUP> |
Introduza o nome do grupo SIM. |
<SIM> |
Digite o nome do SIM. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
az mobile-network sim create -g <RESOURCEGROUP> --sim-group-name <SIMGROUP> -n <SIM> --international-msi 0000000000 --operator-key-code 00000000000000000000000000000000 --authentication-key 00000000000000000000000000000000
Anexar a rede de dados
Use az mobile-network attached-data-network create para anexar a Rede de Dados que você criou. O comando de exemplo usa os seguintes valores de espaço reservado, substitua-os pelas informações coletadas em Pré-requisito: Preparar para implantar uma rede móvel privada e um site.
| Marcador de Posição | Valor |
|---|---|
<DATANETWORK> |
Insira o nome da rede de dados. |
<CONTROLPLANE> |
Digite o nome do plano de controle do núcleo do pacote. |
<DATAPLANE> |
Digite o nome do plano de dados do núcleo do pacote. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
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
Clean up resources (Limpar recursos)
Se você não quiser manter sua implantação, exclua o grupo de recursos.
Próximos passos
Se você manteve sua implantação, pode começar a projetar o controle de política para determinar como sua rede móvel privada lida com o tráfego ou pode adicionar mais sites à sua rede móvel privada.