Cómo instalar Nexus Repository Manager en Ubuntu 22.04

Nexus es uno de los gestores de repositorios más populares en el mundo de DevOps. Te permite almacenar y recuperar artefactos de construcción y también proporciona funciones para enviar y recibir artefactos a través de herramientas de integración CI e IDE como Visual Studio y Jenkins.

Hay dos versiones del gestor de repositorios Nexus: la versión comercial y la versión de código abierto. Soporta muchos formatos como PyPi, Docker, Yum, APT, Helm, npm, Go, R, y muchos más.

Usar Nexus como repositorio permite a tus desarrolladores obtener y gestionar paquetes en el gestor de repositorios centralizado, lo que también proporciona al equipo de desarrolladores una única fuente de verdad para cada paquete.

En este tutorial, explicaremos cómo instalar el Nexus Repository Manager en un servidor Ubuntu 22.04. Este tutorial también incluye la instalación de algunos paquetes como Java OpenJDK y el servidor web Nginx que se utilizará como un proxy inverso.

Requisitos previos

Antes de comenzar, necesitarás los siguientes requisitos:

• Un servidor Ubuntu 22.04.
• Un usuario no root con sudo/administrador habilitado.
• Un nombre de dominio apuntando a la dirección IP de tu servidor Ubuntu (para producción).

Instalando Java OpenJDK 8

El Nexus Repository Manager requiere Java OpenJDK y JRE v8. El repositorio predeterminado de Ubuntu proporciona múltiples versiones de Java, así que ahora instalarás Java OpenJDK y JRE v8 desde el repositorio de Ubuntu.

Antes de instalar cualquier paquete, ejecuta el comando apt a continuación para actualizar y refrescar el índice de paquetes de tus repositorios.

sudo apt update

Ahora, instala Java OpenJDK 8 a través del comando apt a continuación. Ingresa Y cuando se te pida confirmar la instalación y presiona ENTER para continuar.

sudo apt install openjdk-8-jdk

Una vez que Java esté instalado, verifica la versión de Java en tu sistema usando el siguiente comando.

java -version

Verás la salida en la siguiente captura de pantalla:

Configurando el sistema

Para instalar Nexus, necesitarás crear un nuevo usuario de Linux dedicado con un shell válido y también necesitarás configurar el máximo de archivos abiertos tanto para límites duros como blandos a ‘65536‘.

Ejecuta el siguiente comando para crear un nuevo usuario dedicado para Nexus con el nombre ‘nexus‘.

sudo useradd -d /opt/nexus -s /bin/bash nexus  
sudo passwd nexus

A continuación, establece el ulimit a ‘65536‘ usando el siguiente comando. Esto solo afectará al sistema en el sistema actual temporalmente. Para hacerlo permanente, puedes crear un nuevo archivo de configuración que harás en el siguiente paso.

ulimit -n 65536

Para establecer ulimit de forma permanente, crea un nuevo archivo de configuración ‘/etc/security/limits.d/nexus.conf‘ usando el editor nano.

sudo nano /etc/security/limits.d/nexus.conf

Agrega la siguiente configuración al archivo. En este ejemplo, estás configurando ulimit para el usuario específico ‘nexus‘ con el valor ‘65536‘.

nexus - nofile 65536

Guarda el archivo y sal del editor cuando hayas terminado.

Con todos los requisitos básicos en su lugar y configurados, estás listo para instalar el Nexus Repository Manager en tu sistema Ubuntu.

Instalando Nexus Repository Manager

El Nexus Repository Manager se puede instalar a través del paquete de distribución que puedes descargar desde la página de descarga oficial de Sonatype. En el momento de escribir esto, la última versión de Nexus es v3.41.1. Ahora, descargarás el paquete de distribución del Nexus Repository Manager y configurarás la instalación de Nexus.

Descarga el paquete del Nexus Repository Manager a través del comando wget como se indica a continuación. Si el proceso de descarga ha terminado, verás el archivo ‘nexus-3.41.1-01-unix.tar.gz’ en tu directorio de trabajo actual.

wget https://download.sonatype.com/nexus/3/nexus-3.41.1-01-unix.tar.gz

Ahora extrae el archivo ‘nexus-3.41.1-01-unix.tar.gz‘ a través del comando tar a continuación. Y deberías obtener dos directorios, ‘nexus-3.41.1-01‘ y ‘sonatype-work‘.

El directorio ‘nexus-3.41.1-01‘ es el directorio principal para el paquete Nexus, y el directorio ‘sonatype-work’ es el directorio de trabajo principal para Nexus.

tar xzf nexus-3.41.1-01-unix.tar.gz

