快速入門:部署私人行動網路和網站 - Azure CLI
Azure Private 5G Core 是 Azure 雲端服務,可用來在 Azure Stack Edge 裝置上部署和管理 5G 核心網路功能,作為企業內部部署私人行動網路的一部分。 本快速入門說明如何使用 Azure CLI 在美國東部 Azure 區域中部署下列資源。 如需 Azure Private 5G Core 可供使用的 Azure 區域,請參閱 依區域 提供的產品。
- 私人行動網路。
- 網站。
- 預設服務和允許所有 SIM 卡原則(如預設服務和允許全部 SIM 卡原則 中所述 )。
- 或者,一或多個 SIM 和 SIM 群組。
在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊,請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令,請安裝 Azure CLI。 若您在 Windows 或 macOS 上執行,請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊,請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
如果您使用的是本機安裝,請使用 az login 命令,透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟,完成驗證程序。 如需其他登入選項,請參閱使用 Azure CLI 登入。
出現提示時,請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能詳細資訊,請參閱使用 Azure CLI 擴充功能。
執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本,請執行 az upgrade。
必要條件:準備部署私人行動網路和網站
- 完成部署私人行動網路 並 委託 AKS 叢集 的必要工作。
- 請確定您可以使用帳戶來登入Azure 入口網站,並存取您在完成部署私人行動網路 的必要條件工作中所識別的作用中 訂用帳戶。 此帳戶在訂用帳戶範圍中必須具有內建參與者或擁有者角色。
- 收集部署私人行動網路 所需的資訊。 如果您想要布建 SIM,您必須準備包含 SIM 資訊的 JSON 檔案,如布建 SIM 的 JSON 檔案格式中所述 。
- 識別網站中 Azure Stack Edge Pro 裝置上對應至埠 5 和 6 的介面名稱。
- 收集網站 的必要資訊。
- 請參閱目前封包核心版本的版本資訊,以及 Azure Stack Edge (ASE) 目前是否支援該版本。 如果您的 ASE 版本與最新的封包核心不相容,請更新您的 Azure Stack Edge Pro GPU。
本文中使用的 Azure CLI 命令
- 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
啟動 Azure Cloud Shell
Azure Cloud Shell 是免費的互動式 Shell,可讓您用來執行本文中的步驟。 它具有預先安裝和設定的共用 Azure 工具,可與您的帳戶搭配使用。
若要開啟 Cloud Shell,只要從程式碼區塊右上角選取 [ 試試看 ]。 您也可以移至 https://shell.azure.com ,從另一個瀏覽器索引標籤啟動 Cloud Shell。
當開啟 Cloud Shell 時,請確認已為您的環境選取 Bash。 後續的會話會在 Bash 環境中使用 Azure CLI、選取 [複製 ] 以複製程式碼區塊、將其貼到 Cloud Shell 中,然後按 Enter 鍵執行。
登入 Azure
系統會在登入的初始帳戶下自動驗證 Cloud Shell。 使用下列指令碼透過不同的訂閱登入,並將 <Subscription ID>
取代為您的 Azure 訂用帳戶識別碼。 如果您沒有 Azure 訂用帳戶,請在開始之前先建立 Azure 免費帳戶。
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
部署私人行動網路、網站和 SIM 卡
您必須完成下列步驟,才能成功部署私人行動網路、網站和 SIM 卡。 每個步驟都必須完整完成,才能繼續進行下一個步驟。
建立行動網路資源
用來 az mobile-network create
建立新的 行動網路 資源。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<MOBILENETWORK> |
輸入私人行動網路的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
az mobile-network create --location eastus -n <MOBILENETWORK> -g <RESOURCEGROUP> --identifier mcc=001 mnc=01
建立網站資源
使用 az mobile-network site
來建立新的 網站 資源。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<MOBILENETWORK> |
輸入您建立的私人行動網路名稱。 |
<SITE> |
輸入網站的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
az mobile-network site create --mobile-network-name <MOBILENETWORK> -n <SITE> -g <RESOURCEGROUP>
建立封包核心控制平面資源
用來 az mobile-network pccp create
建立新的 封包核心控制平面 資源。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<ASE> |
輸入 ASE 的名稱。 |
<CUSTOMLOCATION> |
輸入自訂位置的名稱。 |
<MOBILENETWORK> |
輸入行動網路的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
<CONTROLPLANE> |
輸入封包核心控制平面的名稱。 |
<SITE> |
輸入網站的名稱。 |
<IPV4ADDRESS> |
輸入網站的 IPv4 位址。 |
取得 ASE 識別碼,並將它指派給變數。
ASE_ID=$(databoxedge device show --device-name <ASE> -g <RESOURCEGROUP> --query "id")
取得自訂位置識別碼,並將它指派給變數。
CUSTOM_LOCATION_ID=$(customlocation show --name <CUSTOMLOCATION> -g <RESOURCEGROUP> --query "id")
取得月臺識別碼,並將它指派給變數。
SITE_ID=$(mobile-network site show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SITE> --query "id")
建立封包核心控制平面。
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
建立封包核心資料平面資源
用來 az mobile-network pcdp create
建立新的 封包核心資料平面 資源。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<DATAPLANE> |
輸入資料平面的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
<CONTROLPLANE> |
輸入封包核心控制平面的名稱。 |
az mobile-network pcdp create -n <DATAPLANE> -g <RESOURCEGROUP> --pccp-name <CONTROLPLANE> --access-interface name=N3
建立資料網路
用來 az mobile-network data-network create
建立新的 資料網路 資源。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<DATANETWORK> |
輸入資料網路的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
<MOBILENETWORK> |
輸入私人行動網路的名稱。 |
az mobile-network data-network create -n <DATANETWORK> -g <RESOURCEGROUP> --mobile-network-name <MOBILENETWORK> --location eastus
建立 SIM 群組
用來 az mobile-network sim group create
建立新的 封包核心資料平面 資源。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
使用 '' 建立新的 SIM 群組 。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
變數 | 預留位置 | 值 |
---|---|---|
<MOBILENETWORK> |
輸入私人行動網路的名稱。 | |
<SIMGROUP> |
輸入 sim 群組的名稱。 | |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
取得行動網路識別碼,並將它指派給變數。
NETWORK_ID=$(mobile-network show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
建立 SIM 群組。
az mobile-network sim group create -n <SIMGROUP> -g <RESOURCEGROUP> --mobile-network "{id:$NETWORK_ID}"
建立配量
使用 az mobile-network slice create
來建立新的 配量 。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<MOBILENETWORK> |
輸入私人行動網路的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
<SLICE> |
輸入配量的名稱。 |
az mobile-network slice create --mobile-network-name <MOBILENETWORK> -n <SLICE> -g <RESOURCEGROUP> --snssai "{sst:1,sd:123abc}"
建立服務
使用 az mobile-network service create
來建立新的 服務 。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<SERVICE> |
輸入服務的名稱。 |
<MOBILENETWORK> |
輸入私人行動網路的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
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
建立 SIM 卡原則
使用 az mobile-network sim policy create
來建立新的 SIM 卡原則 。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<SLICE> |
輸入配量的名稱。 |
<DATANETWORK> |
輸入資料網路的名稱。 |
<SERVICE> |
輸入服務的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
<SIMPOLICY> |
輸入 SIM 原則的名稱。 |
<MOBILENETWORK> |
輸入私人行動網路的名稱。 |
取得配量識別碼,並將它指派給變數。
SLICE_ID=$(mobile-network slice show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SLICE> --query "id")
取得資料網路識別碼,並將它指派給變數。
DATANETWORK_ID=$(mobile-network data-network show -n <DATANETWORK> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
取得服務識別碼,並將它指派給變數。
SERVICE_ID=$(mobile-network service show -n <SERVICE> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
建立 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
建立 SIM 卡
用來 az mobile-network sim create
建立新的 SIM 卡 。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<SIMGROUP> |
輸入 SIM 群組的名稱。 |
<SIM> |
輸入 SIM 的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
az mobile-network sim create -g <RESOURCEGROUP> --sim-group-name <SIMGROUP> -n <SIM> --international-msi 0000000000 --operator-key-code 00000000000000000000000000000000 --authentication-key 00000000000000000000000000000000
連結資料網路
使用 az mobile-network attached-data-network create
來附加 您所建立的資料網路 。 範例命令會使用下列預留位置值,以必要條件:準備部署私人行動網路和月臺 中 收集的資訊來取代它們。
預留位置 | 值 |
---|---|
<DATANETWORK> |
輸入資料網路的名稱。 |
<CONTROLPLANE> |
輸入封包核心控制平面的名稱。 |
<DATAPLANE> |
輸入封包核心資料平面的名稱。 |
<RESOURCEGROUP> |
輸入資源群組的名稱。 |
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
清除資源
如果您不想保留部署, 請刪除資源群組 。
下一步
如果您已保留部署,您可以開始設計原則控制,以判斷私人行動網路如何處理流量,也可以將更多網站新增至私人行動網路。
- 深入瞭解如何為您的私人行動網路設計原則控制組 態。
- 收集網站 的必要資訊。