Memulai: Instal Jenkins di Azure Linux VM

Artikel ini menunjukkan cara menginstal Jenkins pada Ubuntu Linux VM dengan alat dan plug-in yang dikonfigurasi untuk bekerja dengan Azure.

Dalam artikel ini, Anda akan mempelajari cara:

  • Buat file penyiapan yang mengunduh dan menginstal Jenkins
  • Buat grup sumber daya
  • Buat mesin virtual dengan file penyiapan
  • Buka port 8080 untuk mengakses Jenkins di mesin virtual
  • Sambungkan ke mesin virtual melalui SSH
  • Konfigurasi contoh pekerjaan Jenkins berdasarkan contoh aplikasi Java di GitHub
  • Buat sampel pekerjaan Jenkins

1. Mengonfigurasi lingkungan Anda

  • Langganan Azure: Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum memulai.

2. Membuka Cloud Shell

  1. Jika sudah membuka sesi Cloud Shell, Anda dapat melompat ke bagian berikutnya.

  2. Telusuri ke portal Azure

  3. Jika diperlukan, masuk ke langganan Azure Anda dan ubah direktori Azure.

  4. Buka Cloud Shell.

    Open Cloud Shell from the top menu in the Azure portal.

  5. Jika Anda belum pernah menggunakan Cloud Shell, konfigurasikan lingkungan dan pengaturan penyimpanan.

  6. Pilih lingkungan baris perintah.

    Select the CLI you want to use in Cloud Shell.

3. Buat mesin virtual

  1. Buat direktori dengan nama jenkins-get-started.

  2. Alihkan ke direktori pengujian.

  3. Buat file bernama cloud-init-jenkins.txt.

  4. Tempelkan kode berikut ke file yang baru:

    #cloud-config
    package_upgrade: true
    runcmd:
      - sudo apt install openjdk-11-jre -y
      - curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
      -  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
      - sudo apt-get update && sudo apt-get install jenkins -y
      - sudo service jenkins restart
    
    
    
  5. Jalankan az group create untuk membuat grup sumber daya.

    az group create --name jenkins-get-started-rg --location eastus
    
  6. Jalankan az vm create untuk membuat mesin virtual.

    az vm create \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm \
    --image UbuntuLTS \
    --admin-username "azureuser" \
    --generate-ssh-keys \
    --public-ip-sku Standard \
    --custom-data cloud-init-jenkins.txt
    
  7. Jalankan az vm list untuk memverifikasi pembuatan (dan status) mesin virtual baru.

    az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"
    
  8. Saat Jenkins berjalan di port 8080, jalankan az vm open untuk membuka port 8080 di mesin virtual baru.

    az vm open-port \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm  \
    --port 8080 --priority 1010
    

4. Mengonfigurasi Jenkins

  1. Jalankan az vm show untuk mendapatkan alamat IP publik untuk mesin virtual contoh.

    az vm show \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm -d \
    --query [publicIps] \
    --output tsv
    

    Poin utama:

    • Parameter --query membatasi output ke alamat IP publik untuk mesin virtual.
  2. Menggunakan alamat IP yang diambil pada langkah sebelumnya, SSH ke dalam mesin virtual. Anda akan perlu mengonfirmasi permintaan koneksi.

    ssh azureuser@<ip_address>
    

    Poin utama:

    • Setelah koneksi berhasil, permintaan Cloud Shell menyertakan nama pengguna dan nama mesin virtual: azureuser@jenkins-get-started-vm.
  3. Verifikasi bahwa Jenkins berjalan, dengan mengambil status layanan Jenkins.

    service jenkins status
    

    Poin utama:

    • Jika Anda menerima pesan kesalahan mengenai layanan yang tidak ada, Anda mungkin harus menunggu beberapa menit sebelum semua terinstal dan dimulai.
  4. Dapatkan kata sandi Jenkins yang dihasilkan secara otomatis.

    sudo cat /var/lib/jenkins/secrets/initialAdminPassword
    
  5. Menggunakan alamat IP, buka URL berikut di browser: http://<ip_address>:8080

  6. Masukkan kata sandi yang telah Anda ambil sebelumnya dan pilih Lanjutkan.

    Initial page to unlock Jenkins

  7. Pilih Pilih plug-in untuk diinstal.

    Select the option to install selected plug-ins

  8. Di kotak filter pada bagian atas halaman, masukkan github. Pilih plug-in GitHub dan pilih Instal.

    Install the GitHub plug-ins

  9. Masukkan informasi untuk pengguna admin pertama dan pilih Simpan dan Lanjutkan.

    Enter information for first admin user

  10. Pada halaman Konfigurasi Instans, pilih Simpan dan Selesaikan.

    Confirmation page for instance configuration

  11. Pilih Mulai menggunakan Jenkins.

    Jenkins is ready!

5. Membuat pekerjaan pertama Anda

  1. Pada halaman beranda Jenkins, pilih Buat pekerjaan.

    Jenkins console home page

  2. Masukkan nama pekerjaan mySampleApp, pilih proyek Freestyle, dan pilih OK.

    New job creation

  3. Pilih tab Manajemen Kode Sumber. Aktifkan Git dan masukkan URL berikut untuk nilai URL Repositori: https://github.com/spring-guides/gs-spring-boot.git. Kemudian ubah Branch Specifier menjadi */main.

    Define the Git repo

  4. Pilih tab Build, kemudian pilih Tambahkan langkah build

    Add a new build step

  5. Dari menu tarik-turun, pilih Panggil skrip Gradle.

    Select the Gradle script option

  6. Pilih Gunakan Gradle Wrapper, lalu masukkan complete di lokasi Wrapper dan build untuk Tugas.

    Gradle script options

  7. Pilih Tingkat Lanjut dan masukkan complete di bidang skrip Build Root.

    Advanced Gradle script options

  8. Gulir ke bagian bawah halaman, dan pilih Simpan.

6. Bangun sampel aplikasi Java

  1. Saat halaman beranda untuk proyek Anda ditampilkan, pilih Build Now untuk mengompilasi kode dan mengemas aplikasi sampel.

    Project home page

  2. Grafik di bawah judul Build History mengindikasikan bahwa pekerjaan sedang dibangun.

    Job-build in progress

  3. Setelah build selesai, pilih tautan Workspace.

    Select the workspace link.

  4. Arahkan ke complete/build/libs untuk melihat file .jar berhasil dibangun.

    The target library verifies the build succeeded.

  5. Server Jenkins Anda sudah siap untuk membangun proyek Anda sendiri di Azure!

Pemecahan Masalah

Jika Anda mengalami masalah saat mengonfigurasi Jenkins, lihat halaman penginstalan Jenkins untuk petunjuk dan masalah yang diketahui yang terbaru.

Langkah berikutnya