Cómo instalar el servidor de automatización Jenkins con Apache en Ubuntu 18.04

Jenkins es un servidor de automatización bifurcado del proyecto Hudson. Jenkins es una aplicación basada en servidor que se ejecuta en un contenedor de servlets Java, tiene soporte para muchos sistemas de software SCM (Gestión de Control de Versiones) incluyendo Git, SVN y Mercurial. Jenkins proporciona cientos de complementos para automatizar tu proyecto. Jenkins fue creado por Kohsuke Kawaguchi, lanzado por primera vez en 2011 bajo la Licencia MIT, y es un software libre.

En este tutorial, te mostraré cómo instalar la última versión estable de Jenkins en Ubuntu Server 18.04 LTS (Bionic Beaver). Ejecutaremos Jenkins en nuestro propio nombre de dominio, y instalaremos y configuraremos Jenkins para que se ejecute bajo el proxy inverso del servidor web Apache.

Prerrequisitos

• Ubuntu 18.04
• Privilegios de root

¿Qué haremos?

1. Instalar Java
2. Instalar Jenkins
3. Instalar y configurar Apache2 como un proxy inverso para Jenkins
4. Configurar el cortafuegos UFW
5. Configurar Jenkins
6. Seguridad de Jenkins
7. Pruebas

Paso 1 - Instalar Java

Jenkins es una aplicación basada en Java, por lo que necesitamos instalar Java OpenJDK en el servidor. En este paso, instalaremos Java 8 desde un repositorio PPA que agregaremos primero.

Instala los paquetes software-properties-common, luego agrega el repositorio PPA de Java OpenJDK.

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

Ahora instala Java 8 usando el comando apt.

sudo apt install openjdk-8-jdk -y

Cuando la instalación esté completa, verifica la versión de Java instalada en el sistema.

java -version

Y obtendrás que Java OpenJDK 1.8 está ahora instalado en el sistema Ubuntu 18.04.

Nota:

• Si tienes múltiples versiones de Java en tu sistema, cambia la versión de Java predeterminada usando el comando a continuación.

sudo update-alternatives --config java

Paso 2 - Instalar Jenkins

Jenkins proporciona un repositorio de Ubuntu para los paquetes de instalación y lo instalaremos desde este repositorio.

Agrega la clave y el repositorio de Jenkins al sistema con el comando a continuación.

wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -  
echo 'deb https://pkg.jenkins.io/debian-stable binary/' | tee -a /etc/apt/sources.list

Ahora actualiza el repositorio e instala Jenkins.

sudo apt update  
sudo apt install jenkins -y

Cuando la instalación esté completa, inicia el servicio de Jenkins y agrégalo al tiempo de arranque.

systemctl start jenkins  
systemctl enable jenkins

Jenkins ahora está en funcionamiento en el servidor Ubuntu 18.04, ejecutándose en el puerto predeterminado ‘8080’. Verifícalo usando netstat como se muestra a continuación.

netstat -plntu

Y obtendrás el resultado como se muestra a continuación.

Paso 3 - Instalar y configurar Apache2 como un proxy inverso para Jenkins

En este tutorial ejecutaremos Jenkins detrás de un servidor web Apache, configuraremos Apache como el proxy inverso para Jenkins.

Primero instalaremos Apache y habilitaremos algunos módulos requeridos, y luego crearemos el archivo de host virtual con el nombre de dominio jenkins.hakase-labs.io para Jenkins. Por favor, usa tu propio nombre de dominio aquí y reemplázalo en todos los archivos de configuración donde aparezca.

Instala el servidor web apache2 desde el repositorio de Ubuntu.

sudo apt install apache2 -y

Cuando la instalación esté completa, habilita los módulos proxy y proxy_http para que podamos configurar Apache como servidor frontal/proxy inverso para Jenkins.

a2enmod proxy  
a2enmod proxy_http

A continuación, crea un nuevo archivo de host virtual para Jenkins en el directorio sites-available.

cd /etc/apache2/sites-available/  
vim jenkins.conf

Pega la configuración del host virtual a continuación.

    ServerName        jenkins.hakase-labs.io
    ProxyRequests     Off
    ProxyPreserveHost On
    AllowEncodedSlashes NoDecode
 
    
      Order deny,allow
      Allow from all
    
 
    ProxyPass         /  http://localhost:8080/ nocanon
    ProxyPassReverse  /  http://localhost:8080/
    ProxyPassReverse  /  http://jenkins.hakase-labs.io/

Guarda y sal, luego activa el host virtual de Jenkins con el comando a2ensite.