A continuación, mueve esos directorios extraídos a ‘/opt’ usando el siguiente comando. El directorio del paquete Nexus será ‘/opt/nexus’ y el directorio de trabajo de Nexus será ‘/opt/sonatype-work‘.

mv nexus-3.41.1-01 /opt/nexus  
mv sonatype-work /opt/

Por último, cambia la propiedad de ambos directorios al usuario y grupo ‘nexus’ a través del comando chown a continuación.

chown -R nexus:nexus /opt/nexus /opt/sonatype-work

A continuación, configurarás tu instalación de Nexus editando algunos de los archivos de configuración de Nexus.

Abre el archivo ‘/opt/nexus/bin/nexus.rc’ usando el editor nano.

sudo nano /opt/nexus/bin/nexus.rc

Descomenta la opción ‘run_as_user‘ y cambia el valor a ‘nexus’. Con esta configuración, estarás ejecutando la aplicación Nexus como el usuario del sistema ‘nexus‘.

run_as_user="nexus"

Guarda el archivo y sal del editor cuando hayas terminado.

A continuación, abre el archivo de configuración ‘/etc/nexus/bin/nexus.vmoptions’ usando el editor nano para configurar la memoria máxima del montón para Nexus.

sudo nano /etc/nexus/bin/nexus.vmoptions

Cambia la memoria máxima del montón predeterminada para tu instalación de Nexus en las siguientes opciones. Puedes cambiar el tamaño a ‘1024m‘ según la memoria que tengas en tu servidor.

-Xms1024m  
-Xmx1024m  
-XX:MaxDirectMemorySize=1024m

Guarda el archivo y sal del editor cuando hayas terminado.

Ahora, edita el archivo de configuración ‘/opt/sonatype-work/nexus3/etc/nexus.properties‘ usando el editor nano.

sudo nano /opt/sonatype-work/nexus3/etc/nexus.properties

Descomenta la opción ‘application-host’ y cambia el valor a ‘127.0.0.1‘. Esto significa que estarás ejecutando Nexus en localhost o en la dirección IP ‘127.0.0.1‘.

application-host=127.0.0.1

Guarda el archivo y sal del editor.

Ahora tienes el Nexus Repository Manager descargado y configurado. A continuación, configurarás un archivo de servicio systemd para Nexus.

Ejecutando Nexus como Servicio SystemD

En una instalación predeterminada, el Nexus Repository Manager se puede ejecutar manualmente a través del comando binario ‘nexus’ que está disponible en el directorio ‘/opt/nexus/bin’. Pero, para facilitar la gestión de Nexus, configurarás un archivo de servicio systemd para Nexus.

Ejecutar Nexus con un archivo de servicio systemd te permite gestionar el proceso de nexus a través del comando systemctl.

Ahora, crea un nuevo archivo de servicio ‘/etc/systemd/system/nexus.service‘ usando el editor nano.

sudo nano /etc/systemd/system/nexus.service

Agrega la siguiente configuración al archivo.

[Unit]  
Description=servicio nexus  
After=network.target  
  
[Service]  
Type=forking  
LimitNOFILE=65536  
ExecStart=/opt/nexus/bin/nexus start  
ExecStop=/opt/nexus/bin/nexus stop  
User=nexus  
Restart=on-abort  
  
[Install]  
WantedBy=multi-user.target

Guarda el archivo y sal del editor cuando hayas terminado.

A continuación, ejecuta el siguiente comando para recargar el gestor de systemd y aplicar un nuevo archivo de servicio para Nexus.

sudo systemctl daemon-reload

Inicia y habilita el ‘nexus.service‘ a través del comando systemctl a continuación. El Nexus Repository Manager ahora se iniciará en la dirección IP local 127.0.0.1 con el puerto predeterminado ‘8081’. Además, el ‘nexus.service‘ se ejecutará automáticamente al inicio del sistema.

sudo systemctl start nexus.service  
sudo systemctl enable nexus.service

Por último, ejecuta el siguiente comando para verificar el ‘nexus.service’ y asegurarte de que el servicio esté en funcionamiento.

sudo systemctl status nexus.service

Con Nexus ejecutándose como un servicio systemd, ahora puedes configurar un proxy inverso para Nexus.

Ejecutando Nexus con Proxy Inverso

El Nexus Repository Manager ahora se está ejecutando en la dirección IP local ‘127.0.0.1’ con el puerto predeterminado ‘8081’. Para hacerlo accesible desde fuera de la red, utilizarás el proxy inverso Nginx que se ejecutará en los puertos HTTP/HTTPS estándar.

Ejecuta el siguiente comando apt para instalar el servidor web Nginx en tu sistema Ubuntu. Cuando se te pida confirmar la instalación, ingresa Y y presiona ENTER para continuar.

