升級站台中的封包核心實例 - ARM 範本

每個 Azure 私人 5G 核心網站都包含封包核心實例,這是 3GPP 標準定義的 5G 新一代核心 (5G NGC 或 5GC) 的雲端原生實作。 您必須定期升級封包核心實例,以存取最新的 Azure 私人 5G 核心功能,並維護對私人行動網路的支援。 在本操作指南中,您將瞭解如何使用 Azure Resource Manager 範本 (ARM 範本) 升級封包核心實例。

Azure Resource Manager 範本是 JavaScript 物件表示法 (JSON) 檔案,可定義專案的基礎結構和組態。 範本使用宣告式語法。 您不需要撰寫程式設計命令順序來建立部署,即可描述預定的部署。

如果您的部署包含多個月臺,建議您先升級單一站台中的封包核心,並確保升級成功,再升級其餘站台中的封包核心。

如果您的環境符合必要條件,您熟悉使用ARM範本並 已規劃升級,請選取 [ 部署至 Azure ] 按鈕。 範本會在 Azure 入口網站中開啟。

Button to deploy the Resource Manager template to Azure.

必要條件

  • 您必須擁有執行中的封包核心。 使用 Azure 監視器平臺計量或封包核心儀錶板來確認您的封包核心實例正常運作。
  • 請確定您可以使用帳戶來登入 Azure 入口網站,並存取您用來建立私人行動網路的使用中訂用帳戶。 此帳戶在訂用帳戶範圍中必須具有內建參與者或擁有者角色。
  • 識別裝載您要升級之封包核心實例的網站名稱。
  • 如果您使用 Microsoft Entra ID 來驗證本機監視工具的存取權,請確定本機電腦具有已啟用 Azure Arc 的 Kubernetes 叢集核心 kubectl 存取權。 這需要核心 kubeconfig 檔案,您可以透過下列 Core 命名空間存取來取得該檔案。

檢閱範本

本快速入門中使用的範本是來自 Azure 快速入門範本。 若要檢視範本,請參閱 azuredeploy.json

範本會修改現有 Microsoft.MobileNetwork/packetCoreControlPlanes 資源的版本。 這會導致使用新的資源版本卸載並重新安裝封包核心。 除非您也變更新版本的組態,否則此程式期間不會修改任何其他資源。 資源會提供封包核心實例的控制平面網路功能組態,包括 N2 介面的 IP 組態。

規劃升級

建議您在維護期間升級封包核心實例,以將升級對服務的影響降到最低。

規劃升級時,請確定您有足夠的時間進行升級,並在發生任何問題時進行可能的復原。 封包核心的升級和復原最多可能需要兩個小時才能完成。

此外,請考慮下列幾點,以取得在排程維護期間時可能需要規劃的升級前和升級後步驟:

  • 請參閱封包核心版本資訊,以取得您要升級的封包核心版本,以及 Azure Stack Edge (ASE) 目前執行的版本是否支援它。
  • 如果您的 ASE 版本與您要升級的封包核心版本不相容,您必須先升級 ASE。 如需 最新可用的 ASE 版本,請參閱更新您的 Azure Stack Edge Pro GPU
    • 如果您目前執行要升級為支援的 ASE 版本封包核心版本,您可以獨立升級 ASE 和封包核心。
    • 如果您目前執行升級至的 ASE 版本不支援的封包核心版本,則封包核心可能不會以新的 ASE 版本正常運作。 在此情況下,建議您規劃維護期間,讓您有時間升級 ASE 和封包核心。 請參閱更新您的 Azure Stack Edge Pro GPU,以瞭解 ASE 升級需要多久的時間。
  • 使用您需要遵循的任何步驟來準備測試計劃,以在升級后驗證部署。 此方案應該包含測試一些已註冊的裝置和會話,而您將在驗證升級期間加以執行。
  • 檢閱 還原備份的部署資訊 ,並 確認 升級後步驟,您必須遵循的步驟,以確保您的部署能夠完全運作。 請確定您的升級計劃可讓這些步驟有足夠的時間。

升級封包核心實例

備份部署資訊

