Завдання 2. Оновлення реєстру

1. Мета завдання

Виконання цього завдання має на меті:

  • Отримати практичні навички оновлення реєстру з версії n-1 до версії n. Наприклад, 1.9.4.x → 1.9.5.х.

  • Ознайомитися з прикладом виконання спеціальних кроків для оновлення з урахуванням специфіки відповідної версії.

  • Навчитися перевіряти версії образів ключових подів для контролю при оновленні.

2. Передумови

Спочатку адміністратор Платформи має виконати оновлення інфраструктурних компонентів Платформи. Лише після цього можна переходити до оновлення реєстру.

  1. Створіть запит на розгортання тестового реєстру з версією для подальшого оновлення — версія n-1.

  2. Перевірте поточну версію реєстру, створеного для цього завдання, в адміністративній панелі Control Plane.

    01 registry version

3. Процес виконання завдання

3.1. Підготовка реєстру до оновлення

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

  1. Ознайомтеся з документом Оновлення Платформи та реєстрів до версії n: спеціальні кроки.

    За потреби використовуйте перемикач версій у правому верхньому куті.

  2. Якщо документ має розділ Підготовка реєстру до оновлення, виконайте цю частину інструкцій.

    Якщо такого розділу для версії n немає, переходьте до оновлення реєстру.

Для кожної версії реєстру додаються окремі спеціальні кроки для виконання. Для певних версій реєстру ці кроки можуть бути відсутні.

Процедура оновлення виконується спільно с адміністратором Платформи, оскільки адміністратор реєстру може не мати достатньо прав на виконання усіх кроків.

3.2. Оновлення реєстру до версії n

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

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

На кроці вибору версії для оновлення виберіть версію n.

02 registry update confirm

3.2.2. Підтвердження запита на оновлення в Control Plane

  1. Відкрийте відомості про тестовий реєстр і знайдіть розділ Запити на оновлення.

  2. Відкрийте сформований запит на оновлення версії реєстру натисканням іконки перегляду — 👁.

    03 registry update gerrit

  3. Підтвердьте внесення змін до коду.

Зверніть увагу на альтернативний шлях підтвердження змін через систему рецензування коду Gerrit. Детальніше — див. інструкцію з оновлення компонентів реєстру, розділ Перевірка коду в Gerrit.

3.2.3. Перевірка збірки коду в Jenkins

  1. Перейдіть з Control Plane до інтерфейсу Jenkins.

  2. Відкрийте процес MASTER-Build-<registry-name>, де <registry-name> — це назва реєстру, який ви оновлюєте.

  3. Переконайтеся, що процес запустився та успішно завершився.

    04 jenkins build success

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

3.3. Кроки після оновлення реєстру

Після того, як реєстр оновлено до версії n та процес збірки пройшов успішно, потрібно перевірити та, за наявності, виконати додаткові спеціальні кроки. Для цього зробіть наступне:

  1. Ознайомтеся з документом Оновлення Платформи та реєстрів до версії n: спеціальні кроки.

    За потреби використовуйте перемикач версій у правому верхньому куті.

  2. Якщо документ має розділ Кроки після оновлення реєстру, виконайте цю частину інструкцій.

    Якщо такого розділу для версії n немає, переходьте до розділу Перевірка версії образів для подів.

Для кожної версії реєстру додаються окремі спеціальні кроки для виконання. Для певних версій реєстру ці кроки можуть бути відсутні.

Процедура оновлення виконується спільно з адміністратором Платформи, оскільки адміністратор реєстру може не мати достатньо прав на виконання усіх кроків.

3.4. Перевірка версії образів для подів

Перевірте, що після оновлення реєстру оновилися версії образів для подів.

Для цього виконайте наступні кроки:

  1. Перейдіть з Control Plane до сервісу Gerrit.

    Ви можете знайти посилання до Gerrit у розділі швидких посилань адміністративної панелі Control Plane.

    07 quick links gerrit

  2. Виконайте вхід, якщо це не було зроблено.

    08 gerrit sign in

  3. Перейдіть в розділ CHANGES > Merged.

    09 gerrit merged changes

  4. Знайдіть зміну з оновленням реєстру. Вона матиме назву Update registry to <version>, де <version> — це версія, до якої ви оновлюєте реєстр.

    10 gerrit change update

  5. Всередині зміни з оновленням реєстру знайдіть файл deploy-templates/helmfile.yaml.

    11 gerrit helmfile location

  6. Всередині helmfile.yaml відшукайте зміни версій образів для наступних подів:

    • bpms

      12 helmfile bpms

    • digital-signature-ops

      13 helmfile digital signature ops

    • registry-regulation-management

      14 helmfile registry regulation management

  7. Перейдіть до OpenShift-консолі та відкрийте розділ Workloads > Pods.

  8. У випадному списку Project оберіть проєкт із назвою реєстру, який ви оновлюєте.

    15 okd pods project

  9. Виконайте пошук по кожному поду та переконайтеся, що версія образу збігається із версією, яка вказана в оновленнях helmfile.yaml.

    • bpms

    • digital-signature-ops

    • registry-regulation-management

    16 okd pods bpms

    17 okd pods bpms version

4. Результат виконання завдання

Результатом виконання завдання є реєстр, оновлений до версії n.

18 task result