sudo apt install nginx

Una vez que Nginx esté instalado, ejecuta el siguiente comando systemctl para verificar y comprobar el servicio nginx. Deberías ver que el servicio nginx está habilitado y se ejecutará automáticamente al inicio del sistema. Y el estado del servicio nginx está en ejecución.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

A continuación, crea una nueva configuración de bloque de servidor ‘/etc/nginx/sites-available/nexus‘ usando el editor nano.

sudo nano /etc/nginx/sites-available/nexus

Agrega la siguiente configuración de Nginx al archivo y asegúrate de cambiar el nombre de dominio.

upstream nexus3 {  
  server 127.0.0.1:8081;  
}  
  
server {  
    listen 80;  
    server_name nexus.howtoforge.local;  
  
    location / {  
        proxy_pass http://nexus3/;  
        proxy_http_version 1.1;  
        proxy_set_header Upgrade $http_upgrade;  
        proxy_set_header Connection "upgrade";  
        proxy_set_header Host $http_host;  
  
        proxy_set_header X-Real-IP $remote_addr;  
        proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;  
        proxy_set_header X-Forward-Proto http;  
        proxy_set_header X-Nginx-Proxy true;  
  
        proxy_redirect off;  
    }  
}

Guarda el archivo y sal del editor.

A continuación, ejecuta el siguiente comando para activar la configuración del bloque de servidor para Nexus creando un enlace simbólico del archivo de configuración al directorio ‘sites-enabled‘. Luego, verifica la configuración de Nginx para asegurarte de que Nginx esté configurado correctamente.

sudo ln -s /etc/nginx/sites-available/nexus /etc/nginx/sites-enabled/  
sudo nginx -t

Si tu configuración de Nginx está configurada correctamente, deberías obtener el mensaje de salida como “la prueba es exitosa”.

Por último, ejecuta el siguiente comando para reiniciar el servicio Nginx y aplicar la nueva configuración del bloque de servidor para Nexus.

sudo systemctl restart nginx

Ahora has configurado el servidor web Nginx como un proxy inverso para el Nexus Repository Manager en tu máquina Ubuntu. Ahora puedes acceder a tu instalación de Nexus a través de tu nombre de dominio.

Instalación del Nexus Repository Manager

En este punto, el Nexus Repository Manager se está ejecutando bajo el proxy inverso de Nginx. Y es accesible a través del nombre de dominio de tu instalación.

Abre el navegador web y visita el nombre de dominio de tu instalación de Nexus (es decir, http://nexus.howtoforge.local). Y deberías obtener la página predeterminada de Nexus como se muestra a continuación.

Haz clic en el botón “Iniciar sesión“ para acceder al panel de administración de Nexus.

La contraseña predeterminada de administrador para Nexus se almacena en el archivo ‘/opt/sonatype-work/nexus3/admin.properties‘ con el nombre de usuario predeterminado admin.

Vuelve a tu terminal y ejecuta el siguiente comando para obtener la contraseña predeterminada para el inicio de sesión de Nexus. Luego, copia la contraseña predeterminada para Nexus.

cat /opt/sonatype-work/nexus3/admin.properties

A continuación, ingresa el usuario admin y pega la contraseña para Nexus. Luego, haz clic en “Iniciar sesión“.

Ahora verás el asistente de configuración del Nexus Repository Manager. Haz clic en “Siguiente“ para continuar.

Ingresa la nueva contraseña fuerte para tu instalación de Nexus y repítela. Luego, haz clic en “Siguiente“ nuevamente.

Para la configuración de “Acceso anónimo”, selecciona la opción “Deshabilitar acceso anónimo“ y haz clic en “Siguiente“.

Ahora haz clic en “Finalizar“ para completar la configuración de Nexus.

Después de que la configuración de Nexus se complete, ahora verás el panel de administración de Nexus. En la captura de pantalla a continuación, puedes ver el Nexus Repository Manager.

Por último, verifica tu instalación de Nexus a través del botón de verificación de estado en la parte superior. Ahora asegúrate de que todo el estado del sistema esté marcado en verde, lo que significa que la instalación y configuración de Nexus se realizaron con éxito.

Conclusión

En este tutorial, has configurado el Nexus Repository Manager en un servidor Ubuntu 22.04. También has configurado el servidor web Nginx como un proxy inverso para Nexus. Ahora puedes agregar repositorios de tus proyectos al gestor de repositorios Nexus y centralizar la fuente de tus proyectos para que puedas construir y distribuir fácilmente tus aplicaciones a los desarrolladores.

Si estás interesado en ejecutar Nexus en producción, puedes configurar la seguridad para tu nexus con SSL/TLS a través de Letsencrypt.