a2ensite jenkins

Reinicia los servicios de Apache y Jenkins.

systemctl restart apache2  
systemctl restart jenkins

La instalación y configuración de apache2 como un proxy inverso para Jenkins se ha completado.

Paso 4 - Configurar el cortafuegos UFW

Antes de habilitar el cortafuegos UFW en el servidor Ubuntu, necesitamos agregar los puertos de servicios básicos como SSH, HTTP y HTTPS.

Agrega los servicios SSH, HTTP y HTTPS al cortafuegos ufw.

ufw allow ssh  
ufw allow http  
ufw allow https

Ahora inicia y habilita el cortafuegos ufw.

ufw enable

type ‘y’ y presiona Enter.

El cortafuegos UFW ahora está habilitado, y el puerto HTTP ha sido agregado.

Paso 5 - Configurar Jenkins

Jenkins está ejecutándose en el nombre de dominio ‘ http://jenkins.hakase-labs.io ‘. Abre tu navegador web y escribe la URL.

Obtendrás la pantalla que te solicita que ingreses la contraseña inicial de administrador. Una contraseña ya ha sido generada por Jenkins, así que solo necesitamos mostrar y copiar los resultados en el cuadro de contraseña.

Muestra la contraseña inicial de administrador de Jenkins con el comando cat.

cat /var/lib/jenkins/secrets/initialAdminPassword

Pega los resultados en la pantalla y haz clic en ‘Continuar’.

Ahora debemos instalar algunos complementos en Jenkins para tener una buena base para su uso posterior. Elige ‘Instalar complementos sugeridos’, haz clic en él.

Instalaciones de complementos de Jenkins en progreso.

Después de que la instalación de los complementos esté completa, necesitamos crear una nueva contraseña de administrador. Escribe tu nombre de usuario de administrador, contraseña, correo electrónico, etc., y haz clic en ‘Guardar y continuar’.

Para la configuración de la instancia, escribe el nombre de dominio de Jenkins ‘http://jenkins.hakase-labs.io’ y haz clic en el botón ‘Guardar y finalizar’.

Ahora haz clic en el botón ‘Comenzar a usar Jenkins’.

Y serás redirigido al panel de administración de Jenkins.

La instalación y configuración de Jenkins se ha completado con éxito.

Paso 6 - Seguridad de Jenkins

Desde el panel de administración de Jenkins, necesitamos configurar la configuración de seguridad estándar para Jenkins, haz clic en ‘Administrar Jenkins’ y luego en ‘Configurar seguridad global’.

Jenkins proporciona varios métodos de autorización en la sección ‘Control de acceso’. Usaremos la ‘Seguridad basada en matriz’, para que podamos controlar todos los privilegios de usuario.

Agrega el usuario ‘hakase’ en el cuadro ‘Usuario/Grupo’ y haz clic en agregar.

Dale al usuario ‘hakase’ todos los privilegios marcando todas las opciones, y haz clic en el botón ‘Guardar’.

Serás redirigido al panel, y si hay una opción de inicio de sesión, simplemente escribe tu usuario y contraseña de administrador.

Paso 7 - Pruebas

En esta sección, queremos crear un trabajo simple para el servidor Jenkins. Crearemos un trabajo simple para probar Jenkins y averiguar la carga del servidor con el comando top.

Desde el panel de administración de Jenkins, haz clic en ‘Crear nuevo trabajo’.

Escribe el nombre del trabajo. Usaremos ‘Comprobando el sistema’ aquí, selecciona ‘Proyecto estilo libre’ y haz clic en ‘OK’.

Ve a la pestaña ‘Construir’. En ‘Agregar paso de construcción’, selecciona la opción ‘Ejecutar shell’.

Escribe el comando a continuación en el cuadro.

top -b -n 1 | head -n 5

Haz clic en ‘Guardar’.

Ahora estás en la página del trabajo del trabajo ‘Proyecto comprobando el sistema’. Haz clic en ‘Construir ahora’ para ejecutar el trabajo ‘comprobando el sistema’.

Después de que el trabajo haya sido ejecutado, verás el ‘Historial de construcción’, haz clic en el primer trabajo para ver los resultados.

Aquí están los resultados del trabajo ejecutado por Jenkins.

La instalación y configuración de la herramienta de automatización Jenkins con Apache2 como un proxy inverso en Ubuntu 18.04 se ha completado con éxito.

Referencias

• https://wiki.jenkins.io/
• https://wiki.jenkins.io/Standard+Security+Setup
• https://jenkins-le-guide-complet.github.io/