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

Jenkins è un server di automazione forkato dal progetto Hudson. Jenkins è un’applicazione basata su server che gira in un contenitore servlet Java, ha supporto per molti sistemi software SCM (Source Control Management) 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 è software libero.

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

Requisiti

Ubuntu Server 16.04 - 64bit
Privilegi di root

Passo 1 - Installare Java OpenJDK 7

Jenkins è basato su Java, quindi dobbiamo installare Java OpenJDK versione 7 sul server. In questo passo, installeremo Java 7 da un repository PPA che aggiungeremo prima.

Per impostazione predefinita, Ubuntu 16.04 viene fornito senza il pacchetto python-software-properties per gestire i repository PPA, quindi dobbiamo installare prima questo pacchetto. Installa python-software-properties con il comando apt.

apt-get install python-software-properties

Successivamente, aggiungi il repository PPA di Java al server.

add-apt-repository ppa:openjdk-r/ppa  
Premi semplicemente INVIO

Aggiorna il repository di Ubuntu e installa Java OpenJDK con il comando apt.

apt-get update  
apt-get install openjdk-7-jdk

Verifica l’installazione digitando il comando qui sotto:

java -version

e otterrai la versione di Java installata sul server.

Installa Java 7 openJDK su Ubuntu 16.04

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

Aggiorna il repository e installa Jenkins.

apt-get update  
apt-get install jenkins

Quando l’installazione è completata, avvia Jenkins con questo comando systemctl.

systemctl start jenkins

Verifica che Jenkins sia in esecuzione controllando la porta predefinita utilizzata da Jenkins (porta 8080). Lo controllerò con il comando netstat qui sotto:

netstat -plntu

Jenkins è installato e in esecuzione sulla porta 8080.

Jenkins è stato installato sulla porta 8080

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

In questo tutorial eseguiremo Jenkins dietro un server web Apache, configureremo Apache come reverse proxy per Jenkins. Prima installerò Apache e abiliterò alcuni moduli richiesti, e poi creerò il file del virtual host con il nome di dominio my.jenkins.id per Jenkins. Si prega di utilizzare il proprio nome di dominio qui e sostituirlo in tutti i file di configurazione ovunque appaia.

Installa il server web apache2 dal repository di Ubuntu.

apt-get install apache2

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 virtual host nella directory sites-available.

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

Incolla la configurazione del virtual host qui sotto.

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

Salva il file. Poi attiva il virtual host di Jenkins con il comando a2ensite.

a2ensite jenkins

Riavvia Apache e Jenkins.

systemctl restart apache2  
systemctl restart jenkins

Controlla che le porte 80 e 8000 siano in uso da Jenkins e Apache.

netstat -plntu

Controlla che Apache e Jenkins siano in esecuzione

Passo 4 - Configurare Jenkins

Jenkins è in esecuzione sul nome di dominio ‘my.jenkins.id’. Apri il tuo browser web e digita l’URL. Vedrai la schermata che ti chiede di inserire la password iniziale dell’amministratore. Una password è già stata generata da Jenkins, quindi dobbiamo solo mostrarla 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  
   
a1789d1561bf413c938122c599cf65c9

Incolla i risultati nella schermata e clicca su ‘Continua‘.

Installazione e configurazione di Jenkins

Ora dobbiamo installare alcuni plugin in Jenkins per avere una buona base per un uso successivo. Scegli ‘Installa plugin suggeriti‘, clicca su di esso.

Installa plugin jenkins

Installazione dei plugin di Jenkins in corso.

I plugin di Jenkins vengono installati

Dopo l’installazione del plugin, dobbiamo creare una nuova password per l’amministratore. Digita il tuo nome utente dell’amministratore, password, email ecc. e clicca su ‘Salva e termina‘.

Crea account amministratore Jenkins

Clicca su inizia e inizia a usare Jenkins. Sarai reindirizzato alla dashboard dell’amministratore di Jenkins.

Essere reindirizzati alla dashboard dell'amministratore

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

La dashboard dell'amministratore di Jenkins

Passo 5 - Sicurezza di Jenkins

Dalla dashboard dell’amministratore di Jenkins, dobbiamo configurare le impostazioni di sicurezza standard per Jenkins, clicca su ‘Gestisci Jenkins‘ e poi su ‘Configura Sicurezza Globale‘.

Impostazioni di Sicurezza Globale di Jenkins

Jenkins fornisce diversi metodi di autorizzazione nella sezione ‘Controllo Accessi‘. Seleziono ‘Sicurezza basata su matrice‘ per poter controllare tutti i privilegi degli utenti. Abilita l’utente amministratore nella casella ‘Utente/Gruppo‘ e clicca su aggiungi. Dai all’amministratore tutti i privilegi selezionando tutte le opzioni, e dai all’anonimo solo permessi di lettura. Ora clicca su ‘Salva‘.

Configura i permessi di Jenkins

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

Passo 6 - Testare un semplice lavoro di automazione

In questa sezione, voglio solo testare un semplice lavoro per il server Jenkins. Creerò un semplice lavoro per testare Jenkins e scoprire il carico del server con il comando top.

Dalla dashboard dell’amministratore di Jenkins, clicca su ‘Crea Nuovo Lavoro‘.

Crea un nuovo lavoro in Jenkins

Inserisci il nome del lavoro, userò ‘Controllo Sistema’ qui, seleziona ‘Progetto Freestyle‘ e clicca su ‘OK‘.

Configura un nuovo lavoro Jenkins

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

Digita il comando qui sotto nella casella.

top -b -n 1 | head -n 5

Clicca su ‘Salva‘.

Avvia un lavoro Jenkins

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

Dopo che il lavoro è stato eseguito, vedrai la ‘Cronologia delle Build‘, clicca sul primo lavoro per vedere i risultati.

Ecco i risultati del lavoro eseguito da Jenkins.

Esegui e costruisci un lavoro Jenkins

L’installazione di Jenkins con il server web Apache su Ubuntu 16.04 è stata completata con successo.