Come installare il server di automazione Jenkins con Apache su Ubuntu 18.04

Jenkins è un server di automazione forkato dal progetto Hudson. Jenkins è un’applicazione basata su server che gira in un contenitore servlet Java, supporta molti sistemi di gestione del codice sorgente (SCM) tra cui Git, SVN e Mercurial. Jenkins fornisce centinaia di plugin per automatizzare il tuo progetto. Jenkins è stato creato da Kohsuke Kawaguchi, rilasciato per la prima volta nel 2011 sotto la licenza MIT ed è un software gratuito.

In questo tutorial, ti mostrerò come installare l’ultima versione stabile di Jenkins su Ubuntu Server 18.04 LTS (Bionic Beaver). Eseguiremo Jenkins sul nostro nome di dominio e installeremo e configureremo Jenkins per funzionare sotto il server web Apache come reverse proxy.

Requisiti

• Ubuntu 18.04
• Privilegi di root

Cosa faremo?

1. Installare Java
2. Installare Jenkins
3. Installare e configurare Apache2 come reverse proxy per Jenkins
4. Configurare il firewall UFW
5. Configurare Jenkins
6. Sicurezza di Jenkins
7. Test

Passo 1 - Installare Java

Jenkins è un’applicazione basata su Java, quindi dobbiamo installare Java OpenJDK sul server. In questo passo, installeremo Java 8 da un repository PPA che aggiungeremo per primo.

Installa i pacchetti software-properties-common, quindi aggiungi il repository PPA di Java OpenJDK.

sudo apt install software-properties-common apt-transport-https -y  
sudo add-apt-repository ppa:openjdk-r/ppa -y

Ora installa Java 8 utilizzando il comando apt.

sudo apt install openjdk-8-jdk -y

Quando l’installazione è completata, controlla la versione di Java installata sul sistema.

java -version

E otterrai che Java OpenJDK 1.8 è ora installato sul sistema Ubuntu 18.04.

Nota:

• Se hai più versioni di Java sul tuo sistema, cambia la versione predefinita di Java utilizzando il comando qui sotto.

sudo update-alternatives --config java

Passo 2 - Installare Jenkins

Jenkins fornisce un repository Ubuntu per i pacchetti di installazione e installeremo Jenkins da questo repository.

Aggiungi la chiave e il repository di Jenkins al sistema con il comando qui sotto.

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

Ora aggiorna il repository e installa Jenkins.

sudo apt update  
sudo apt install jenkins -y

Quando l’installazione è completata, avvia il servizio Jenkins e aggiungilo all’avvio.

systemctl start jenkins  
systemctl enable jenkins

Jenkins è ora attivo e funzionante sul server Ubuntu 18.04, in esecuzione sulla porta predefinita ‘8080’. Controllalo utilizzando netstat come qui sotto.

netstat -plntu

E otterrai il risultato come qui sotto.

Passo 3 - Installare e configurare Apache2 come reverse proxy per Jenkins

In questo tutorial eseguiremo Jenkins dietro un server web Apache, configureremo Apache come reverse proxy per Jenkins.

Per prima cosa installeremo Apache e abiliteremo alcuni moduli richiesti, quindi creeremo il file di host virtuale con il nome di dominio jenkins.hakase-labs.io per Jenkins. Si prega di utilizzare il proprio nome di dominio qui e sostituirlo in tutti i file di configurazione dove appare.

Installa il server web apache2 dal repository di Ubuntu.

sudo apt install apache2 -y

Quando l’installazione è completata, abilita i moduli proxy e proxy_http in modo da poter configurare Apache come server frontend/reverse proxy per Jenkins.

a2enmod proxy  
a2enmod proxy_http

Successivamente, crea un nuovo file di host virtuale per Jenkins nella directory sites-available.

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

Incolla la configurazione dell’host virtuale qui sotto.

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

Salva ed esci, quindi attiva l’host virtuale di Jenkins con il comando a2ensite.

a2ensite jenkins

Riavvia i servizi Apache e Jenkins.

systemctl restart apache2  
systemctl restart jenkins

L’installazione e la configurazione di apache2 come reverse proxy per Jenkins sono state completate.

Passo 4 - Configurare il firewall UFW

