Поделиться через


Обновление основного экземпляра пакета на сайте — шаблон ARM

Каждый частный сайт Azure 5G Core содержит основной экземпляр пакета, который является облачной реализацией стандарта 3GPP, определенной 5G Next Generation Core (5G NGC или 5GC). Вам потребуется периодически обновлять экземпляры ядра пакетов, чтобы получить доступ к последним функциям Azure Private 5G Core и поддерживать поддержку частной мобильной сети. В этом руководстве вы узнаете, как обновить основной экземпляр пакета с помощью шаблона Azure Resource Manager (шаблон ARM).

Шаблон Azure Resource Manager — это файл нотации объектов JavaScript (JSON), который определяет инфраструктуру и конфигурацию проекта. В шаблоне используется декларативный синтаксис. Вы описываете предполагаемое развертывание без написания последовательности команд программирования для создания развертывания.

Если развертывание содержит несколько сайтов, рекомендуется сначала обновить ядро пакетов на одном сайте и убедиться, что обновление выполнено успешно перед обновлением ядер пакетов на оставшихся сайтах.

Если среда соответствует предварительным требованиям, вы знакомы с использованием шаблонов ARM и планируете выполнить обновление, нажмите кнопку "Развернуть в Azure ". Шаблон откроется на портале Azure.

Кнопка для развертывания шаблона Resource Manager в Azure.

Необходимые компоненты

  • У вас должен быть запущенный ядро пакета. Дополнительные сведения о том, как проверить это, см. в статье "Проверка ядра пакета".
  • Убедитесь, что вы можете войти в портал Azure с помощью учетной записи с доступом к активной подписке, используемой для создания частной мобильной сети. Эта учетная запись должна иметь встроенную роль участника или владельца в области подписки.
  • Определите имя сайта, на котором размещен основной экземпляр пакета, который требуется обновить.
  • Если вы используете идентификатор Microsoft Entra для проверки подлинности доступа к локальным средствам мониторинга, убедитесь, что локальный компьютер имеет основной доступ kubectl к кластеру Kubernetes с поддержкой Azure Arc. Для этого требуется основной файл kubeconfig, который можно получить, выполнив доступ к пространству имен Core.

Изучение шаблона

Шаблон, используемый в этом кратком руководстве, взят из шаблонов быстрого запуска Azure. Вы можете просмотреть этот шаблон в файле azuredeploy.json.

Шаблон изменяет версию существующего ресурса Microsoft.MobileNetwork/packetCoreControlPlanes . Это приводит к удалению и переустановке ядра пакетов с новой версией ресурса. Другие ресурсы не изменяются во время этого процесса, если вы также не измените конфигурацию новой версии. Ресурс предоставляет конфигурацию для сетевых функций уровня управления основного экземпляра пакета, включая IP-конфигурацию для интерфейса N2.

Планирование обновления

Мы рекомендуем обновить основной экземпляр пакета во время периода обслуживания, чтобы свести к минимуму влияние обновления на службу.

При планировании обновления убедитесь, что вы позволяете достаточно времени для обновления и возможного отката в случае любых проблем. Обновление и откат ядра пакетов могут занять до двух часов.

Кроме того, при планировании периода обслуживания необходимо планировать следующие моменты для шагов до и после обновления:

  • Обратитесь к заметкам о выпуске ядра пакета для версии ядра пакетов, которую вы обновляете, и убедитесь, что она поддерживается версией Azure Stack Edge (ASE) в настоящее время.
  • Если версия ASE несовместима с версией ядра пакетов, которую вы обновляете, сначала потребуется обновить ASE. Ознакомьтесь с обновлением GPU Azure Stack Edge Pro для последней доступной версии ASE.
    • Если вы в настоящее время используете базовую версию пакета, которая обновляется до версии ASE, которую вы обновляете до поддержки, вы можете обновить ASE и ядро пакетов независимо.
    • Если в настоящее время выполняется версия ядра пакетов, которая обновляется до версии ASE, которая не поддерживается, возможно, что ядро пакета не будет работать нормально с новой версией ASE. В этом случае рекомендуется планировать период обслуживания, позволяющий обновлять как ASE, так и ядро пакетов. Ознакомьтесь с обновлением GPU Azure Stack Edge Pro в течение длительного времени обновления ASE.
  • Подготовьте план тестирования с любыми шагами, которые необходимо выполнить, чтобы проверить развертывание после обновления. Этот план должен включать тестирование некоторых зарегистрированных устройств и сеансов, и вы будете выполнять его в рамках обновления проверки.
  • Просмотрите сведения о резервном копировании и проверьте обновление для шагов после обновления, которые необходимо выполнить, чтобы убедиться, что развертывание полностью работает. Убедитесь, что план обновления позволяет достаточно времени для этих шагов.

