Início Rápido: implantar um site e uma rede móvel privada - CLI do Azure
O Azure Private 5G Core é um serviço de nuvem do Azure para implantar e gerenciar funções de rede de núcleo 5G em um dispositivo do Azure Stack Edge, como parte de uma rede móvel privada local para empresas. Este início rápido descreve como usar uma CLI do Azure para implantar os seguintes recursos na região Leste dos EUA do Azure. ConsulteProdutos disponíveis por região para as regiões do Azure nas quais 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 permissão para todos os cartões SIM (conforme descrito em Serviço padrão e política de permissão para todos os cartões SIM).
- Opcionalmente, um ou mais SIMs e um grupo SIM.
Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.
Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.
Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.
Pré-requisito: preparar para implantar um site e uma rede móvel privada
- Conclua as tarefas de pré-requisito para implantar uma rede móvel privada e Ativar o cluster do AKS.
- Verifique se você pode entrar no portal do Azure usando uma conta com acesso à assinatura ativa identificada em Concluir as tarefas de pré-requisito para implantar uma rede móvel privada. Essa conta precisa ter a função interna Colaborador ou Proprietário no escopo da assinatura.
- Colete as informações necessárias para implantar uma rede móvel privada. Se você quiser provisionar SIMs, precisará preparar um arquivo JSON que contém as informações do SIM, conforme descrito em Formato de arquivo JSON para provisionar SIMs.
- Identifique os nomes das interfaces correspondentes às portas 5 e 6 no dispositivo Azure Stack Edge Pro no site.
- Colete as informações necessárias para um site.
- Consulte as notas sobre a versão atual do núcleo de pacotes e se há suporte para ela na versão em execução no momento no ASE (Azure Stack Edge). Se a versão do ASE for incompatível com o núcleo de pacotes mais recente, atualize a GPU do Azure Stack Edge Pro.
Comandos da CLI do Azure usados neste artigo
- 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
Iniciar o Azure Cloud Shell
O Azure Cloud Shell é um shell gratuito e interativo que poderá ser usado para executar as etapas deste artigo. Ele tem ferramentas do Azure instaladas e configuradas para usar com sua conta.
Para abrir o Cloud Shell, basta selecionar Experimentar no canto superior direito de um bloco de código. Você também pode iniciar o Cloud Shell em uma guia separada do navegador indo até https://shell.azure.com.
Quando o Cloud Shell abrir, verifique se o Bash está selecionado para o 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-os no Cloud Shell e pressione Enter para executá-los.
Entrar no Azure
O Cloud Shell é autenticado automaticamente na conta inicial usada para entrar. Use o seguinte script para entrar usando uma assinatura diferente, substituindo <Subscription ID> pela ID da Assinatura do Azure. Caso você não tenha uma assinatura 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 saber mais, confira definir assinatura ativa ou fazer logon de forma interativa
Implantar uma rede móvel privada, um site e um 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 utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<MOBILENETWORK> |
Insira um nome da 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 de Site
Use az mobile-network site para criar um novo recurso Site. O comando de exemplo utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<MOBILENETWORK> |
Inserir o nome da rede móvel privada que você criou. |
<SITE> |
Insira o nome para o 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 do Painel de Controle do Núcleo de Pacotes
Use az mobile-network pccp create para criar um novo recurso do Painel de Controle do Núcleo de Pacotes. O comando de exemplo utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<ASE> |
Insira o nome do ASE. |
<CUSTOMLOCATION> |
Insira o nome do local personalizado. |
<MOBILENETWORK> |
Insira o nome da rede móvel. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
<CONTROLPLANE> |
Insira o nome para o painel de controle do núcleo de pacotes. |
<SITE> |
Insira o nome do site. |
<IPV4ADDRESS> |
Insira o endereço IPv4 do site. |
Obtenha a ID do ASE e atribua-a a uma variável.
ASE_ID=$(databoxedge device show --device-name <ASE> -g <RESOURCEGROUP> --query "id")
Obtenha a ID do local personalizado e atribua-a a uma variável.
CUSTOM_LOCATION_ID=$(customlocation show --name <CUSTOMLOCATION> -g <RESOURCEGROUP> --query "id")
Obtenha a ID do site e atribua-a a uma variável.
SITE_ID=$(mobile-network site show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SITE> --query "id")
Criar o painel de controle do núcleo de pacotes.
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 do Núcleo de Pacotes
Use az mobile-network pcdp create para criar um novo recurso do Plano de Dados do Núcleo de Pacotes. O comando de exemplo utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<DATAPLANE> |
Insira o nome do plano de dados. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
<CONTROLPLANE> |
Insira o nome do painel de controle do núcleo de pacotes. |
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 da Rede de Dados. O comando de exemplo utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<DATANETWORK> |
Insira o nome da rede de dados. |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
<MOBILENETWORK> |
Insira 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 SIMs
Use az mobile-network sim group create para criar um novo recurso do Plano de Dados do Núcleo de Pacotes. O comando de exemplo utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
Use `` para criar um novo Grupo de SIMs. O comando de exemplo utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Variável | Espaço reservado | Valor |
|---|---|---|
<MOBILENETWORK> |
Insira o nome da rede móvel privada. | |
<SIMGROUP> |
Insira o nome do grupo de Sims. | |
<RESOURCEGROUP> |
Insira o nome do grupo de recursos. |
Obtenha a ID da rede móvel e atribua-a a uma variável.
NETWORK_ID=$(mobile-network show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Criar o grupo de SIMs.
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 utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<MOBILENETWORK> |
Insira o nome para a 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 utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<SERVICE> |
Insira o nome do serviço. |
<MOBILENETWORK> |
Insira o nome para a 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 utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | 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 de SIM. |
<MOBILENETWORK> |
Insira o nome para a rede móvel privada. |
Obtenha a ID da fatia e atribua-a a uma variável.
SLICE_ID=$(mobile-network slice show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SLICE> --query "id")
Obtenha a ID da rede de dados e atribua-a a uma variável.
DATANETWORK_ID=$(mobile-network data-network show -n <DATANETWORK> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Obtenha a ID do serviço e atribua-a a uma variável.
SERVICE_ID=$(mobile-network service show -n <SERVICE> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
Criar a política de 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 SIM
Use az mobile-network sim create para criar um novo SIM. O comando de exemplo utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<SIMGROUP> |
Insira o nome do grupo de SIMs. |
<SIM> |
Insira 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 criada. O comando de exemplo utiliza os seguintes valores de espaço reservado, substitua-os pelas informações coletadas nos Pré-requisito: preparar para implantar um site e uma rede móvel privada.
| Espaço reservado | Valor |
|---|---|
<DATANETWORK> |
Insira o nome da rede de dados. |
<CONTROLPLANE> |
Insira o nome do painel de controle do núcleo de pacotes. |
<DATAPLANE> |
Insira o nome do plano de dados do núcleo de pacotes. |
<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
Limpar os recursos
Se você não quiser manter a implantação, exclua o grupo de recursos.
Próximas etapas
Se você manteve sua implantação, poderá começar a projetar o controle de políticas para determinar como sua rede móvel privada lida com o tráfego ou adicionar mais sites à sua rede móvel privada.