升级站点中的数据包核心实例 - ARM 模板

每个 Azure 专用 5G 核心站点包含一个数据包核心实例，它是 3GPP 标准定义的 5G 下一代核心（5G NGC 或 5GC）的云原生实现。 需要定期升级数据包核心实例才能访问最新的 Azure 专用 5G 核心功能，并维护对专用移动网络的支持。 本操作指南介绍如何使用 Azure 资源管理器模板（ARM 模板）升级数据包核心实例。

Azure 资源管理器模板是定义项目基础结构和配置的 JavaScript 对象表示法 (JSON) 文件。 模板使用声明性语法。 你可以在不编写用于创建部署的编程命令序列的情况下，描述预期部署。

如果部署包含多个站点，建议先升级单个站点中的数据包核心，并确保升级成功，然后再升级其余站点中的数据包核心。

如果环境满足先决条件、你对使用 ARM 模板比较熟悉，并且已进行升级规划，请选择“部署到 Azure”按钮。 Azure 门户中会打开模板。

先决条件

• 必须有一个正在运行的数据包核心。 使用 Azure Monitor 平台指标或数据包核心仪表板来确认数据包核心实例正常运行。
• 确保可以使用一个有权访问用于创建专用移动网络的活动订阅的帐户登录到 Azure 门户。 此帐户必须具有订阅范围的内置参与者角色。
• 确定托管要升级的数据包核心实例的站点的名称。
• 如果使用 Microsoft Entra ID 来针对访问本地监视工具的活动进行身份验证，请确保本地计算机对已启用 Azure Arc 的 Kubernetes 群集具有核心 kubectl 访问权限。 这需要一个核心 kubeconfig 文件，可以通过核心命名空间访问获取该文件。

查看模板

本快速入门中使用的模板来自 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 并打开模板。

   

2. 使用在先决条件中检索的信息，选择或输入以下值。

   • 订阅：选择在创建专用移动网络时使用的 Azure 订阅。
   • 资源组：选择包含代表该专用移动网络的移动网络资源的资源组。
   • 区域：选择你部署专用移动网络的区域。
   • 现有数据包核心：选择要升级的数据包核心实例的名称。
   • 新版本：输入要将数据包核心实例升级到的版本。

   

   注意

   如果出现有关所选数据包核心版本与当前 Azure Stack Edge 版本不兼容的警告，则需要先升级 ASE。 从警告提示中选择“升级 ASE”，然后按照更新 Azure Stack Edge Pro GPU 中的说明进行操作。 完成 ASE 更新后，返回此步骤的开头以升级数据包核心。

3. 选择“查看 + 创建”。

4. 现在，Azure 将验证你输入的配置值。 应会看到一条消息，指出你的值已通过验证。

   如果验证失败，你将看到一条错误消息，并且“配置”选项卡中会标记无效的配置。 选择带标记的选项卡并根据错误消息更正无效配置，然后返回到“查看 + 创建”选项卡。

5. 验证配置后，选择“创建”来升级数据包核心实例。 升级数据包核心实例后，Azure 门户将显示确认屏幕。

查看已部署的资源

1. 选择“转到资源组”。

   

2. 选择“数据包核心控制平面”资源，它代表该站点中数据包核心实例的控制平面功能。

3. 检查“配置”标题下的“版本”字段，确认它显示了新软件版本。

还原备份的部署信息

使用备份部署信息中收集的信息重新配置部署。

1. 根据登录到分布式跟踪和数据包核心仪表板时使用的身份验证方法：

   • 如果使用 Microsoft Entra ID，请为分布式跟踪和数据包核心仪表板重新应用机密对象。
   • 如果使用本地用户名和密码，请按照访问分布式跟踪 Web GUI 和访问数据包核心仪表板中的说明来恢复对本地监视工具的访问。

2. 如果备份了任何数据包核心仪表板，请按照 Grafana 文档中的导入仪表板进行还原。

3. 如果 UE 需要手动操作才能从数据包核心中断中恢复，请按照其恢复步骤进行操作。

验证升级

升级完成后，检查部署是否正常运行。

1. 使用 Azure Monitor 平台指标或数据包核心仪表板来确认数据包核心实例正常运行。
2. 执行在规划升级中准备的测试计划。

回退

如果在升级后遇到问题，可以将数据包核心实例回滚到以前的版本。

在此步骤中，你将使用 REST API 请求回滚数据包核心。 如果想要改用 Azure 门户进行回滚，请按照回滚 - Azure 门户中的说明操作。

如果在数据包核心实例运行较新版本时设置的任何配置选项在要回滚到的版本中不受支持，则需要先还原到以前的配置才能执行回滚。 有关何时引入新功能的信息，请查看数据包核心发行说明。

1. 确保你有部署信息的备份。 如果需要再次备份，请按照备份部署信息进行操作。

2. 执行回滚 POST 请求。

   提示

   有关如何使用 REST API 的详细信息，请参阅 Azure REST API 参考。

3. 按照还原备份的部署信息中的步骤重新配置部署。

4. 按照验证升级中的步骤检查回滚是否成功。

后续步骤

你已完成数据包核心实例的升级。

• 如果部署包含多个站点，请升级另一个站点中的数据包核心实例。
• 使用 Azure Monitor 平台指标或数据包核心仪表板监视部署。