下列清單包含會透過封包核心升級遺失的數據。 備份您想要保留的任何資訊;升級之後,您可以使用此資訊來重新設定封包核心實例。

  1. 根據登入分散式追蹤封包核心儀錶板時的驗證方法而定:
    • 如果您使用 Microsoft Entra ID,請儲存您在建立 Kubernetes 秘密物件中建立的 Kubernetes 秘密物件 YAML 檔案複本。
    • 如果您使用本機使用者名稱和密碼,而且想要繼續使用相同的認證,請將目前密碼的複本儲存到安全的位置。 
  2. 所有追蹤都會在升級期間刪除,而且無法擷取。 如果您想要保留任何追蹤, 請先匯出並安全地儲存 ,再繼續。
  3. 對封包核心儀錶板所做的任何自定義,都不會透過升級進行。 請參閱 Grafana 檔中的匯出儀錶板,以儲存儀錶板的備份複本。
  4. 大部分的 UE 都會在升級完成之後自動重新註冊並重新建立任何會話。 如果您有任何需要手動作業才能從封包核心中斷復原的特殊裝置,請收集這些 UE 及其復原步驟的清單。

升級 ASE

如果您在規劃升級時判斷需要升級 ASE,請遵循更新 Azure Stack Edge Pro GPU 中的步驟。

升級封包核心

  1. 選取下列連結以登入 Azure 並開啟範本。

    Button to deploy the Resource Manager template to Azure.

  2. 使用您在必要條件中擷取的信息,選取或輸入下列值。

    • 訂用帳戶: 選取您用來建立私人行動網路的 Azure 訂用帳戶。
    • 資源群組: 選取包含代表私人行動網路之行動網路資源的資源群組。
    • 區域: 選取您已部署私人行動網路的區域。
    • 現有的封包核心: 選取您要升級的封包核心實例名稱。
    • 新版本: 輸入您要升級封包核心實例的版本。

    Screenshot of the Azure portal showing the configuration fields for the upgrade ARM template.

    注意

    如果出現與所選封包核心版本與目前 Azure Stack Edge 版本不相容的警告,您必須先升級 ASE。 從警告提示中選取 [升級 ASE],然後遵循更新 Azure Stack Edge Pro GPU 中的指示。 完成 ASE 更新之後,請回到此步驟的開頭,以升級封包核心。

  3. 選取 [檢閱 + 建立]。

  4. 現在 Azure 會驗證您輸入的設定值。 您應該會看到指出您的值已通過驗證的訊息。

    如果驗證失敗,您會看到錯誤訊息,且將標示包含無效組態的 [組態] 索引標籤。 選取標幟的索引標籤,並使用錯誤訊息更正無效的設定,再返回 [ 檢閱 + 建立 ] 索引標籤。

  5. 驗證設定之後,請選取 [建立] 以升級封包核心實例。 當封包核心實例升級時,Azure 入口網站 會顯示確認畫面。

檢閱已部署的資源

  1. 選取 [移至資源群組]。

    Screenshot of the Azure portal showing a deployment confirmation for the ARM template.

  2. 選取 [封包核心控制平面 ] 資源,代表站台中封包核心實例的控制平面函式。

  3. 檢查 [組態] 標題下的 [版本] 字段,確認它顯示新的軟體版本。

還原備份的部署資訊

使用您在備份部署資訊收集的資訊來重新設定部署。

  1. 根據登入分散式追蹤封包核心儀錶板時的驗證方法而定:

  2. 如果您備份任何封包核心儀錶板,請遵循 Grafana 檔中的匯入儀錶板來還原這些儀錶板

  3. 如果您有需要手動作業才能從封包核心中斷復原的 UE,請遵循其復原步驟。

確認升級

升級完成後,請檢查您的部署是否正常運作。

  1. 使用 Azure 監視器平臺計量封包核心儀錶板 來確認您的封包核心實例正常運作。
  2. 執行您在規劃升級準備的測試計劃。

復原

如果您在升級之後遇到問題,您可以將封包核心實例復原至舊版。

在此步驟中,您將使用 REST API 要求回復封包核心。 如果您想要改用復原 Azure 入口網站,請遵循回復 - Azure 入口網站

如果您想要復原的版本不支援您在封包核心實例執行較新版本時設定的任何組態選項,您必須先還原為先前的組態,才能執行復原。 請查看封包核心版本資訊,以取得新功能引進時間的相關信息。

  1. 請確定您有部署資訊的備份。 如果您需要再次備份,請遵循 備份部署資訊

  2. 執行復原 POST 要求

    提示

    如需如何使用 REST API 的詳細資訊,請參閱 Azure REST API 參考

  3. 請遵循還原備份的部署資訊中的步驟來重新設定部署。

  4. 請遵循驗證升級中的步驟,檢查復原是否成功。

下一步

您已完成升級封包核心實例。