# Подготовка комплектов приложения и группы

## Шаг 5. Подготовьте комплект приложений

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

- Дистрибутив сервера приложений (globalserver).
- Образ прикладного решения (applib).
- Профиль с шаблонами конфигурационных файлов (profile).

Опционально в комплект приложений также входит:

- Исходный код для облачной отладки прикладного решения (appsrc).

Комплект хранится в виде zip-архивов (`globalserver.zip`, `applib.zip`, `profile.zip`). Сервер приложений и образ прикладного решения должен быть предоставлен вам контактным лицом. Содержимое `profile.zip` лежит в папке (`~/nscli/`)`default/profile` в дистрибутиве nscli.

Утилита `nscli` позволяет хранить комплект в распакованном виде в одноименных папках (`globalserver/`, `applib/`, `profile/`), при этом если `profile/` нет при запуске утилиты, она будет создана из (`~/nscli/`)`default/profile`. В таком случае файлы перед загрузкой на сетевое хранилище самой утилитой запаковываются в архив.

```{tip}
Мы здесь будем использовать утилиту nscli, однако это необязательно. Читайте подробнее [здесь](./120_upgrade.md#обновление-комплекта-приложения-без-nscli).
```

Системное NFS-хранилище используется также для `groupkit` и автоматически выгружаемых дампов памяти. Его минимальный
объём — **5–6 размеров максимального `-Xmx`, но не менее 120 ГБ**. Перед загрузкой комплектов проверьте свободное
место с учётом [требований к хранилищу](../043_kubernetes_advanced/020_min_requirements.md#системное-nfs-хранилище-кластера).

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

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

    - `--namespace gs-ctk` - пространство имен, в котором развернут `gs-ctk`.
    - `--source workspace/appkit` - путь к папке с комплектом на локальной ФС относительно текущей папки.
    - `--destination appkit/v1` - путь к папке, в которую следует поместить комплект, относительно [точки монтирования системного хранилища](./050_install_nsctl.md).

2. Обновите хеши и пути к комплекту приложения (appkit) в конфигурации при помощи одной из следующих команд:

    - Эта команда не требует подключения к кластеру, хеш-суммы будут считаны с комплекта приложений на локальном диске.

      ```bash
      ./appkit.sh switch_local --config-path ./config.yaml --resgroup gs-cluster-1 --local-appkit workspace/appkit --remote-appkit appkit/v1
      ```

      - `--config-path ./config.yaml` - путь к конфигурационном ресурсу.
      - `--resgroup gs-cluster-1` - название группы ресурсов.
      - `--local-appkit workspace/appkit` - путь к папке с комплектом на локальной ФС относительно текущей папки (`--source` из предыдущего пункта).
      - `--remote-appkit appkit/v1` - путь к папке на системном хранилище, в котором находится комплект (`--destination` из предыдущего пункта).

    **ИЛИ**

    - При выполнении этой команды хеш-суммы читаются с комплекта приложений на хранилище в кластере, следовательно требует подключения к кластеру.

      ```bash
      # хеши читаются с комплекта приложений на хранилище в кластере, следовательно требует подключения к кластеру
      ./appkit.sh switch_remote --config-path ./config.yaml --resgroup gs-cluster-1 --namespace gs-ctk --remote-appkit appkit/v1
      ```

      - `--config-path ./config.yaml` - путь к конфигурационном ресурсу.
      - `--resgroup gs-cluster-1` - название группы ресурсов.
      - `--namespace gs-ctk` - пространство имен, в котором развернут `gs-ctk`.
      - `--remote-appkit appkit/v1` - путь к папке на системном хранилище, в котором находится комплект (`--destination` из предыдущего пункта).

3. Переведите комплект приложения в состояние [`started`](https://help.globalerp.ru/books/GsCtk/SNAPSHOT/html/050_appkit.html#id2):

    ```bash
    ./appkit.sh start --config-path ./config.yaml --resgroup gs-cluster-1
    ```

## Шаг 6. Подготовьте комплект группы

Подробнее о загрузке комплекта группы в [отдельном руководстве](/043_kubernetes_advanced/160_groupkit_k8s.md)
