Cómo instalar el servidor de automatización Jenkins con Apache en Ubuntu 16.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 software gratuito.

En este tutorial, te mostraré cómo instalar la última versión de Jenkins en Ubuntu Server 16.04. Ejecutaremos Jenkins en nuestro propio nombre de dominio, y vamos a instalar y configurar Jenkins para que se ejecute bajo el servidor web Apache con el proxy inverso para Jenkins.

Requisitos previos

Ubuntu Server 16.04 - 64bit
Privilegios de root

Paso 1 - Instalar Java OpenJDK 7

Jenkins se basa en Java, por lo que necesitamos instalar Java OpenJDK versión 7 en el servidor. En este paso, instalaremos Java 7 desde un repositorio PPA que agregaremos primero.

Por defecto, Ubuntu 16.04 se envía sin el paquete python-software-properties para gestionar repositorios PPA, así que debemos instalar este paquete primero. Instala python-software-properties con el comando apt.

apt-get install python-software-properties

A continuación, agrega el repositorio PPA de Java al servidor.

add-apt-repository ppa:openjdk-r/ppa  
Solo presiona ENTER

Actualiza el repositorio de Ubuntu e instala Java OpenJDK con el comando apt.

apt-get update  
apt-get install openjdk-7-jdk

Verifica la instalación escribiendo el siguiente comando:

java -version

y obtendrás la versión de Java que está instalada en el servidor.

Instalar Java 7 openJDK en Ubuntu 16.04

Paso 2 - Instalar Jenkins

Jenkins proporciona un repositorio de Ubuntu para los paquetes de instalación y vamos a instalar Jenkins desde este repositorio.

Agrega la clave y el repositorio de Jenkins al sistema con el siguiente comando.

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

Actualiza el repositorio e instala Jenkins.

apt-get update  
apt-get install jenkins

Cuando la instalación esté completa, inicia Jenkins con este comando systemctl.

systemctl start jenkins

Verifica que Jenkins esté en ejecución comprobando el puerto predeterminado utilizado por Jenkins (puerto 8080). Lo comprobaré con el comando netstat a continuación:

netstat -plntu

Jenkins está instalado y en ejecución en el puerto 8080.

Jenkins se ha instalado en el puerto 8080

Paso 3 - Instalar y configurar Apache como 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 instalaré Apache y habilitaré algunos módulos requeridos, y luego crearé el archivo de host virtual con el nombre de dominio my.jenkins.id para Jenkins. Por favor, utiliza 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.

apt-get install apache2

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 en el directorio sites-available.

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

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

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

Guarda el archivo. Luego activa el host virtual de Jenkins con el comando a2ensite.

a2ensite jenkins

Reinicia Apache y Jenkins.

systemctl restart apache2  
systemctl restart jenkins

Verifica que los puertos 80 y 8000 estén en uso por Jenkins y Apache.

netstat -plntu

Verifica que Apache y Jenkins estén en ejecución

Paso 4 - Configurar Jenkins

Jenkins está ejecutándose en el nombre de dominio ‘my.jenkins.id’. 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  
   
a1789d1561bf413c938122c599cf65c9

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

Instalación y configuración de Jenkins

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

Instalar complementos de Jenkins

Instalaciones de complementos de Jenkins en progreso.

Los complementos de Jenkins se están instalando

Después de la instalación del complemento, debemos 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 finalizar‘.

Crear cuenta de administrador de Jenkins

Haz clic en iniciar y comienza a usar Jenkins. Serás redirigido al panel de administración de Jenkins.

Ser redirigido al panel de administración

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

El panel de administración de Jenkins

Paso 5 - 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‘.

Configuración de seguridad global de Jenkins

Jenkins proporciona varios métodos de autorización en la sección ‘Control de acceso‘. Selecciono ‘Seguridad basada en matriz‘ para poder controlar todos los privilegios de los usuarios. Habilita el usuario administrador en el cuadro ‘Usuario/Grupo‘ y haz clic en agregar. Dale al administrador todos los privilegios marcando todas las opciones, y dale al anónimo solo permisos de lectura. Ahora haz clic en ‘Guardar‘.

Configurar permisos de Jenkins

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 6 - Probar un trabajo de automatización simple

En esta sección, solo quiero probar un trabajo simple para el servidor Jenkins. Crearé 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‘.

Crear un nuevo trabajo en Jenkins

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

Configurar nuevo trabajo de Jenkins

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

Escribe el siguiente comando en el cuadro.

top -b -n 1 | head -n 5

Haz clic en ‘Guardar‘.

Iniciar un trabajo de Jenkins

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 se haya 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.

Construir y ejecutar un trabajo de Jenkins

La instalación de Jenkins con el servidor web Apache en Ubuntu 16.04 se completó con éxito.