Установка и настройка Jenkins на Ubuntu

Июнь 7th, 2015

Evgeniy Kamenev

Установка Java

# apt-get update && apt-get install default-jdk

1	# apt-get update && apt-get install default-jdk

# update-alternatives --config java

1	# update-alternatives --config java

There is only one alternative in link group java (providing /usr/bin/java): /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java
Nothing to configure.

1 2	There is only one alternative in link group java (providing /usr/bin/java): /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java Nothing to configure.

# nano /etc/environment

1	# nano /etc/environment

JAVA_HOME="/usr/lib/jvm/java-8-openjdk-amd64"

1	JAVA_HOME="/usr/lib/jvm/java-8-openjdk-amd64"

#  source /etc/environment

1	# source /etc/environment

#  echo $JAVA_HOME

1	# echo $JAVA_HOME

/usr/lib/jvm/java-8-openjdk-amd64

1	/usr/lib/jvm/java-8-openjdk-amd64

Установка Jenkins

1.Добавление ключа и репозитария в apt

# wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -

1	# wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key \| sudo apt-key add -

OK

# sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'

1	# sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'

2.Обновление кеша пакетов

# apt-get update

1	# apt-get update

3.Устанавка Jenkins

# apt-get install jenkins

1	# apt-get install jenkins

Jenkins по умолчанию доступен на порту 8080

http://servername:8080

Если необходимо использовать другой порт, то изменяем в файле /etc/default/jenkins

# nano /etc/default/Jenkins

1	# nano /etc/default/Jenkins

# port for HTTP connector (default 8080; disable with -1)

HTTP_PORT=8888

# port for HTTP connector (default 8080; disable with -1)

HTTP_PORT=8888

Файл с базовыми настройками Jenkins

# grep -vE '^$|^#' /etc/default/jenkins

1	# grep -vE '^$\|^#' /etc/default/jenkins

NAME=jenkins
JAVA=/usr/bin/java
JAVA_ARGS="-Djava.awt.headless=true"
JAVA_ARGS="-Djava.net.preferIPv4Stack=true"
PIDFILE=/var/run/$NAME/$NAME.pid
JENKINS_USER=$NAME
JENKINS_GROUP=$NAME
JENKINS_WAR=/usr/share/$NAME/$NAME.war
JENKINS_HOME=/var/lib/$NAME
RUN_STANDALONE=true
JENKINS_LOG=/var/log/$NAME/$NAME.log
MAXOPENFILES=8192
HTTP_PORT=8080
PREFIX=/$NAME
JENKINS_ARGS="--webroot=/var/cache/$NAME/war --httpPort=$HTTP_PORT"

NAME=jenkins

JAVA=/usr/bin/java

JAVA_ARGS="-Djava.awt.headless=true"

JAVA_ARGS="-Djava.net.preferIPv4Stack=true"

PIDFILE=/var/run/$NAME/$NAME.pid

JENKINS_USER=$NAME

JENKINS_GROUP=$NAME

JENKINS_WAR=/usr/share/$NAME/$NAME.war

JENKINS_HOME=/var/lib/$NAME

RUN_STANDALONE=true

JENKINS_LOG=/var/log/$NAME/$NAME.log

MAXOPENFILES=8192

HTTP_PORT=8080

PREFIX=/$NAME

JENKINS_ARGS="--webroot=/var/cache/$NAME/war --httpPort=$HTTP_PORT"

4.Настройка аутентификации для доступа к Jenkins

http://<servername>:8080 -> Jenkins->Настроить Jenkins->Configure Global Security

1	http://<servername>:8080 -> Jenkins->Настроить Jenkins->Configure Global Security

Настраиваем Jenkins на использование своей базы данных Jenkins’ own user database

И запрещаем регистрацию пользователей(проверяем,что отключен checkbox) Allow users to sign up

В колонке Authorization выбираем Matrix-based security и даем право только чтение(Read) в категории просмотр (View) пользователю Anonymous

(это право необходимо для корректной работы Jenkins)

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

Если Jenkins не пускает в систему,необходимо отключить защиту в конфигурационном файле Jenkins

