Оновлення компонентів реєстру

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

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

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

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

  • Оновлення компонентів реєстру можна виконати лише після попереднього оновлення компонентів Платформи.

  • Якщо реєстр має останню версію, то опція оновлення буде недоступна.
Процес оновлення можна умовно поділити на такі етапи:

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

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

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

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

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

    update cluster mgmt 01

  2. Відкрийте меню Реєстри.

  3. Увійдіть до налаштувань реєстру.

    update registry components 1

  4. У правому верхньому куті сторінки натисніть Оновити.

    update registry components 2

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

    update registry components 4

    Ви можете також перейти до оновлення через опцію редагування реєстру:

    Реєстри > Редагувати > Оновити реєстр.

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

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

3. Перевірка коду в Gerrit

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

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

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

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

    update registry components 7

    Дочекайтеся проходження автоматичного Jenkins-процесу для перевірки коду (CI Jenkins: Verified).

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

    update registry components 8 update registry components 9

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

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

Після успішного надходження змін до master-гілки репозиторію у Gerrit, необхідно переконатися, що Jenkins-pipeline MASTER-Build-<registry-name> запустився й успішно завершився, де <registry-name> — назва реєстру, що необхідно оновити (тут — cert-labs).

Виконайте наступні кроки для контролю за виконанням збірки в Jenkins:

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

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

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

    update registry components 10

  4. Дочекайтеся виконання усіх кроків у pipeline MASTER-Build-cert-labs.

    update registry components 11

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