Come installare Jenkins su Ubuntu 22.04

Jenkins è uno strumento di automazione open-source per l’Integrazione Continua/Consegna Continua (CI/CD). È interamente scritto in Java con il supporto di oltre 1000 plugin per costruire, distribuire e automatizzare il tuo progetto. Jenkins è diventato uno dei principali strumenti di automazione che accelera il tuo processo di sviluppo attraverso l’automazione. Jenkins integra i processi del ciclo di vita dello sviluppo come build, documentazione, test, pacchettizzazione, staging, distribuzione, analisi statica e molti altri.

Jenkins supporta diversi strumenti di controllo versione come Git, Subversion, Mercurial, CVS, Perforce e RTC. Inoltre, può eseguire Apache Ant, Apache Maven, script shell e comandi batch di Windows. Jenkins ha un forte supporto della comunità con una documentazione estesa e un wiki, il che rende Jenkins uno degli strumenti di automazione CI/CD più utilizzati. Inoltre, offre molti strumenti, linguaggi e attività di automazione per automatizzare il tuo processo di sviluppo e distribuzione.

In questo tutorial, imparerai come installare Jenkins sull’ultima versione di Ubuntu 22.04. Questo tutorial copre anche come impostare Apache2 come proxy inverso per Jenkins con una connessione SSL abilitata. Alla fine, imparerai anche come creare il primo progetto di build di Jenkins per eseguire script shell o comandi.

Requisiti

Un server Ubuntu 20.04
Un utente non root con privilegi di amministratore root.

Installazione di Java

In questo primo passaggio, installerai Java OpenJDK e JRE sul tuo sistema Ubuntu. L’ultima versione di Jenkins richiede Java v11, e ora lo installerai sul tuo sistema.

Prima di iniziare a installare qualsiasi pacchetto, esegui il comando apt qui sotto per aggiornare e rinfrescare il tuo repository Ubuntu.

sudo apt update

Ora installa Java OpenJDK 11 utilizzando il seguente comando.

sudo apt install openjdk-11-jre

Inserisci Y per confermare e premi ENTER per avviare l’installazione. Ora l’installazione di Java OpenJDK inizierà.

installazione java openjdk

Dopo che l’installazione è completata, esegui il comando java qui sotto per controllare e verificare la versione di java.

java --version

Nello screenshot seguente, puoi vedere che Java OpenJDK 11 è installato sulla macchina Ubuntu 22.04.

Installazione di Jenkins

Hai ora installato Java sul tuo sistema Ubuntu, ora inizierai a installare Jenkins sulla macchina Ubuntu 22.04.

Ci sono diversi modi per installare Jenkins, il modo più semplice è utilizzare il pacchetto Jenkins precompilato fornito dal repository ufficiale di Jenkins. E per farlo, dovrai aggiungere il repository di Jenkins al tuo sistema Ubuntu.

Esegui il comando qui sotto per aggiungere la chiave GPG per il repository di Jenkins.

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \  
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

Dopo di che, aggiungi il repository di Jenkins al tuo sistema utilizzando il comando qui sotto.

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \  
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \  
  /etc/apt/sources.list.d/jenkins.list > /dev/null

Ora esegui il comando apt qui sotto per aggiornare e rinfrescare tutti i repository del tuo sistema.

sudo apt update

Nello screenshot qui sotto puoi vedere che il repository di Jenkins è stato aggiunto.

aggiungi repository jenkins

Successivamente, puoi installare Jenkins utilizzando il comando apt qui sotto.

sudo apt install jenkins

Inserisci Y per confermare l’installazione e premi ENTER per continuare. L’installazione di Jenkins inizierà ora.

installare jenkins

Dopo che l’installazione è completata, esegui il seguente comando per avviare e abilitare il servizio Jenkins.

sudo systemctl start jenkins  
sudo systemctl enable jenkins

Ora verifica il servizio Jenkins utilizzando il comando qui sotto.

sudo systemctl status jenkins

