快速入門:部署私人行動網路和網站 - Azure CLI
Azure 私人 5G 核心是一項 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。 使用下列腳本使用不同的訂用帳戶登入,並將 subscriptionId 取代為您的 Azure 訂用帳戶標識碼。
如果您沒有 Azure 訂閱,請在開始之前,先建立 Azure 免費帳戶。
subscription="subscriptionId" # Set Azure subscription ID 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
清除資源
如果您不想保留部署, 請刪除資源群組。
下一步
如果您已保留部署,您可以開始設計原則控制,以判斷私人行動網路如何處理流量,也可以將更多網站新增至私人行動網路。
- 深入瞭解如何為您的私人行動網路設計原則控制組態。
- 收集網站的必要資訊。