Проверка запуска ядра пакета

Используйте метрики платформы Azure Monitor, панели мониторинга ядра пакетов или Azure Работоспособность ресурсов для подтверждения нормальной работы экземпляра ядра пакета.

Чтобы использовать Azure Работоспособность ресурсов для подтверждения работоспособности экземпляра ядра пакета:

  1. Войдите на портал Azure.

  2. Найдите и выберите ресурс мобильной сети , представляющий частную мобильную сеть.

    Снимок экрана: портал Azure. В нем показаны результаты поиска ресурса мобильной сети.

  3. В меню "Ресурс" выберите "Сайты".

  4. Выберите сайт, содержащий интересующий вас экземпляр ядра пакетов.

  5. В заголовке сетевой функции выберите имя ресурса уровня управления "Ядро пакета", показанное рядом с пакетным ядром.

    Снимок экрана: портал Azure с полем

  6. Выберите Работоспособность ресурсов в разделе справки слева.

  7. Убедитесь, что ресурс работоспособен и не существует непредвиденных оповещений.

  8. Если есть непредвиденные оповещения, выполните рекомендуемые действия, описанные для восстановления системы.

  9. Дополнительные сведения о работоспособности и типах состояния, которые могут появиться, см. в Работоспособность ресурсов обзоре.

Обновление основного экземпляра пакета

Резервное копирование сведений о развертывании

В следующем списке содержатся данные, которые будут потеряны при обновлении ядра пакетов. Резервное копирование любой информации, которую вы хотите сохранить; После обновления эти сведения можно использовать для перенастройки экземпляра ядра пакета.

  1. В зависимости от метода проверки подлинности при входе в распределенные панели мониторинга трассировки и пакетов:
    • Если вы используете идентификатор Microsoft Entra, сохраните копию файла YAML секретного объекта Kubernetes, созданного в разделе "Создание секретных объектов Kubernetes".
    • Если вы используете локальные имена пользователей и пароли и хотите использовать те же учетные данные, сохраните копию текущих паролей в безопасном расположении. 
  2. Все трассировки удаляются во время обновления и не могут быть извлечены. Если вы хотите сохранить все трассировки, экспортировать и сохранить их безопасно, прежде чем продолжить.
  3. Любые настройки, внесенные на панели мониторинга ядра пакетов, не будут переноситься по обновлению. Чтобы сохранить резервную копию панелей мониторинга, обратитесь к экспорту панели мониторинга в документации по Grafana.
  4. Большинство пользовательских интерфейсов автоматически повторно регистрируют и повторно создают сеансы после завершения обновления. Если у вас есть специальные устройства, требующие ручных операций для восстановления после сбоя ядра пакетов, соберите список этих UEs и их этапы восстановления.

Обновление ASE

Если вы определились в плане обновления, необходимого для обновления ASE, выполните действия, описанные в разделе "Обновление GPU Azure Stack Edge Pro".