Nello screenshot seguente, il servizio Jenkins è attivo e in esecuzione. È in esecuzione su localhost con la porta predefinita 8080. Inoltre, Jenkins è ora abilitato, il che significa che verrà eseguito automaticamente all’avvio del sistema.

avvia abilita verifica servizio jenkins

Configurazione di Apache2 come Proxy Inverso

A questo punto, Jenkins è attivo e in esecuzione all’indirizzo predefinito localhost con la porta 8080. Ora installerai e configurerai il server web Apache2 come proxy inverso per Jenkins.

Il server web Apache2 verrà eseguito davanti al servizio Jenkins e aprirà le porte standard HTTP e HTTPS per l’accesso dei client.

Esegui il comando apt qui sotto per installare il pacchetto apache2 sul tuo sistema.

sudo apt install apache2

Inserisci Y per confermare l’installazione e premi ENTER per continuare.

installazione apache2

Ora, dopo che l’installazione è completata, esegui il comando qui sotto per abilitare alcuni moduli apache2 necessari per la configurazione del proxy inverso.

sudo a2enmod ssl rewrite headers proxy proxy_http

Ora vedrai l’output come nello screenshot seguente.

abilita moduli apache2

Successivamente, crea una nuova configurazione di host virtuale /etc/apache2/sites-available/jenkins.conf utilizzando l’editor nano.

sudo nano /etc/apache2/sites-available/jenkins.conf

Aggiungi la seguente configurazione al file. E assicurati di cambiare il nome di dominio e il percorso dei certificati SSL.

  
    ServerAdmin  webmaster@localhost  
    Redirect permanent / https://jenkins.howtoforge.local/  
  
  
  
    SSLEngine On  
    SSLCertificateFile /etc/letsencrypt/live/jenkins.howtoforge.local/fullchain.pem  
    SSLCertificateKeyFile /etc/letsencrypt/live/jenkins.howtoforge.local/privkey.pem  
    ServerAdmin  webmaster@localhost  
    ProxyRequests     Off  
    ProxyPreserveHost On  
    AllowEncodedSlashes NoDecode  
      
        Order deny,allow  
        Allow from all  
      
    ProxyPass         /  http://localhost:8080/ nocanon  
    ProxyPassReverse  /  http://localhost:8080/  
    ProxyPassReverse  /  http://jenkins.howtoforge.local/  
    RequestHeader set X-Forwarded-Proto "https"  
    RequestHeader set X-Forwarded-Port "443"

Salva e chiudi il file quando hai finito.

Successivamente, esegui il seguente comando per attivare la configurazione dell’host virtuale jenkins.conf.

sudo a2ensite jenkins.conf

Dopo di che, controlla e verifica tutte le tue configurazioni di Apache2 utilizzando il comando qui sotto.

sudo apachectl configtest

Assicurati di ricevere il messaggio di output come “ Syntax OK “, il che significa che tutte le tue configurazioni di Apache2 sono corrette.

Infine, esegui il comando qui sotto per riavviare il servizio Apache2 e applicare le nuove modifiche alla tua configurazione di Apache2.

sudo systemctl restart apache2

Ora il server web Apache2 è attivo e in esecuzione con la configurazione del proxy inverso per Jenkins.

configura apache2 proxy inverso jenkins

Inizio dell’Installazione di Jenkins

A questo punto, sei pronto per avviare l’installazione e la configurazione di Jenkins dal tuo browser web. Ma prima di iniziare a configurare Jenkins, dovrai ottenere e ottenere la password di inizializzazione per Jenkins.

La password di inizializzazione per Jenkins è disponibile nel file /var/lib/jenkins/secrets/initialAdminPassword. Questo file contiene la password segreta generata per inizializzare la tua installazione di Jenkins.

Esegui il comando qui sotto per controllare e ottenere la password iniziale di jenkins.

ls /var/lib/jenkins/secrets/initialAdminPassword  
cat /var/lib/jenkins/secrets/initialAdminPassword

Nello screenshot qui sotto puoi vedere una stringa casuale generata da Jenkins. Potresti avere una diversa segreta casuale.

