Jenkins для 1С – полная инструкция

Установка Jenkins

Выполняем команды по SSH на предварительно установленной Ubuntu

sudo   sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
    https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key;
sudo echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc]" \
    https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
    /etc/apt/sources.list.d/jenkins.list > /dev/null;

sudo apt-get update;
sudo apt-get install -y fontconfig openjdk-17-jre
sudo apt-get update;
sudo apt-get install -y jenkins;

Файерволл не включаем, потому что агенты Jenkins будут стучаться по произвольным портам

Заходим по IP с портом 8080: http://192.168.0.200:8080. Первичный пароль администратора получаем командой:

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

Устанавливаем рекомендуемые плагины. Создаем учетную запись в Jenkins.

В браузере, например Google Chrome, лучше удалить русский язык. Иначе интерфес Jenkins будет наполовину на английском, наполовину на ломаном русском.

Настройка библиотеки jenkins-lib

Будем использовать специальную библиотеку Pipeline1C для быстрой настройки сборки. Ссылка на github https://github.com/firstBitMarksistskaya/jenkins-lib.git

Далее устанавливаем плагины необходимые для работы с этой библиотекой:

1. Pipeline: groovy libraries,
2. Blue Ocean,
3. Allure,
4. Pipeline Utility Steps,
5. HTTP Request

Внимание!!! Удостоверяемся, что плагины установились, бывает не ставяться из-за таймаута при скачивании.

Заходим в раздел Manage Jenkins -> System -> Global Trusted Pipeline Libraries и подключаем библиотеку:

Внимание!!! Библиотеку подключаем имено в разделе Global Trusted Pipeline Libraries, иначе ничего не заработает. На скриншоте неверный раздел.

1. Указываем имя библиотеки jenkins-lib
2. Указываем имя ветки master
3. Ставим галочки Load implicity и Allow default version to be overriden
4. Вводим ссылку на репозиторий https://github.com/firstBitMarksistskaya/jenkins-lib.git

Заходим в раздел Мanage Jenkins -> Security -> Agents и ставим Random. Если это не сделать, то агент снаружи не подключиться к Jenkins-мастеру.

Настройка сборочной ноды на Windows

Скачиваем и устанавливаем на ноду

1. Java JDK, в моем примере Java JDK 22
2. Git

Переходим по Manage Jenkins -> Nodes и добавляем новую ноду.

1. Указываем имя ноды в Name
2. Создаем корневую директорию и вводим путь к ней в Remote root directory, например C:\Jenkins
3. Проверяем Launch method должне быть установлен в Launch agent by connection it to the controller
4. Кликаем на созданную ноду и копируем команду командной строки для запуска агента – можно ее записать в bat файл, расположить в директории C:\Jenkins и планировщиком Windows запускать при входе в систему. Только запускать нужно с полными правами.

У агентов должны быть соответствующие метки:

1. agent – для шага подготовки
2. sonar – для запуска шага анализа SonarQube

Подробнее можно узнать на github-странички библиотеки jenkins-lib