Как установить Jenkins на Ubuntu 22.04

Jenkins — это инструмент автоматизации с открытым исходным кодом для непрерывной интеграции/непрерывной доставки (CI/CD). Он полностью написан на Java и поддерживает более 1000 плагинов для сборки, развертывания и автоматизации вашего проекта. Jenkins стал одним из ведущих инструментов автоматизации, который ускоряет ваш процесс разработки через автоматизацию. Jenkins интегрирует процессы жизненного цикла разработки, такие как сборка, документирование, тестирование, упаковка, этапирование, развертывание, статический анализ и многое другое.

Jenkins поддерживает несколько инструментов управления версиями, таких как Git, Subversion, Mercurial, CVS, Perforce и RTC. Также он может выполнять Apache Ant, Apache Maven, оболочные скрипты и команды пакетного выполнения Windows. Jenkins имеет сильную поддержку сообщества с обширной документацией и вики, что делает Jenkins одним из самых используемых инструментов автоматизации CI/CD. Кроме того, он предлагает множество различных инструментов, языков и задач автоматизации для автоматизации вашего процесса разработки и развертывания.

В этом руководстве вы узнаете, как установить Jenkins на последнюю версию Ubuntu 22.04. Это руководство также охватывает настройку Apache2 в качестве обратного прокси для Jenkins с включенным SSL-соединением. В конце вы также узнаете, как создать первый проект сборки Jenkins для выполнения оболочных скриптов или команд.

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

Сервер Ubuntu 20.04
Непривилегированный пользователь с правами администратора.

Установка Java

На первом этапе вы будете устанавливать Java OpenJDK и JRE на вашу систему Ubuntu. Последняя версия Jenkins требует Java v11, и теперь вы будете устанавливать ее на свою систему.

Перед тем как начать установку любых пакетов, выполните команду apt ниже, чтобы обновить и обновить ваш репозиторий Ubuntu.

sudo apt update

Теперь установите Java OpenJDK 11, используя следующую команду.

sudo apt install openjdk-11-jre

Введите Y, чтобы подтвердить, и нажмите ENTER, чтобы начать установку. Теперь начнется установка Java OpenJDK.

установка java openjdk

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

java --version

На следующем скриншоте вы можете увидеть, что Java OpenJDK 11 установлена на машине Ubuntu 22.04.

Установка Jenkins

Теперь вы установили java на свою систему Ubuntu, теперь вы начнете установку Jenkins на машину Ubuntu 22.04.

Существует несколько способов установки Jenkins, самый простой способ — использовать предварительно собранный пакет Jenkins, предоставленный официальным репозиторием Jenkins. И для этого вам нужно будет добавить репозиторий Jenkins в вашу систему Ubuntu.

Выполните команду ниже, чтобы добавить GPG-ключ для репозитория jenkins.

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \  
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

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

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

Теперь выполните команду apt ниже, чтобы обновить и обновить все ваши системные репозитории.

sudo apt update

На следующем скриншоте вы можете увидеть, что репозиторий Jenkins добавлен.

добавить репозиторий jenkins

Далее вы можете установить Jenkins, используя команду apt ниже.

sudo apt install jenkins

Введите Y, чтобы подтвердить установку, и нажмите ENTER, чтобы продолжить. Установка Jenkins теперь начнется.

установка jenkins

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

sudo systemctl start jenkins  
sudo systemctl enable jenkins

Теперь проверьте службу Jenkins, используя команду ниже.

sudo systemctl status jenkins

На следующем скриншоте служба Jenkins активна и работает. Она работает на localhost с портом по умолчанию 8080. Также Jenkins теперь включен, что означает, что он будет запускаться автоматически при запуске системы.

запуск включение проверка службы jenkins

Настройка Apache2 в качестве обратного прокси

На данный момент Jenkins работает на адресе localhost с портом 8080. Теперь вы будете устанавливать и настраивать веб-сервер Apache2 в качестве обратного прокси для Jenkins.

Веб-сервер Apache2 будет работать перед службой Jenkins и открывать стандартные порты HTTP и HTTPS для доступа клиентов.

Выполните команду apt ниже, чтобы установить пакет apache2 на вашу систему.

sudo apt install apache2

Введите Y, чтобы подтвердить установку, и нажмите ENTER, чтобы продолжить.

установка apache2

Теперь после завершения установки выполните команду ниже, чтобы включить некоторые модули apache2, которые необходимы для конфигурации обратного прокси.

sudo a2enmod ssl rewrite headers proxy proxy_http

Теперь вы увидите вывод, как на следующем скриншоте.

включить модули apache2

Далее создайте новую конфигурацию виртуального хоста /etc/apache2/sites-available/jenkins.conf с помощью редактора nano.

sudo nano /etc/apache2/sites-available/jenkins.conf