Copia la password segreta iniziale nel tuo appunto, questa sarà utilizzata in seguito per impostare Jenkins.

password inizializzazione jenkins

Apri il tuo browser web e visita l’URL di installazione per la tua installazione di Jenkins (ad es. https://jenkins.howtoforge.local).

Nella prima pagina, ti verrà chiesto di inserire la password di inizializzazione per Jenkins. Incolla la tua password segreta per inizializzare l’installazione e la configurazione di Jenkins e poi clicca su Continua.

inizializzazione password jenkins

Ora clicca sul pulsante “ Installa plugin suggeriti “ per avviare la configurazione di Jenkins con plugin aggiuntivi. Questa opzione è buona per i principianti, installerà automaticamente alcuni plugin di Jenkins che potrebbero essere necessari per il tuo progetto.

installa plugin suggeriti

Ora l’installazione del plugin di Jenkins inizierà e partirà.

jenkins installazione plugin

Dopo che il processo di installazione è completato, ti verrà chiesto di creare un nuovo utente admin per Jenkins.

Inserisci il nuovo utente admin, la password, l’indirizzo email e il nome completo per la tua installazione di Jenkins e clicca sul pulsante Salva e Continua.

configura admin jenkins

Per l’URL di installazione di Jenkins, inserisci il tuo dominio Jenkins e clicca su Salva e Finisci.

configura url jenkins

E ora riceverai la seguente pagina. Clicca sul pulsante Riavvia per riavviare il servizio Jenkins e applicare le nuove configurazioni.

riavvia jenkins

Una volta che Jenkins è riavviato, visita di nuovo il nome di dominio della tua URL di installazione di Jenkins e ora vedrai la pagina di accesso di Jenkins.

Inserisci il tuo utente admin e la password per Jenkins e clicca su Accedi.

accesso a jenkins

Una volta effettuato l’accesso, vedrai il seguente dashboard di Jenkins.

dashboard jenkins

Hai ora installato e configurato con successo Jenkins sull’ultima versione di Ubuntu 22.04 con Apache2 come proxy inverso per la tua distribuzione.

Creazione della Prima Build di Jenkins

Dopo aver installato e configurato con successo Jenkins, ora creerai una nuova prima build di Jenkins dal dashboard di Jenkins.

Nel dashboard di Jenkins, clicca sul menu Nuovo Elemento per creare un nuovo progetto di build di Jenkins.

jenkins crea build

Inserisci il nome del progetto e seleziona il tipo di progetto, poi clicca su OK. In questa demo, il nome del progetto è “prima build” con il tipo di progetto “ Progetto Freestyle “.

crea build freestyle jenkins

Nella “ sezione generale “, inserisci la descrizione della tua build.

Ora passa alla scheda “ Build “ e scegli di costruire come “ Esegui shell “ e inserisci il seguente comando come comando di build.

echo "Questo è un test di build su jenkins"

Questo progetto mostrerà solo un messaggio “Questo è un test di build su jenkins” nell’output della build di Jenkins.

Ora clicca sul pulsante Salva.

configura build esegui shell

Ora nei dettagli del progetto “ prima build “, clicca sul menu “ Build Now “ per avviare e eseguire la build di Jenkins.

build progetto

Dopo che il processo è completato, puoi vedere la sezione della cronologia delle build nel menu in basso come nello screenshot seguente.

Clicca sul numero di build per ottenere i dettagli dell’operazione di build che è stata completata.

cronologia build jenkins

Ora clicca sul menu “ Console Output “ e otterrai l’output della tua prima build di Jenkins, che è il messaggio “ Questo è un test di build su jenkins “. E la build di Jenkins ha avuto successo.

output build jenkins

Conclusione

Congratulazioni! Hai ora installato con successo Jenkins sull’ultima versione del server Ubuntu 22.04 con Apache2 come proxy inverso con connessione sicura HTTPS abilitata. Inoltre, hai appreso le basi dell’inizializzazione e della configurazione di Jenkins, e hai anche creato il primo semplice progetto di build utilizzando Jenkins.