# nano /var/lib/jenkins/config.xml

1	# nano /var/lib/jenkins/config.xml

изменив

<useSecurity>true</useSecurity>

1	<useSecurity>true</useSecurity>

на

<useSecurity>false</useSecurity>

1	<useSecurity>false</useSecurity>

и перезапустив Jenkins

# service jenkins restart

1	# service jenkins restart

После чего нужно продолжить настройку параметров входа и прав доступа

https://jenkins.io/doc/book/system-administration/security/

5.Создание нового проекта

Теперь, когда все установлено и запущено, можно приступить к созданию нового проекта

Имя проекта — uptime

New job->Job name –uptime->Build a free-style software project->OK

1	New job->Job name –uptime->Build a free-style software project->OK

Добавляем выполение команды uptime

Add build step -> Execute shell->Command – uptime->Save

1	Add build step -> Execute shell->Command – uptime->Save

Собираем сборку и просматриваем результат

Build now->Build history нажимаем на синий круг->Console Output

1	Build now->Build history нажимаем на синий круг->Console Output

Started by user UserNameBuilding in workspace /var/lib/jenkins/workspace/uptime[uptime] $ /bin/sh -xe /tmp/hudson2288542035673782808.sh+ uptime 13:30:03 up 1:45, 5 users, load average: 0.01, 0.07, 0.10Finished: SUCCESS

1	Started by user UserNameBuilding in workspace /var/lib/jenkins/workspace/uptime[uptime] $ /bin/sh -xe /tmp/hudson2288542035673782808.sh+ uptime 13:30:03 up 1:45, 5 users, load average: 0.01, 0.07, 0.10Finished: SUCCESS

6.Добавление выполнения сборки по расписанию

После установки основной сборки можно добавить ее на выполнение в расписание Jenkins

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

Back to project->Configure->Build Triggers->Build periodically

1	Back to project->Configure->Build Triggers->Build periodically

Синтаксис совместим с синтаксисом Cron
Например, выставляем выполнение задания дважды в сутки и сохраняемся

0 */12 * * *

1	0 /12 * *

7.Установка плагинов Jenkins

Jenkins имеет большое количество различных плагинов, начиная инструментами сборки и заканчивая FTP and SSH. Например, установим плагин, который отслеживает дисковое пространство, используемое для сборки и проектов. Этот плагин поможет найти «пожирателей пространства».

Jenkins->Manage Jenkins->Manage Plugins->Available->Disk Usage Plugin->Install without restart

1	Jenkins->Manage Jenkins->Manage Plugins->Available->Disk Usage Plugin->Install without restart

Это довольно простой плагин, не нуждающийся в конфигурации, но есть и такие плагины, (например, плагин SSH), которые требуют некоторой настройки перед началом работы.

8.Настройка Nginx-проксирования для Jenkins 80->8080

# nano /etc/nginx/conf.d/jenkins.kamaok.org.us.conf

1	# nano /etc/nginx/conf.d/jenkins.kamaok.org.us.conf

upstream app_server {
server 127.0.0.1:8080 fail_timeout=0;
}

server {
listen <External_server_IP_address>:80;
server_name jenkins.kamaok.org.us;

error_log /var/log/nginx/jenkins-error.log;
access_log /var/log/nginx/jenkins-access.log main;

location / {

auth_basic "Authentication required to use Jenkins";
auth_basic_user_file /etc/nginx/.htpasswdjenkins;
allow 127.0.0.1;
allow <MY_IP_Adress>;
deny all;
satisfy any;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_read_timeout 90s;

        if (!-f $request_filename) {
            proxy_pass http://app_server;
            break;
        }
  }
}

upstream app_server {

server 127.0.0.1:8080 fail_timeout=0;

}

