Melakukan integrasi dengan Jenkins

Halaman ini akan memandu Anda mengonfigurasi Jenkins untuk menyimpan paket Maven yang di-build di repositori Artifact Registry.

Sebelum memulai

Jika repositori target tidak ada, buat repositori baru.

Mengonfigurasi akses ke repositori Anda

1. Buat akun layanan khusus untuk digunakan Jenkins dengan Artifact Registry.

   Jalankan perintah berikut untuk membuat akun layanan bernama jenkins-sa:

   gcloud iam service-accounts create jenkins-sa
   

   Tindakan ini akan membuat akun layanan bernama [e-mail], dengan PROJECT adalah project ID Anda.

2. Pada project yang berisi repositori, berikan peran Artifact Registry Writer ke akun layanan Jenkins yang Anda buat. Anda dapat memberikan peran untuk semua repositori dalam project atau memberikan peran untuk repositori tertentu yang perlu diakses akun layanan.

   Untuk mengetahui detail tentang izin dan memberikan akses berdasarkan peran, lihat Mengonfigurasi kontrol akses.

Menyiapkan cluster GKE

Saat menyiapkan cluster atau kumpulan node Google Kubernetes Engine baru, gunakan akun layanan yang Anda buat untuk digunakan oleh Jenkins.

Konsol

Untuk membuat cluster menggunakan Google Cloud Console, lakukan langkah-langkah berikut:

1. Buka menu Artifact Registry di Google Cloud Console.

   Buka menu Artifact Registry

2. Klik Buat kluster.

3. Mengonfigurasikan cluster sesuai keinginan. Jangan klik Create terlebih dahulu.

4. Klik Opsi lainnya pada kumpulan node default.

5. Di bagian Keamanan, pilih akun layanan Jenkins yang Anda buat.

   Catatan: Jika Anda ingin menggunakan akun layanan Compute Engine default, pilih Set access for setiap API di bagian Cakupan akses. Di menu drop-down Read Write Cloud Platform, pilih Enabled.

6. Klik Save untuk keluar dari overlay.

7. Klik Create.

gcloud

Gunakan salah satu perintah berikut untuk membuat cluster dengan akun layanan Jenkins. Dalam perintah tersebut, PROJECT adalah project ID Anda.

Untuk membuat cluster dengan akun layanan, jalankan perintah.

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

Untuk membuat node pooldi cluster yang ada:

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

Lihat dokumentasi gcloud container cluster create untuk mengetahui detail tentang perintah tersebut.

Catatan: Jika Anda ingin menggunakan akun layanan Compute Engine default, hapus opsi --service-account dan tambahkan --scopes cloud-platform untuk menerapkan cakupan akses Cloud Platform.

Menyiapkan Jenkins di GKE

1. Ikuti tutorial untuk menyiapkan Jenkins di GKE. Gunakan cluster yang Anda buat di bagian sebelumnya.

2. Di Jenkins, update plugin GKE ke versi terbaru. Klik Manage Jenkins > Manage Plugins > Updates.

Menyiapkan project Maven

1. Lakukan fork contoh project Maven di repositori GitHub dokumentasi Jenkins.

2. Clone repositori forked.

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

3. Menyiapkan pipeline baru di antarmuka Jenkins.

   1. Klik New Item.
   2. Pilih Pipeline.
   3. Tetapkan nama untuk pipeline, lalu klik OK.

4. Pada tab General, konfigurasikan opsi berikut di bagian Pipeline:

   • Pilih Pipeline skrip dari SCM.
   • Dalam menu drop-down SCM, pilih Git, lalu tentukan URL dan kredensial untuk terhubung ke repositori GitHub Anda.

   

5. Klik Simpan.

Mengonfigurasi koneksi ke repositori

Mengonfigurasi Jenkins dengan repositori dan kredensial untuk terhubung ke repositori.

1. Tambahkan repositori Anda ke Maven pom.xml. Gunakan perintah berikut untuk mencetak cuplikan yang akan ditambahkan.

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

   Dari mana

   • PROJECT adalah project ID. Jika flag ini dihilangkan, project saat ini atau default akan digunakan.
   • REPOSITORY adalah ID repositori. Jika Anda mengonfigurasi repositori Artifact Registry default, repositori tersebut akan digunakan saat tanda ini dihilangkan dari perintah.
   • LOCATION adalah lokasi regional atau multi-regional untuk repositori.

2. Membuat file YAML sebagai template pod untuk agen 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. Ubah 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"
                    }
               }
           }
       }
   }
   

Memulai build

1. Terapkan perubahan yang Anda buat ke project GitHub.

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

2. Di antarmuka Jenkins, mulai build baru untuk aplikasi dalam contoh project Maven Anda.

Setelah build berhasil diselesaikan, artefak akan ditambahkan ke repositori paket Java Artifact Registry yang Anda buat.

Jalankan perintah berikut untuk mencantumkan paket dalam repositori:

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

Outputnya terlihat mirip dengan contoh berikut:

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