Налаштування режиму розгортання реєстру (deployment mode)

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

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

Режим розгортання (deployment mode) — це параметр, який вказує на те, в якому середовищі відбувається розгортання регламенту реєстру. Він дозволяє відрізнити виробниче середовище від середовища розробки, а також налаштувати конфігурацію відповідно до потреб кожного з них. Платформа реєстрів підтримує 2 режими розгортання: development та production.

Режим development передбачає розгортання із налаштуваннями для зручності розробки та відлагодження.

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

У виробничому режимі разом із продуктивними версіями Платформи не розгортаються:

  • компоненти, залучені у процесах розробки регламенту реєстрів;

  • публічні ендпоінти компонентів, залучені у процесах розробки регламенту реєстрів.

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

Компонент для розробки реєстру

Використання у production-режимі

Публічний ендпоінт (Route)

admin-portal

Залежить від налаштувань

Передбачено

registry-regulation-management

Передбачено

Недоступний

kafka-ui

Недоступний

Недоступний

redash-admin

Недоступний

Недоступний

redash-admin-adhocworker

Недоступний

Недоступний

redash-admin-scheduledworker

Недоступний

Недоступний

redash-admin-exporter

Недоступний

Недоступний

form-management-modeler (legacy)

Недоступний

Недоступний

pgAdmin

Недоступний

Недоступний

registry-vault

Передбачено

Недоступний

external-integration-mocks

Недоступний

Недоступний

registry-rest-api

Передбачено

Недоступний

Ця таблиця відображає рекомендації щодо використання компонентів та можливість їх розгортання у Production-режимі.

Сервіси, такі як admin-portal і registry-regulation-management, можуть бути включені за потреби, однак їх використання у промислових середовищах не рекомендується. Водночас можливість розгортання цих сервісів передбачена і може бути активована через налаштування реєстру відповідно до ваших потреб.

2. Налаштування

Щоб змінити режим розгортання реєстру — deploymentMode — з production на development, виконайте наступні кроки:

  1. Відкрийте OpenShift-консоль, знайдіть проєкт Control Plane та перейдіть за посиланням до компонента gerrit.

    Посилання до центрального Gerrit:
    https://gerrit-control-plane.<dns-wildcard>
  2. Знайдіть репозиторій із вашим реєстром та відкрийте файл deploy-templates/values.yaml.

  3. Знайдіть змінну deploymentMode: production та змініть її значення на deploymentMode: development.

    Налаштування режимів розгортання виглядає наступним чином:

    deploy-templates/values.yaml
    global:
      deploymentMode: development
  4. (Опціонально) Якщо необхідно розгорнути реєстр без певного порталу, наприклад, Кабінету отримувача послуг, виключіть його з налаштувань наступним чином:

    deploy-templates/values.yaml
    global:
      excludePortals: ['citizen']

    За замовчуванням змінна excludePortals відсутня, що означає розгортання усіх порталів:

    deploy-templates/values.yaml
    global:
      excludePortals: ['']

    При виключенні Кабінету отримувача послуг із процесу розгортання, наступні сервіси також не розгортаються:

    • citizen-portal

    • ddm-notification-service

    • user-service-api

    • user-service-persistence

  5. Виконайте git commit зі змінами, застосуйте зміни до master-гілки та запустіть розгортання реєстру.