Добавьте следующую конфигурацию в файл. И убедитесь, что вы изменили имя домена и путь к SSL-сертификатам.

  
    ServerAdmin  webmaster@localhost  
    Redirect permanent / https://jenkins.howtoforge.local/  
  
  
  
    SSLEngine On  
    SSLCertificateFile /etc/letsencrypt/live/jenkins.howtoforge.local/fullchain.pem  
    SSLCertificateKeyFile /etc/letsencrypt/live/jenkins.howtoforge.local/privkey.pem  
    ServerAdmin  webmaster@localhost  
    ProxyRequests     Off  
    ProxyPreserveHost On  
    AllowEncodedSlashes NoDecode  
      
        Order deny,allow  
        Allow from all  
      
    ProxyPass         /  http://localhost:8080/ nocanon  
    ProxyPassReverse  /  http://localhost:8080/  
    ProxyPassReverse  /  http://jenkins.howtoforge.local/  
    RequestHeader set X-Forwarded-Proto "https"  
    RequestHeader set X-Forwarded-Port "443"

Сохраните и закройте файл, когда закончите.

Далее выполните следующую команду, чтобы активировать конфигурацию виртуального хоста jenkins.conf.

sudo a2ensite jenkins.conf

После этого проверьте и подтвердите все ваши конфигурации Apache2, используя команду ниже.

sudo apachectl configtest

Убедитесь, что вы получили сообщение о выводе, такое как “ Синтаксис ОК “, что означает, что все ваши конфигурации Apache2 правильны.

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

sudo systemctl restart apache2

Теперь веб-сервер Apache2 работает с конфигурацией обратного прокси для Jenkins.

настройка apache2 обратного прокси jenkins

Начало установки Jenkins

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

Пароль инициализации для Jenkins доступен в файле /var/lib/jenkins/secrets/initialAdminPassword. Этот файл содержит сгенерированный секретный пароль для инициализации вашей установки Jenkins.

Выполните команду ниже, чтобы проверить и получить начальный пароль jenkins.

ls /var/lib/jenkins/secrets/initialAdminPassword  
cat /var/lib/jenkins/secrets/initialAdminPassword

На следующем скриншоте вы можете увидеть случайную строку, сгенерированную Jenkins. У вас может быть другой случайный секрет.

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

пароль инициализации jenkins

Откройте ваш веб-браузер и перейдите по URL-адресу установки для вашей установки Jenkins (например, https://jenkins.howtoforge.local).

На первой странице вас попросят ввести пароль инициализации для Jenkins. Вставьте ваш секретный пароль, чтобы инициализировать установку и настройку Jenkins, затем нажмите Продолжить.

пароль инициализации jenkins

Теперь нажмите кнопку “ Установить рекомендуемые плагины “, чтобы начать настройку Jenkins с дополнительными плагинами. Этот вариант хорош для новичков, он автоматически установит некоторые плагины Jenkins, которые могут понадобиться для вашего проекта.

установить рекомендуемые плагины

Теперь начнется установка плагинов Jenkins.

jenkins установка плагинов

После завершения процесса установки вас попросят создать нового администратора для Jenkins.

Введите нового администратора, пароль, адрес электронной почты и полное имя для вашей установки Jenkins и нажмите кнопку Сохранить и продолжить.

настройка администратора jenkins

Для URL-адреса установки Jenkins введите ваш домен Jenkins и нажмите Сохранить и завершить.

настройка url jenkins

Теперь вы получите следующую страницу. Нажмите кнопку Перезапустить, чтобы перезапустить службу Jenkins и применить новые настройки.

перезапуск jenkins

После перезапуска Jenkins снова посетите доменное имя вашего URL-адреса установки Jenkins, и теперь вы получите страницу входа в Jenkins.

Введите вашего администратора и пароль для Jenkins и нажмите Войти.

вход в jenkins

После входа вы получите следующую панель управления Jenkins.

панель управления jenkins

Теперь вы успешно установили и настроили Jenkins на последней версии Ubuntu 22.04 с Apache2 в качестве обратного прокси для вашего развертывания.

Создание первой сборки Jenkins

После успешной установки и настройки Jenkins теперь вы создадите новую первую сборку Jenkins из панели управления Jenkins.

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

jenkins создать сборку

Введите имя проекта и выберите тип проекта, затем нажмите OK. В этом примере имя проекта — “первая сборка” с типом проекта “ Свободный проект “.

создать свободную сборку jenkins

В разделе “ общая информация “, введите описание вашей сборки.

Теперь перейдите на вкладку “ Сборка “ и выберите сборку как “ Выполнить оболочку “, и введите следующую команду в качестве команды сборки.

echo "Это тестовая сборка на jenkins"

Этот проект только выведет сообщение “Это тестовая сборка на jenkins” в выводе сборки Jenkins.

Теперь нажмите кнопку Сохранить.

настройка сборки выполнить оболочку

Теперь на странице деталей проекта “ первая сборка “, нажмите меню “ Собрать сейчас “, чтобы начать и запустить сборку Jenkins.

собрать проект

После завершения процесса вы можете увидеть раздел истории сборок в нижнем меню, как на следующем скриншоте.

Нажмите номер сборки, чтобы получить детали завершенной операции сборки.

история сборок jenkins

Теперь нажмите меню “ Вывод консоли “, и вы получите вывод вашей первой сборки Jenkins, которое сообщение “ Это тестовая сборка на jenkins “. И сборка Jenkins успешна.

вывод сборки jenkins

Заключение

Поздравляем! Вы теперь успешно установили Jenkins на последнем сервере Ubuntu 22.04 с Apache2 в качестве обратного прокси с включенным безопасным соединением HTTPS. Также вы узнали основные моменты и настройки Jenkins, а также создали первый простой проект сборки с использованием Jenkins.