Оновлення інфраструктурних компонентів Платформи

🌐 Цей документ доступний українською та англійською мовами. Використовуйте перемикач у правому верхньому куті, щоб змінити версію.
Розпочніть процес оновлення на сторінці Спеціальні кроки з оновлення, і вже в рамках виконання спеціальних кроків перейдіть до оновлення інфраструктурних компонентів.

1. Загальний опис

Керування кластером Платформи відбувається за підходом GitOps. Це означає, що будь-які зміни у конфігурації кластера, компонентів кластера та компонентів Платформи відбуваються через внесення змін до конфігурації відповідних компонентів у git-гілках цих компонентів.

Кожен компонент є окремим git-репозиторієм. Метадані усіх інфраструктурних компонентів, для яких реалізована можливість управління через GitOps-підхід, зберігаються в компоненті cluster-management.

Cluster Management або cluster-mgmt — це композитний репозиторій, який визначає конкретні версії інфраструктурних компонентів. Оновлення цього компонента дозволить автоматично оновити відповідні інфраструктурні компоненти Платформи.

Нижче представлено список компонентів, для яких наразі імплементована можливість оновлення через GitOps-підхід:

  • catalog-source;

  • storage;

  • monitoring;

  • logging;

  • service-mesh;

  • velero;

  • control-plane-nexus;

  • user-management.

Керування оновленнями інфраструктурних компонентів Платформи відбувається в адміністративній панелі керування Платформою та реєстрами Control Plane.

Процес оновлення можна умовно поділити на такі етапи:

  1. Налаштування в адміністративній панелі керування кластером та реєстрами Control Plane.

  2. Проходження процедури перевірки коду в системі рецензування коду Gerrit.

  3. Контроль за виконанням збірки коду в Jenkins.

2. Налаштування в адміністративній панелі керування кластером та реєстрами Control Plane

  1. Увійдіть до адміністративної панелі керування кластером та реєстрами Control Plane.

    update cluster mgmt ua 01

  2. Відкрийте меню Керування Платформою.

  3. У правому верхньому куті сторінки натисніть Редагувати.

    update cluster mgmt 1

  4. На сторінці, що відкрилася, знайдіть секцію Оновлення кластера.

  5. У випадному списку оберіть версію, до якої необхідно оновити компоненти Платформи.

    Доступні версії збірки для оновлення компонентів завжди будуть вищими за поточну.

  6. Натисніть кнопку Підтвердити для збереження змін.

    В результаті буде сформовано запит на оновлення компонентів Платформи, тобто відбудеться передача змін (git push) до репозиторію Gerrit для подальшої перевірки коду.

    cluster mgmt update

3. Проходження процедури перевірки коду в системі рецензування коду Gerrit

Після успішного створення запита на оновлення в інтерфейсі Control Plane, необхідно пройти процедуру перевірки коду в системі Gerrit. Для цього виконайте наступні кроки:

  1. Відкрийте консоль керування кластером у Control Plane.

  2. Перейдіть до секції Запити на оновлення → Посилання.

  3. Перейдіть до інтерфейсу Gerrit за відповідним посиланням.

    update cluster mgmt 2

  4. Виконайте перевірку коду та підтвердьте внесення змін (git merge) до master-гілки репозиторію.

    cluster mgmt gerrit mr

За фактом злиття змін до master-гілки репозиторію в Gerrit, відбудеться автоматичний запуск процесу збірки внесених змін інструментом Jenkins.

4. Контроль за виконанням збірки коду в Jenkins

Після успішного надходження змін до master-гілки репозиторію в Gerrit, необхідно переконатися, що Jenkins-pipeline cluster-mgmt запустився й успішно завершився. Для цього виконайте наступні кроки:

  1. Відкрийте консоль керування кластером у Control Plane.

  2. Перейдіть до секції Конфігурація → CI.

  3. Перейдіть до інтерфейсу Jenkins за відповідним посиланням.

    update cluster mgmt 3

  4. Дочекайтеся виконання всіх кроків збірки MASTER-Build-cluster-mgmt.

    cluster mgmt jenkins

Після успішної збірки, інфраструктурні компоненти Платформи оновлюються до обраної версії. Після цього стає доступною опція оновлення компонентів реєстру.