Инструкция по установке и настройке GSF CLI и окружения сборки CI#

Gsf-cli может быть встроена в конвейер непрерывной интеграции для публикации решений и комплектов сборки.

Программное обеспечение которое потребуется для сборки:#

1. Установка базовой системы и пакетов#

Установите Linux-дистрибутив (например, Debian/Ubuntu).

Затем выполните установку необходимых утилит:

sudo apt update && sudo apt install -y sudo wget git mc zip unzip

2. Подготовка директорий#

Создайте рабочие каталоги, замените <user> на вашего пользователя:

sudo mkdir -p /opt/global/tmp
sudo mkdir -p /opt/global/builds
sudo chown -R <user>:<user> /opt/global

3. Загрузка необходимых компонентов#

Скачайте:#

# GSF CLI
wget -P /opt/global/tmp https://repo.global-system.ru/artifactory/common/ru/bitec/gsf-cli-linux/SNAPSHOT/gsf-cli-linux-SNAPSHOT.zip

# sbt
wget -P /opt/global/tmp https://github.com/sbt/sbt/releases/download/v1.8.2/sbt-1.8.2.zip

# JDK 8 от BellSoft
wget -P /opt/global/tmp https://github.com/bell-sw/Liberica/releases/download/8u452%2B11/bellsoft-jdk8u452+11-linux-amd64.deb

4. Установка и распаковка компонентов#

# Установка JDK
sudo apt install /opt/global/tmp/bellsoft-jdk8u452+11-linux-amd64.deb

# Распаковка SBT
unzip /opt/global/tmp/sbt-1.8.2.zip -d /opt/global

# Распаковка GSF CLI
unzip /opt/global/tmp/gsf-cli-linux-SNAPSHOT.zip -d /opt/global/gsf-cli

5. Установка GSF CLI#

sudo /opt/global/gsf-cli/bin/installpkg.sh
/opt/global/gsf-cli/bin/initvenv.sh

6. Настройка сборочного проекта#

Создайте конфигурационный файл:

nano /opt/global/builds/config.json

Пример содержимого:#

{
  "sbt_home": "/opt/global/sbt",
  "svn_path": "",
  "projects": [
    {
      "git_branch": "<branch>",
      "jdk_home": "/usr/lib/jvm/bellsoft-java8-amd64/",
      "name": "<project_name>",
      "project_source": "<project_url>",
      "project_source_type": "vcs",
      "publish_type": "SNAPSHOT",
      "vcs_type": "git"
    }
  ]
}

7. Настройка доступа#

Регистрация приватного ключа:#

/opt/global/gsf-cli/config.sh register_private_key -c /opt/global

Установка необходимых учётных данных:#

/opt/global/gsf-cli/credential_manager.sh set -u <url> -l <login> -p <password>

8. Активация headless-режима#

/opt/global/gsf-cli/config.sh enable_headless

9. Загрузка конфигурации#

/opt/global/gsf-cli/config.sh load_config -f /opt/global/builds/config.json

После выполнения всех шагов система будет готова к сборке проекта через gsf-cli.

10. Запуск сборки#

Для запуска сборки всех проектов можете выполнить команду

/opt/global/gsf-cli/manage.sh --all build