Обновление ядра пакетов

  1. Выберите следующую ссылку, чтобы войти в Azure и открыть шаблон.

    Кнопка для развертывания шаблона Resource Manager в Azure.

  2. Выберите или введите следующие значения, используя сведения, полученные в предварительных требованиях.

    • Подписка: выберите подписку Azure, используемую для создания частной мобильной сети.
    • Группа ресурсов: выберите группу ресурсов, содержащую ресурс мобильной сети, представляющий частную мобильную сеть.
    • Регион: выберите регион, в котором развернута частная мобильная сеть.
    • Существующий ядро пакета: выберите имя экземпляра ядра пакета, который требуется обновить.
    • Новая версия: введите версию, до которой требуется обновить экземпляр ядра пакетов.

    Снимок экрана: портал Azure с полями конфигурации для шаблона ARM обновления.

    Примечание.

    Если появится предупреждение о несовместимости между выбранной версией ядра пакетов и текущей версией Azure Stack Edge, сначала потребуется обновить ASE. Выберите "Обновить ASE" в командной строке предупреждения и следуйте инструкциям в разделе "Обновление GPU Azure Stack Edge Pro". Завершив обновление ASE, вернитесь к началу этого шага, чтобы обновить ядро пакета.

  3. Выберите Review + create (Просмотреть и создать).

  4. Теперь Azure проверяет введенные вами значения конфигурации. Должно появиться сообщение о том, что значения прошли проверку.

    Если проверка завершается ошибкой, появится сообщение об ошибке, а вкладки "Конфигурация ", содержащие недопустимую конфигурацию, будут помечены. Выберите помеченные вкладки и используйте сообщения об ошибках, чтобы исправить недопустимую конфигурацию, прежде чем вернуться на вкладку "Просмотр и создание ".

  5. После проверки конфигурации выберите "Создать ", чтобы обновить экземпляр ядра пакета. Портал Azure отобразит экран подтверждения при обновлении основного экземпляра пакета.

Просмотр развернутых ресурсов

  1. Выберите Перейти к группе ресурсов.

    Снимок экрана: портал Azure с подтверждением развертывания для шаблона ARM.

  2. Выберите ресурс уровня управления "Ядро пакета", представляющий функцию уровня управления экземпляра ядра пакета на сайте.

  3. Проверьте поле "Версия" в заголовке "Конфигурация", чтобы убедиться, что она отображает новую версию программного обеспечения.

Восстановление резервного копирования сведений о развертывании

Перенастройка развертывания с помощью сведений, собранных в сведениях о резервном копировании.

  1. В зависимости от метода проверки подлинности при входе в распределенные панели мониторинга трассировки и пакетов:

  2. Если вы создали резервную копию всех панелей мониторинга ядра пакетов, выполните импорт панели мониторинга в документации Grafana, чтобы восстановить их.

  3. Если у вас есть UEs, для которых требуются операции вручную для восстановления после сбоя ядра пакетов, выполните действия по восстановлению.

Проверка обновления

  1. Выполните действия, описанные в разделе "Проверка выполнения ядра пакета", чтобы убедиться , что обновление выполнено успешно, и ядро пакета работает правильно.
  2. Выполните план тестирования, подготовленный в плане обновления.

Откат

Если после обновления возникли проблемы, можно откатить основной экземпляр пакета до предыдущей версии.

На этом шаге вы откатите ядро пакета с помощью запроса REST API. Выполните откат — портал Azure, если вы хотите откатить с помощью портал Azure.

Если какой-либо из параметров конфигурации, заданных во время запуска основного экземпляра пакета, не поддерживается в версии, в которой требуется откат, необходимо вернуться к предыдущей конфигурации, прежде чем вы сможете выполнить откат. Ознакомьтесь с заметками о выпуске ядра пакета для получения сведений о новых функциях.

  1. Убедитесь, что у вас есть резервная копия сведений о развертывании. Если вам нужно снова создать резервную копию, следуйте инструкциям по резервному копированию сведений о развертывании.

  2. Выполните откат POST-запроса.

    Совет

    Дополнительные сведения об использовании REST API см . в справочнике по REST API Azure.

  3. Выполните действия, описанные в разделе "Восстановление резервного копирования" для перенастройки развертывания.

  4. Выполните действия, описанные в разделе "Проверка обновления ", чтобы проверить успешность отката.

Следующие шаги

Вы завершили обновление основного экземпляра пакета.

  • Если развертывание содержит несколько сайтов, обновите основной экземпляр пакета на другом сайте.
  • Используйте метрики платформы Azure Monitor или основные панели мониторинга пакетов для мониторинга развертывания.