Настройки#

Настройки окружения#

Путь к мастер ключу#

Мастер-ключ регистрируется при первоначальной настройке и используется для шифрования паролей и токенов. Остальная конфигурация в workspace/store.json хранится открыто. Ключ должен находиться в безопасном месте, недоступном другим пользователям. В мастере по умолчанию предлагается файл .gsf-cli.priv в домашнем каталоге пользователя. Команда register_private_key -c <каталог> позволяет зарегистрировать ключ без диалога.

Путь к IntelliJ IDEA#

Используется для запуска среды разработки.

Для сборки через config.json, refresh и build IDEA не требуется.

Путь к sbt#

Используется для работы с SBT.

Примечание

Sbt начиная с версии 1.8 для работы в режиме BSP требует отсутствие пробелов в пути. В связи с этим на данный момент требуется устанавливать sbt по адресу: C:\programs\sbt

Этот путь задан в Windows-мастере GSF CLI. На Linux путь задаётся при настройке. При загрузке config.json используется его поле sbt_home; в пошаговых инструкциях оно указано явно.

Начало диапазона динамических портов#

Используется для динамического выделения портов, при добавлении проекта с нестандартными портами. Позволяет одновременно запускать несколько серверов приложений.

Настройки проекта#

В данной главе описываются параметры которые может спрашивать мастер, для корректного конфигурирования проектов.

Jdk#

JDK, с которым будет работать проект. В этом руководстве используется версия 21. Путь должен указывать на каталог с bin/java и bin/javac (на Windows — .exe).

Url к проекту#

Исходный код проекта в GIT.

Пример: https://extgit.global-system.ru/appdev/internal/pgtest.git

Url к серверу приложения#

Место откуда брать обновления для сервера приложения.

Пример: ftp://ftp.bitec.ru/pub/#Global/Global3/release/Postgres/artifacts/globalserver.zip

Или: https://repo.global-system.ru/artifactory/general/ru/bitec/globalserver/globalserver/1.24.0/nightly/master/postgres/globalserver.zip

Использовать стандартные порты#

Если флаг сброшен, то при конфигурировании правила запуска сервера приложения порты будут динамически выделены из диапазона.

Примечание

Номера портов распечатываются при добавлении проекта. Так же их можно посмотреть в workspace\sources\{project_name}\application\.idea\runConfigurations\Global3se.xml

Внимание

Стандартный HTTP-порт сервера: 8080. Это не значение начала динамического диапазона; для него мастер предлагает 9000.

Флаг сборки релиза#

По умолчанию используется SNAPSHOT. При выборе режима релиза в конфигурации сохраняется publish_type: RELEASE.

GSF CLI запоминает собранную release-версию в служебном кеше и пропускает повторную обычную сборку этой версии. У build --build-appsrc есть исключение: если локальный результат неполон, CLI восстановит applib и appsrc без повторной удалённой публикации.

Повторная публикация артефактов одной release-версии не предусмотрена обычным процессом выпуска. Очистка служебного кеша удаляет запись о собранной версии; это не разрешение на перезапись release в репозитории.

Для смены режима используйте manage.cmd -p <project_name> set_is_publish_release или ./manage.sh -p <project_name> set_is_publish_release. Команда вызывает мастер, поэтому в headless задавайте publish_type в config.json.