Come installare Nexus Repository Manager su Ubuntu 22.04

Nexus è uno dei gestori di repository più popolari nel mondo DevOps. Ti consente di memorizzare e recuperare artefatti di build e fornisce anche funzionalità per inviare e ricevere artefatti tramite strumenti di integrazione CI e IDE come Visual Studio e Jenkins.

Ci sono due versioni del gestore di repository Nexus: la versione commerciale e la versione open source. Supporta molti formati come PyPi, Docker, Yum, APT, Helm, npm, Go, R e molti altri.

Utilizzare Nexus come repository consente ai tuoi sviluppatori di ottenere e gestire pacchetti sul gestore di repository centralizzato, il che fornisce anche al team di sviluppatori una singola fonte di verità per ogni pacchetto.

In questo tutorial, spiegheremo come installare il Nexus Repository Manager su un server Ubuntu 22.04. Questo tutorial include anche l’installazione di alcuni pacchetti come Java OpenJDK e il server web Nginx che verrà utilizzato come reverse proxy.

Prerequisiti

Prima di iniziare, avrai bisogno dei seguenti requisiti:

• Un server Ubuntu 22.04.
• Un utente non root con sudo/amministratore abilitato.
• Un nome di dominio puntato all’indirizzo IP del tuo server Ubuntu (per produzione).

Installazione di Java OpenJDK 8

Il Nexus Repository Manager richiede Java OpenJDK e JRE v8. Il repository predefinito di Ubuntu fornisce più versioni di Java, quindi ora installerai Java OpenJDK e JRE v8 dal repository di Ubuntu.

Prima di installare qualsiasi pacchetto, esegui il comando apt qui sotto per aggiornare e aggiornare l’indice dei pacchetti dei tuoi repository.

sudo apt update

Ora, installa Java OpenJDK 8 tramite il comando apt qui sotto. Inserisci Y quando richiesto di confermare l’installazione e premi INVIO per procedere.

sudo apt install openjdk-8-jdk

Una volta installato Java, verifica la versione di Java sul tuo sistema utilizzando il seguente comando.

java -version

Vedrai l’output nello screenshot seguente:

Configurazione del sistema

Per installare Nexus, dovrai creare un nuovo utente Linux dedicato con una shell valida e dovrai anche impostare il numero massimo di file aperti sia per i limiti hard che soft a ‘65536‘.

Esegui il seguente comando per creare un nuovo utente dedicato per Nexus con il nome ‘nexus‘

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

Successivamente, imposta il ulimit a ‘65536‘ utilizzando il comando qui sotto. Questo influenzerà solo il sistema attuale temporaneamente. Per renderlo permanente, puoi creare un nuovo file di configurazione che farai nel passaggio successivo.

ulimit -n 65536

Per impostare ulimit in modo permanente, crea un nuovo file di configurazione ‘/etc/security/limits.d/nexus.conf‘ utilizzando l’editor nano.

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

Aggiungi la seguente configurazione al file. In questo esempio, stai impostando ulimit per l’utente specifico ‘nexus‘ con il valore ‘65536‘.

nexus - nofile 65536

Salva il file ed esci dall’editor quando hai finito.

Con tutti i requisiti di base in atto e configurati, sei pronto per installare il Nexus Repository Manager sul tuo sistema Ubuntu.

Installazione del Nexus Repository Manager

Il Nexus Repository Manager può essere installato tramite il pacchetto di distribuzione che puoi scaricare dalla pagina di download ufficiale di Sonatype. Al momento della scrittura, l’ultima versione di Nexus è v3.41.1. Ora, scaricherai il pacchetto di distribuzione del Nexus Repository Manager e configurerai l’installazione di Nexus.

Scarica il pacchetto del Nexus Repository Manager tramite il comando wget come sotto. Se il processo di download è terminato, vedrai il file ‘nexus-3.41.1-01-unix.tar.gz’ nella tua directory di lavoro attuale.

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

Ora estrai il file ‘nexus-3.41.1-01-unix.tar.gz‘ tramite il comando tar qui sotto. Dovresti ottenere due directory, ‘nexus-3.41.1-01‘ e ‘sonatype-work‘.

