Integrazione con Jenkins

Questa pagina ti guida nella configurazione di Jenkins per archiviare i pacchetti Maven creati in un repository Artifact Registry.

Prima di iniziare

Se il repository di destinazione non esiste, creane uno nuovo.

Configurare l'accesso al repository

1. Crea un account di servizio dedicato per Jenkins da utilizzare con Artifact Registry.

   Esegui il seguente comando per creare un account di servizio denominato jenkins-sa:

   gcloud iam service-accounts create jenkins-sa
   

   Viene creato un account di servizio denominato [e-mail], dove PROJECT è l'ID progetto.

2. Nel progetto che contiene il repository, concedi il ruolo Writer di Artifact Registry al account di servizio Jenkins che hai creato. Puoi concedere il ruolo per tutti i repository del progetto o per i repository specifici a cui il account di servizio deve accedere.

   Per informazioni dettagliate sulle autorizzazioni e sulla concessione dell'accesso per ruolo, consulta Configurare il controllo dell'accesso.

Configurare un cluster GKE

Quando configuri un nuovo cluster Google Kubernetes Engine o un nuovo pool di nodi, utilizza il account di servizio che hai creato per Jenkins.

Console

Per creare un cluster utilizzando la Google Cloud console, segui questi passaggi:

1. Visita il menu GKE nella Google Cloud console.

   Visita il menu GKE

2. Fai clic su Crea cluster.

3. Configura il cluster come preferisci. Non fare ancora clic su Crea.

4. Fai clic su Altre opzioni nel pool di nodi predefinito.

5. Nella sezione Sicurezza, seleziona il service account Jenkins che hai creato.

   Nota: se vuoi utilizzare il account di servizio Compute Engine predefinito invece, seleziona Imposta l'accesso per ogni API nella sezione Ambiti di accesso. Nell'elenco a discesa Lettura/scrittura di Google Cloud, seleziona Attivato.

6. Fai clic su Salva per uscire dalla sovrapposizione.

7. Fai clic su Crea.

gcloud

Utilizza uno dei seguenti comandi per creare il cluster con il account di servizio Jenkins. Nei comandi, PROJECT è l'ID progetto.

Per creare un cluster con il account di servizio, esegui il comando.

gcloud container clusters create example-cluster --service-account=[e-mail]

Per creare un pool di nodi in un cluster esistente:

gcloud container node-pools create example-pool --service-account=[e-mail]

Per informazioni dettagliate sul comando, consulta la documentazione di gcloud container clusters create.

Nota: se vuoi utilizzare il account di servizio Compute Engine predefinito invece, ometti l'opzione --service-account e aggiungi --scopes cloud-platform per applicare l'ambito di accesso a piattaforma Cloud Cloud.

Configurare Jenkins su GKE

1. Segui il tutorial per configurare Jenkins su GKE. Utilizza il cluster che hai creato nella sezione precedente.

2. In Jenkins, aggiorna il plug-in GKE all'ultima versione. Fai clic su Gestisci Jenkins > Gestisci plug-in > Aggiornamenti.

Configurare un progetto Maven

1. Crea un fork del progetto Maven di esempio nel repository GitHub della documentazione di Jenkins.

2. Clona il repository di cui hai creato un fork.

   git clone [e-mail]:USER_NAME/simple-java-maven-app.git
   

3. Configura una nuova pipeline nell'interfaccia di Jenkins.

   1. Fai clic su Nuovo elemento.
   2. Seleziona Pipeline.
   3. Imposta un nome per la pipeline e fai clic su OK.

4. Nella scheda Generale, configura le seguenti opzioni nella sezione Pipeline:

   • Seleziona Script della pipeline da SCM.
   • Nell'elenco a discesa SCM, seleziona Git e poi specifica l'URL e le credenziali per connetterti al repository GitHub.

   

5. Fai clic su Salva.

Configurare la connessione al repository

Configura Jenkins con il repository e le credenziali per connetterti al repository.

1. Aggiungi il repository a pom.xml di Maven. Utilizza il seguente comando per stampare uno snippet da aggiungere.

   gcloud artifacts print-settings mvn [--project=PROJECT] \
   [--repository=REPOSITORY] [--location=LOCATION]
   

   Dove

   • PROJECT è l'ID progetto. Se questo flag viene omesso, viene utilizzato il progetto corrente o predefinito.
   • REPOSITORY è l'ID del repository. Se hai configurato un repository Artifact Registry predefinito, questo viene utilizzato quando questo flag viene omesso dal comando.
   • LOCATION è la località regionale o multiregionale location del repository.

2. Crea un file YAML come modello di pod per gli agent Jenkins.

   mkdir jenkins
   cat > jenkins/maven-pod.yaml << EOF
   apiVersion: v1
   kind: Pod
   spec:
     containers:
     - name: maven
       image: maven:3.3.9-jdk-8-alpine
       command: ['cat']
       tty: true
   EOF
   

3. Modifica il file Jenkinsfile.

   pipeline {
       agent none
       stages {
           stage('Deploy') {
               steps {
                    agent {
                        kubernetes {
                            label 'mavenpod'
                            yamlFile 'jenkins/maven-pod.yaml'
                          }
                      }
                      container('maven') {
                      sh "mvn -B clean deploy"
                    }
               }
           }
       }
   }
   

Avviare una build

1. Esegui il push delle modifiche apportate al progetto GitHub.

   git add . && git commit -m "Configure my Jenkins pipeline" && git push
   

2. Nell'interfaccia di Jenkins, avvia una nuova build per l'applicazione nel progetto Maven di esempio.

Al termine della build, gli artefatti vengono aggiunti al repository di pacchetti Java di Artifact Registry che hai creato.

Esegui il seguente comando per elencare i pacchetti nel repository:

gcloud artifacts packages list --repository=mvn-jenkins --location=LOCATION

L'output è simile al seguente esempio:

Listing items under project {YOUR_PROJECT}, repository mvn-jenkins.

PACKAGE                   CREATE_TIME          UPDATE_TIME
com.mycompany.app:my-app  2019-06-25T17:09:44  2019-06-25T17:09:44