Настройка комплекта группы

Настройка комплекта группы#

Комплект группы (groupkit) - это дополнительные и редко изменяемые артефакты, используемые в развертывании Global ERP. В их число входят:

  1. Архив с дополнительными библиотеками (libs). В данный комплект могут входить как драйвера для СУБД Oracle, так и любые другие драйвера необходимые для корректной работы приложения (например, драйвера оборудования).

  2. Архив с дополнительными шрифтами (fonts). Процесс настройки шрифтов в Global описан в документации по шрифтам.

  3. Файлы JDK для переопределения (java), например cacerts. Пути к файлам задаются относительно корня установленной Java: например, lib/security/cacerts.

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

  1. Подготовьте в workspace/groupkit только необходимые компоненты. Для каждого компонента используйте папку или готовый ZIP-архив с точным именем из таблицы:

    Компонент

    Имя папки

    Имя готового архива

    Содержимое архива

    Дополнительные библиотеки

    libs

    libs.zip

    Файлы библиотек, например ojdbc.jar, без внешней папки libs/.

    Дополнительные шрифты

    fonts

    fonts.zip

    Файлы шрифтов, например example.ttf, без внешней папки fonts/.

    Переопределения Java

    java

    java.zip

    Файлы с путями относительно корня Java, например lib/security/cacerts, без внешней папки java/.

    Вариант с папками:

    workspace/groupkit/
    ├── libs/
    │   └── ojdbc.jar
    ├── fonts/
    │   └── example.ttf
    └── java/
        └── lib/
            └── security/
                └── cacerts
    

    При выполнении ./groupkit.sh push утилита nscli сама создаст рядом с папками архивы libs.zip, fonts.zip, java.zip и загрузит их в системное хранилище. В архив попадёт содержимое соответствующей папки, без самой папки. Вручную архивировать папки не требуется. Если рядом уже есть одноимённый архив, он будет пересоздан из папки; для использования готового архива уберите соответствующую папку из workspace/groupkit.

    Вариант с готовыми архивами:

    workspace/groupkit/
    ├── libs.zip
    ├── fonts.zip
    └── java.zip
    

    Компоненты можно сочетать: например, поместить в workspace/groupkit готовый libs.zip и папку java. Неиспользуемые компоненты добавлять не нужно.

    Важно

    Путь workspace/groupkit/java/lib/security/cacerts — это путь в исходной папке на диске. Внутри java.zip этот же файл должен иметь путь lib/security/cacerts, а не java/lib/security/cacerts.

    Вложенные папки lib/security внутри архива нужны: они повторяют путь к файлу в установленной Java.

    Для проверки готового архива выполните:

    unzip -l workspace/groupkit/java.zip
    

    В списке должен быть файл lib/security/cacerts.

  2. Загрузите комплект группы на системное NFS-хранилище аналогично комплекту приложений:

    На этом же хранилище размещаются автоматически выгружаемые дампы памяти. Минимальный объём хранилища — 5–6 размеров максимального -Xmx, но не менее 120 ГБ; перед загрузкой проверьте свободное место по требованиям к хранилищу.

    ./groupkit.sh push --namespace gs-ctk --source workspace/groupkit --destination groupkit/v1
    

    Push Groupkit

  3. Добавьте в файл (config.yaml) параметр группы ресурсов groupkit:

    Обновите хеши и пути к комплекту groupkit в конфигурации при помощи команды:

    ./groupkit.sh switch_remote --config-path ./config.yaml --resgroup gs-cluster-1 --namespace gs-ctk --remote-groupkit groupkit/v1
    

    В spec.resgroups у выбранной группы ресурсов обновится поле groupkit. Пример структуры (контрольные суммы подставит команда):

    groupkit:
      path: groupkit/v1
      libs_sha256: 17c35d73fd373e80a51f0930155a5d2a750150b0faf6fcde199f940218cfe609
      fonts_sha256: ca96adbe6e8d99de6068f3c6a1cf368551c7115d2d927249f5d9ad0577210186
    

    Поля контрольных сумм зависят от загруженных компонентов.

  4. Примените ресурс:

    kubectl apply -f ./config.yaml
    
  5. Проверьте логи пода globalserver: в них отображаются события копирования компонентов комплекта группы, например шрифтов и дополнительных библиотек:

    Log Groupkit