La directory ‘nexus-3.41.1-01‘ è la directory principale per il pacchetto Nexus, e la directory ‘sonatype-work’ è la directory di lavoro principale per Nexus.

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

Successivamente, sposta quelle directory estratte in ‘/opt’ utilizzando il seguente comando. La directory del pacchetto Nexus sarà ‘/opt/nexus’ e la directory di lavoro di Nexus sarà ‘/opt/sonatype-work‘.

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

Infine, cambia la proprietà di entrambe le directory all’utente e al gruppo ‘nexus’ tramite il comando chown qui sotto.

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

Successivamente, configurerai la tua installazione di Nexus modificando alcuni dei file di configurazione di Nexus.

Apri il file ‘/opt/nexus/bin/nexus.rc’ utilizzando l’editor nano.

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

Decommenta l’opzione ‘run_as_user‘ e cambia il valore in ‘nexus’. Con questa configurazione, eseguirai l’applicazione Nexus come utente di sistema ‘nexus‘.

run_as_user="nexus"

Salva il file ed esci dall’editor quando hai finito.

Successivamente, apri il file di configurazione ‘/etc/nexus/bin/nexus.vmoptions’ utilizzando l’editor nano per impostare la memoria heap massima per Nexus.

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

Cambia la memoria heap massima predefinita per la tua installazione di Nexus nelle seguenti opzioni. Puoi cambiare la dimensione in ‘1024m‘ in base alla memoria che hai sul tuo server.

-Xms1024m  
-Xmx1024m  
-XX:MaxDirectMemorySize=1024m

Salva il file ed esci dall’editor quando hai completato.

Ora, modifica il file di configurazione ‘/opt/sonatype-work/nexus3/etc/nexus.properties‘ utilizzando l’editor nano.

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

Decommenta l’opzione ‘application-host’ e cambia il valore in ‘127.0.0.1‘. Questo significa che eseguirai Nexus su localhost o indirizzo IP ‘127.0.0.1‘.

application-host=127.0.0.1

Salva il file ed esci dall’editor.

Ora hai scaricato e configurato il Nexus Repository Manager. Successivamente, configurerai un file di servizio systemd per Nexus.

Esecuzione di Nexus come servizio SystemD

In un’installazione predefinita, il Nexus Repository Manager può essere eseguito manualmente tramite il comando binario ‘nexus’ che è disponibile nella directory ‘/opt/nexus/bin’. Ma, per semplificare la gestione di Nexus, configurerai un file di servizio systemd per Nexus.

Eseguire Nexus con un file di servizio systemd consente di gestire il processo nexus tramite il comando systemctl.

Ora, crea un nuovo file di servizio ‘/etc/systemd/system/nexus.service‘ utilizzando l’editor nano.

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

Aggiungi la seguente configurazione al file.

[Unit]  
Description=nexus service  
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

Salva il file ed esci dall’editor quando hai finito.

Successivamente, esegui il seguente comando per ricaricare il gestore systemd e applicare un nuovo file di servizio per Nexus.

sudo systemctl daemon-reload

Avvia e abilita il ‘nexus.service‘ tramite il comando systemctl qui sotto. Il Nexus Repository Manager ora si avvierà all’indirizzo IP locale 127.0.0.1 con la porta predefinita ‘8081’. Inoltre, il ‘nexus.service‘ verrà eseguito automaticamente all’avvio del sistema.

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

Infine, esegui il seguente comando per verificare il ‘nexus.service’ e assicurati che il servizio sia in esecuzione.

sudo systemctl status nexus.service

Con Nexus in esecuzione come servizio systemd, ora puoi configurare un reverse proxy per Nexus.

Esecuzione di Nexus con Reverse Proxy

Il Nexus Repository Manager è ora in esecuzione sull’indirizzo IP locale ‘127.0.0.1’ con la porta predefinita ‘8081’. Per renderlo accessibile dall’esterno della rete, utilizzerai il reverse proxy Nginx che verrà eseguito sulle porte HTTP/HTTPS standard.