Prima di abilitare il firewall UFW sul server Ubuntu, dobbiamo aggiungere le porte dei servizi di base come SSH, HTTP e HTTPS.

Aggiungi i servizi SSH, HTTP e HTTPS al firewall ufw.

ufw allow ssh  
ufw allow http  
ufw allow https

Ora avvia e abilita il firewall ufw.

ufw enable

digita ‘y’ e premi Invio.

Il firewall UFW è ora abilitato e la porta HTTP è stata aggiunta.

Passo 5 - Configurare Jenkins

Jenkins è in esecuzione sul nome di dominio ‘ http://jenkins.hakase-labs.io ‘. Apri il tuo browser web e digita l’URL.

Otterrai la schermata che richiede di inserire la password iniziale dell’amministratore. Una password è già stata generata da Jenkins, quindi dobbiamo solo mostrare e copiare i risultati nella casella della password.

Mostra la password iniziale dell’amministratore di Jenkins con il comando cat.

cat /var/lib/jenkins/secrets/initialAdminPassword

Incolla i risultati nella schermata e fai clic su ‘Continua’.

Ora dovremmo installare alcuni plugin in Jenkins per avere una buona base per un uso successivo. Scegli ‘Installa plugin suggeriti’, fai clic su di esso.

Installazione dei plugin di Jenkins in corso.

Dopo che l’installazione dei plugin è completata, dobbiamo creare una nuova password per l’amministratore. Digita il tuo nome utente, password, email ecc. e fai clic su ‘Salva e continua’.

Per la configurazione dell’istanza, digita il nome di dominio di Jenkins ‘http://jenkins.hakase-labs.io’ e fai clic sul pulsante ‘Salva e termina’.

Ora fai clic sul pulsante ‘Inizia a usare Jenkins’.

E verrai reindirizzato alla dashboard di amministrazione di Jenkins.

L’installazione e la configurazione di Jenkins sono state completate con successo.

Passo 6 - Sicurezza di Jenkins

Dalla dashboard di amministrazione di Jenkins, dobbiamo configurare le impostazioni di sicurezza standard per Jenkins, fai clic su ‘Gestisci Jenkins’ e poi su ‘Configura Sicurezza Globale’.

Jenkins fornisce diversi metodi di autorizzazione nella sezione ‘Controllo Accessi’. Useremo la ‘Sicurezza basata su matrice’, in modo da poter controllare tutti i privilegi degli utenti.

Aggiungi l’utente ‘hakase’ nella casella ‘Utente/Gruppo’ e fai clic su aggiungi.

Dai all’utente ‘hakase’ tutti i privilegi selezionando tutte le opzioni e fai clic sul pulsante ‘Salva’.

Verrai reindirizzato alla dashboard e, se c’è l’opzione di accesso, digita semplicemente il tuo utente amministratore e la password.

Passo 7 - Test

In questa sezione, vogliamo creare un semplice lavoro per il server Jenkins. Creeremo un semplice lavoro per testare Jenkins e per scoprire il carico del server con il comando top.

Dalla dashboard di amministrazione di Jenkins, fai clic su ‘Crea Nuovo Lavoro’.

Digita il nome del lavoro. Useremo ‘Controllo Sistema’ qui, seleziona ‘Progetto Freestyle’ e fai clic su ‘OK’.

Vai alla scheda ‘Build’. Nella ‘Aggiungi passaggio di build’, seleziona l’opzione ‘Esegui shell’.

Digita il comando qui sotto nella casella.

top -b -n 1 | head -n 5

Fai clic su ‘Salva’.

Ora sei sulla pagina del lavoro del lavoro ‘Progetto controllo sistema’. Fai clic su ‘Esegui ora’ per eseguire il lavoro ‘controllo sistema’.

Dopo che il lavoro è stato eseguito, vedrai la ‘Cronologia delle costruzioni’, fai clic sul primo lavoro per vedere i risultati.

Ecco i risultati del lavoro eseguito da Jenkins.

L’installazione e la configurazione dello strumento di automazione Jenkins con Apache2 come reverse proxy su Ubuntu 18.04 sono state completate con successo.

Riferimenti

• https://wiki.jenkins.io/
• https://wiki.jenkins.io/Standard+Security+Setup
• https://jenkins-le-guide-complet.github.io/