server {

listen <External_server_IP_address>:80;

server_name jenkins.kamaok.org.us;

error_log /var/log/nginx/jenkins-error.log;

access_log /var/log/nginx/jenkins-access.log main;

location / {

auth_basic "Authentication required to use Jenkins";

auth_basic_user_file /etc/nginx/.htpasswdjenkins;

allow 127.0.0.1;

allow <MY_IP_Adress>;

deny all;

satisfy any;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header Host $http_host;

proxy_redirect off;

proxy_read_timeout 90s;

if (!-f $request_filename) {

proxy_pass http://app_server;

break;

}

# htpasswd -c /etc/nginx/.htpasswdjenkins username

1	# htpasswd -c /etc/nginx/.htpasswdjenkins username

Jenkins перевешиваем на прослушивание только 127.0.0.1

# nano /etc/default/jenkins

1	# nano /etc/default/jenkins

JENKINS_ARGS="--webroot=/var/cache/$NAME/war --httpListenAddress=127.0.0.1 --httpPort=$HTTP_PORT --ajp13Port=$AJP_PORT"

1	JENKINS_ARGS="--webroot=/var/cache/$NAME/war --httpListenAddress=127.0.0.1 --httpPort=$HTTP_PORT --ajp13Port=$AJP_PORT"

# nginx –t

1	# nginx –t

# service nginx reload

1	# service nginx reload

# service jenkins restart

1	# service jenkins restart

Важно!
Обязательно проверить,чтобы jenkins URL, который указан в Jenkins→Manage Jenkins→Configure System совпадал с тем,какой указан в строке браузера
http://jenkins.kamaok.org.us

Добавление поддержки SSL для вирт.хоста jenkins в Nginx

Установка Certbot

# apt-get update

1	# apt-get update

# apt-get install software-properties-common

1	# apt-get install software-properties-common

# add-apt-repository ppa:certbot/certbot

1	# add-apt-repository ppa:certbot/certbot

# apt-get update

1	# apt-get update

# apt-get install python-certbot-nginx

1	# apt-get install python-certbot-nginx

Получение сертификата

# certbot certonly --nginx -d jenkins.kamaok.org.us  -d www.jenkins.kamaok.org.us --non-interactive --agree-tos --email myname@mydomain.com

1	# certbot certonly --nginx -d jenkins.kamaok.org.us -d www.jenkins.kamaok.org.us --non-interactive --agree-tos --email myname@mydomain.com

Настройка Nginx на поддержку SSL-сертификата

# nano /etc/nginx/conf.d/jenkins.lxc.kamaok.org.ua.conf

1	# nano /etc/nginx/conf.d/jenkins.lxc.kamaok.org.ua.conf

...
server {
    listen  80;
    server_name  jenkins.kamaok.org.us www.jenkins.kamaok.org.us;
    return 301 https://$host$request_uri;
}

server {
listen 443 ssl;
server_name jenkins.kamaok.org.us www.jenkins.kamaok.org.us;

  ssl_certificate /etc/letsencrypt/live/jenkins.kamaok.org.us/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/jenkins.kamaok.org.us/privkey.pem;
  include     /etc/nginx/ssl.conf;
...

...

server {

listen 80;

server_name jenkins.kamaok.org.us www.jenkins.kamaok.org.us;

return 301 https://$host$request_uri;

}

server {

listen 443 ssl;

server_name jenkins.kamaok.org.us www.jenkins.kamaok.org.us;

ssl_certificate /etc/letsencrypt/live/jenkins.kamaok.org.us/fullchain.pem;

ssl_certificate_key /etc/letsencrypt/live/jenkins.kamaok.org.us/privkey.pem;

include /etc/nginx/ssl.conf;

...

# nginx -t && service nginx reload

1	# nginx -t && service nginx reload

Важно!
Обязательно проверить,чтобы jenkins URL, который указан в Jenkins→Manage Jenkins→Configure System совпадал с тем,какой указан в строке браузера
https://jenkins.kamaok.org.us/

Настройка автопродления сертификатов

# crontab -e

1	# crontab -e

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
05 3 1 */2 * /usr/bin/certbot renew --force-renewal >> /var/log/letsencrypt/jenkins.kamaok.org.us-renew.log

1 2	PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin 05 3 1 /2 /usr/bin/certbot renew --force-renewal >> /var/log/letsencrypt/jenkins.kamaok.org.us-renew.log