Cómo instalar el servidor de automatización Jenkins con Nginx en CentOS 7

Jenkins es un servidor de integración continua gratuito y de código abierto. Está escrito en JAVA. Se puede utilizar para automatizar diversas tareas relacionadas con el desarrollo de software, como la construcción, las pruebas y el despliegue. Tiene soporte para muchos sistemas de control de versiones como git, SVN, mercurial, etc.

En este tutorial, instalaremos el servidor de automatización Jenkins en un servidor CentOS 7. También configuraremos Nginx como un proxy inverso para Jenkins.

Requisitos previos

• Servidor CentOS 7 mínimo
• Privilegios de root. Esta guía está escrita como el usuario root, si has iniciado sesión como usuario sudo, ejecuta sudo -i.

Actualizar el sistema base

Antes de instalar cualquier paquete, se recomienda que actualices los paquetes y el repositorio utilizando el siguiente comando.

yum -y update

Una vez que tu sistema esté actualizado, procede a instalar JAVA.

Instalar JAVA 8

Jenkins admite tanto OpenJDK como Oracle JAVA, en este tutorial instalaremos la última versión de OpenJDK en el servidor. Ejecuta el siguiente comando para instalar OpenJDK en tu servidor.

yum install java-1.8.0-openjdk

Ahora puedes verificar la versión de Java utilizando el siguiente comando.

java -version

Obtendrás la siguiente salida.

[root@liptan-pc ~]# java -version
openjdk version "1.8.0_131"
OpenJDK Runtime Environment (build 1.8.0_131-b12)
OpenJDK 64-Bit Server VM (build 25.131-b12, mixed mode)

También necesitarás verificar si la variable de entorno JAVA_HOME está configurada. Ejecuta el siguiente comando para ello.

echo $JAVA_HOME

Si obtienes una salida nula o en blanco, necesitarás configurar manualmente la variable JAVA_HOME. Edita el archivo .bash_profile utilizando tu editor favorito. En este tutorial, utilizaremos el editor nano. Ejecuta el siguiente comando para editar .bash_profile usando nano.

nano ~/.bash_profile

Ahora agrega las siguientes líneas al final del archivo.

export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64/
export JRE_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64/jre

Ahora carga el archivo utilizando el siguiente comando.

source ~/.bash_profile

Ahora puedes ejecutar el comando echo $JAVA_HOME nuevamente para verificar si la variable de entorno está configurada o no.

[root@pc ~]# echo $JAVA_HOME 
/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64/

Ahora que tienes JAVA instalado, puedes proceder a instalar Jenkins.

Instalar Jenkins

Jenkins se puede instalar directamente agregando el repositorio e importando la clave GPG. Agrega el repositorio de Jenkins a tu sistema ejecutando el siguiente comando.

wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo

Si no tienes wget instalado, puedes ejecutar yum -y install wget.

Importa la clave GPG ejecutando el siguiente comando.

rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

Una vez que la importación sea exitosa, puedes instalar Jenkins ejecutando el siguiente comando.

yum -y install jenkins

Jenkins ahora está instalado en tu servidor. Todos los paquetes requeridos están ahora instalados. El instalador también creó un nuevo usuario jenkins para ejecutar el proceso. Puedes proceder a iniciar el servidor.

Iniciar Jenkins

Puedes iniciar Jenkins ejecutando el siguiente comando.

systemctl start jenkins

Para detener Jenkins, puedes ejecutar el siguiente comando.

systemctl stop jenkins

Puedes verificar el estado del proceso ejecutando el siguiente comando.

systemctl status jenkins

Instalar Nginx

En lugar de acceder a la aplicación en el puerto 8080, podemos crear un proxy inverso para la aplicación con el servidor web Apache o Nginx. En este tutorial, vamos a usar nginx como el proxy inverso para tu aplicación. Ahora nginx se ejecutará detrás del servidor proxy nginx. nginx no está disponible en el repositorio YUM predeterminado. Necesitarás instalar el repositorio EPEL para instalar Nginx.

yum -y install epel-release

Ahora puedes instalar Nginx ejecutando:

yum -y install nginx

Crea un nuevo bloque de servidor ejecutando el siguiente comando.

nano /etc/nginx/conf.d/jenkins.conf

Rellena el archivo con el siguiente contenido. Reemplaza ci.tudominio.com con tu nombre de dominio real.

upstream jenkins{
    server 127.0.0.1:8080;
}

server{
    listen      80;
    server_name ci.tudominio.com;

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

    proxy_buffers 16 64k;
    proxy_buffer_size 128k;

    location / {
        proxy_pass  http://jenkins;
        proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
        proxy_redirect off;

        proxy_set_header    Host            $host;
        proxy_set_header    X-Real-IP       $remote_addr;
        proxy_set_header    X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header    X-Forwarded-Proto https;
    }

}

Guarda el archivo y sal del editor. Ahora puedes iniciar Nginx ejecutando el siguiente comando.

systemctl start nginx

Para habilitar Nginx para que se inicie automáticamente al arrancar, ejecuta el siguiente comando.

systemctl enable nginx

Configurar el firewall y SELinux

Si tienes un firewall en ejecución en tu servidor, necesitarás permitir el puerto 8080 y el puerto HTTP estándar a través del firewall. Ejecuta el siguiente comando para agregar las reglas del firewall para permitir el puerto 8080 y 80.

firewall-cmd --zone=public --add-port=8080/tcp --permanent

firewall-cmd --zone=public --add-service=http --permanent

Recarga las zonas del firewall ejecutando:

firewall-cmd --reload

Configura SELinux para la configuración del proxy nginx ejecutando el siguiente comando.

setsebool httpd_can_network_connect 1 -P

Configurar Jenkins

Ahora puedes acceder a la interfaz web del servidor CI de Jenkins yendo a la siguiente dirección web.

http://ci.tudominio.com

Reemplaza ci.tudominio.com con tu dominio real. Verás la siguiente interfaz.

Te pedirá tu contraseña de administrador inicial, que es generada por el instalador y almacenada en el archivo /var/lib/jenkins/secrets/initialAdminPassword. Ejecuta el siguiente comando para obtener la contraseña de administrador inicial.

cat /var/lib/jenkins/secrets/initialAdminPassword

Usa la contraseña para iniciar sesión y proceder.

En la siguiente sección, se te preguntará qué complementos deseas instalar; para principiantes, se recomienda elegir Instalar complementos sugeridos.

Esto instalará todos los complementos necesarios para comenzar.

En la siguiente interfaz, se instalarán los complementos.

Ahora necesitarás crear un usuario administrador para tu panel de administración de Jenkins.

Finalmente, serás llevado al panel de administración de Jenkins.

Conclusión

Ahora puedes usar Jenkins para la integración continua en el desarrollo de software. Puedes aprender más sobre Jenkins visitando el sitio web de Jenkins.