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

[Комплект группы (groupkit)](https://help.globalerp.ru/books/GsCtk/SNAPSHOT/html/050_appkit.html#groupkit) - это
дополнительные и редко изменяемые артефакты, используемые в развертывании Global ERP. В их число входят:

1. Архив с дополнительными библиотеками (libs). В данный комплект могут входить как драйвера для СУБД Oracle, так и
   любые другие драйвера необходимые для корректной работы приложения (например, драйвера оборудования).
2. Архив с дополнительными шрифтами (fonts). Процесс настройки шрифтов в Global описан
   в [документации по шрифтам.](../070_addition/060_fonts.md)
3. Файлы JDK для переопределения (java),
   например [cacerts](https://www.ibm.com/docs/en/sdk-java-technology/8?topic=certificate-cacerts-certificates-file).
   Пути к файлам задаются относительно корня установленной 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/`. |

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

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

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

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

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

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

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

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

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

   ```bash
   unzip -l workspace/groupkit/java.zip
   ```

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

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

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

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

   ![Push Groupkit](img/push_groupkit2nfs.png)

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

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

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

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

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

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

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

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

   ![Log Groupkit](img/pod-global-log-groupkit.png)
   

