Как настроить Jenkins Master и Slave на Ubuntu

Jenkins — это сервер автоматизации, ответвленный от проекта Hudson. Он поддерживает множество систем управления версиями (SCM), включая Git, SVN и Mercurial. Jenkins предоставляет сотни плагинов для автоматизации вашего проекта. Jenkins предлагает поддержку архитектуры ‘master/slave’, позволяя ему хостить большое количество сборок проектов.

Как работает ‘master/slave’ Jenkins?

Архитектура master/slave Jenkins используется для распределенных сред сборки, где нагрузка по сборке проектов распределяется на несколько узлов-агентов, и мы можем использовать разные среды для каждой сборки.

В архитектуре ‘master/slave’ Jenkins мастер представляет собой базовую установку Jenkins и обрабатывает все задачи для системы сборки. Узел-мастер Jenkins будет использоваться для планирования задач, мониторинга узлов-слейвов, распределения сборок на узлы-слейвы, записи и представления результата сборки, а также для непосредственного выполнения сборочных заданий.

Узлы-слейвы Jenkins настраиваются для разгрузки сборки проектов от мастера, и требуется установленное соединение между мастером и слейвами. Узлы-слейвы Jenkins могут работать на различных операционных системах, таких как Windows и Linux, и нет необходимости устанавливать полные пакеты Jenkins на них.

Этот учебник научит нас, как настроить архитектуру master-slave Jenkins, используя последнюю версию Ubuntu. Мы научимся настраивать сервер Jenkins master и добавлять другие узлы Ubuntu в качестве слейвов Jenkins.

Предварительные требования

Ubuntu Server (Ubuntu 22.04 - Ubuntu 16.04) - мастер - 10.0.15.10
slave01 - 10.0.15.21
slave02 - 10.0.15.22
Права root

Что мы будем делать?

Установить Jenkins Master
Настроить учетные данные Jenkins Master
Настроить узлы-агенты Slave
Добавить новые узлы-слейвы
Подготовить узлы-агенты Slave для выполнения сборки
Тестирование

Шаг 1 - Установить Jenkins Master

В этом учебнике мы не будем рассматривать базовую установку Jenkins. Несколько статей на HowtoForge охватывают установку Jenkins.

Установить Jenkins на Ubuntu 16.04
Установить Jenkins на Ubuntu 18.04
Установить Jenkins на Ubuntu 20.04
Установить Jenkins на Ubuntu 22.04
Установить Jenkins на CentOS 7

Следующий наш сервер Ubuntu с установленным Jenkins.

Установить Jenkins Master

Шаг 2 - Настроить учетные данные Jenkins Master

Когда вы установите сервер Jenkins master, нам нужно настроить сам сервер master. По умолчанию есть разные способы запуска узлов-агентов Jenkins, мы можем запускать узлы-агенты через SSH, административную учетную запись Windows и через Java Web Start (JNLP), выберите лучший способ в зависимости от вашей конфигурации среды и операционной системы.

Для этого руководства мы запустим узлы-агенты через ssh, и нам нужно настроить учетные данные Jenkins на нашем сервере master.

Генерация SSH-ключа

Мы будем использовать аутентификацию по SSH-ключу для настройки наших узлов-агентов, поэтому нам нужно сгенерировать SSH-ключ для пользователя Jenkins, а затем вручную загрузить ключ на каждый серверный узел с помощью ‘ssh-copy-id’.

На сервере Jenkins master войдите в систему как пользователь Jenkins и сгенерируйте SSH-ключ.

su - jenkins  
ssh-keygen

И вы получите закрытый ключ ‘id_rsa’ и открытый ключ ‘id_rsa.pub’ в директории ‘.ssh’.

Генерация SSH-ключа

Настройка учетных данных в Jenkins

Откройте панель управления Jenkins и нажмите на меню ‘Credentials’ слева.

Настройка учетных данных в Jenkins

И нажмите на ссылку ‘global’.

Теперь нажмите ‘Add Credentials’.

Добавить учетные данные

Теперь выберите метод аутентификации.

Kind: SSH Username with private key
Scope: Global
Username: jenkins
Private key: Введите напрямую и вставьте закрытый ключ ‘id_rsa’ пользователя Jenkins с сервера master.

Нажмите ‘OK’.

выбор метода аутентификации

И учетные данные Jenkins с методом аутентификации SSH-ключа были созданы.

Учетные данные Jenkins с методом аутентификации SSH-ключа были созданы

Шаг 3 - Настроить узлы-слейвы

Теперь мы настроим серверы узлов-слейвов, установив Java на этих серверах и создав нового пользователя Jenkins.

Установить Java

Установите пакеты ‘software-properties-common’ и добавьте репозиторий PPA для Java.

sudo apt install software-properties-common apt-transport-https -y  
sudo add-apt-repository ppa:openjdk-r/ppa -y

Теперь установите Java OpenJDK с помощью команды apt ниже.

sudo apt install openjdk-8-jdk -y

После завершения установки проверьте установленную версию Java.

java -version

И вы получите установленный Java OpenJDK 1.8 в системе.

Добавить нового пользователя Jenkins

Теперь добавьте пользователя ‘Jenkins’ на все узлы-агенты.

Выполните команду ниже.

useradd -m -s /bin/bash jenkins  
passwd Jenkins

Пользователь ‘Jenkins’ для узлов-агентов был создан.

Добавить нового пользователя Jenkins

Копировать SSH-ключ с мастера на слейв

Далее мы должны загрузить ключ ‘id_rsa.pub’ с мастера на узлы серверов-слейвов. Мы должны загрузить на каждый серверный узел, используя команду ‘ssh-copy-id’, как показано ниже.

ssh-copy-id [email protected]  
ssh-copy-id [email protected]

Введите пароль пользователя Jenkins.

SSH-ключ ‘id_rsa.pub’ был загружен на все узлы-агенты.

Копировать SSH-ключ с мастера на слейв

Шаг 4 - Добавить новые узлы-слейвы

На панели управления Jenkins нажмите меню ‘Manage Jenkins’, а затем нажмите ‘Manage Nodes’.

Добавить новые узлы-слейвы

Нажмите ‘New Node’.

Новый узел

Введите имя узла ‘slave01’, выберите ‘permanent agent’ и нажмите ‘OK’.

имя узла

Теперь введите детали информации узла.

Description: сервер-агент узла slave01
Remote root directory: /home/jenkins
Labels: slave01
Launch method: Запустить агента-слейва через SSH, введите IP-адрес хоста ‘10.0.15.21’, выберите аутентификацию с использованием учетных данных ‘Jenkins’.

информация о узле