Esegui il seguente comando apt per installare il server web Nginx sul tuo sistema Ubuntu. Quando ti viene chiesto di confermare l’installazione, inserisci Y e premi INVIO per procedere.

sudo apt install nginx

Una volta installato Nginx, esegui il seguente comando systemctl per controllare e verificare il servizio nginx. Dovresti vedere che il servizio nginx è abilitato e verrà eseguito automaticamente all’avvio del sistema. E lo stato del servizio nginx è in esecuzione.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Successivamente, crea una nuova configurazione del blocco del server ‘/etc/nginx/sites-available/nexus‘ utilizzando l’editor nano.

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

Aggiungi la seguente configurazione Nginx al file e assicurati di cambiare il nome di 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;  
    }  
}

Salva il file ed esci dall’editor.

Successivamente, esegui il seguente comando per attivare la configurazione del blocco del server per Nexus creando un collegamento simbolico del file di configurazione nella directory ‘sites-enabled‘. Quindi, verifica la configurazione di Nginx per assicurarti che Nginx sia configurato correttamente.

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

Se la tua configurazione Nginx è configurata correttamente, dovresti ricevere un messaggio di output come “test riuscito”.

Infine, esegui il seguente comando per riavviare il servizio Nginx e applicare la nuova configurazione del blocco del server per Nexus.

sudo systemctl restart nginx

Hai ora configurato il server web Nginx come reverse proxy per il Nexus Repository Manager sul tuo computer Ubuntu. Ora puoi accedere alla tua installazione di Nexus tramite il tuo nome di dominio.

Installazione del Nexus Repository Manager

A questo punto, il Nexus Repository Manager è in esecuzione sotto il reverse proxy Nginx. Ed è accessibile tramite il nome di dominio della tua installazione.

Apri il browser web e visita il nome di dominio della tua installazione di Nexus (cioè: http://nexus.howtoforge.local). E dovresti vedere la pagina predefinita di Nexus qui sotto.

Clicca sul pulsante “Accedi“ per accedere alla dashboard di amministrazione di Nexus.

La password predefinita dell’amministratore per Nexus è memorizzata nel file ‘/opt/sonatype-work/nexus3/admin.properties‘ con il nome utente predefinito admin.

Torna al tuo terminale ed esegui il seguente comando per ottenere la password predefinita per l’accesso a Nexus. Quindi, copia la password predefinita per Nexus.

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

Successivamente, inserisci l’utente admin e incolla la password per Nexus. Quindi, clicca su “Accedi“.

Ora vedrai la procedura guidata di configurazione del Nexus Repository Manager. Clicca su “Avanti“ per procedere.

Inserisci la nuova password forte per la tua installazione di Nexus e ripetila. Quindi, clicca su “Avanti“ di nuovo.

Per la configurazione dell’accesso “Anonimo”, seleziona l’opzione “Disabilita accesso anonimo“ e clicca su “Avanti“.

Ora clicca su “Fine“ per completare la configurazione di Nexus.

Dopo che la configurazione di Nexus è completata, ora vedrai la dashboard di amministrazione di Nexus. Nello screenshot qui sotto, puoi vedere il Nexus Repository Manager.

Infine, verifica la tua installazione di Nexus tramite il pulsante di controllo stato in alto. Ora assicurati che tutti gli stati di sistema siano controllati come verdi, il che significa che l’installazione e la configurazione di Nexus sono riuscite con successo.

Conclusione

In questo tutorial, hai configurato il Nexus Repository Manager su un server Ubuntu 22.04. Hai anche configurato il server web Nginx come reverse proxy per Nexus. Ora puoi aggiungere i repository dei tuoi progetti al gestore di repository Nexus e centralizzare la fonte dei tuoi progetti in modo da poter facilmente costruire e distribuire le tue applicazioni agli sviluppatori.

Se sei interessato a eseguire Nexus in produzione, puoi configurare la sicurezza per il tuo nexus con SSL/TLS tramite Letsencrypt.