Cara Mengunduh & Menginstal Jenkins on Windows

⚡ Ringkasan Cerdas

Download dan menginstal Jenkins on Windows Gunakan penginstal MSI resmi, lalu buka kunci pengontrol, terapkan plugin, dan buat akun administrator pertama. Semua prasyarat, pengaturan port, dan izin layanan yang diperlukan untuk server otomatisasi yang stabil tercantum di bawah ini.

  • ⚙️ Spesifikasi Perangkat Keras: Jenkins Perangkat ini berjalan dengan RAM 256 MB dan ruang penyimpanan 1 GB, meskipun RAM 4 GB dan penyimpanan 50 GB lebih cocok untuk tim kecil.
  • Java Persyaratan: terbaru Jenkins rilis memerlukan Java Gunakan versi 21 atau lebih baru pada pengontrol, jadi verifikasi runtime yang terpasang sebelum menjalankan penginstal MSI.
  • 📦 Pilihan Rilis: Dukungan Jangka Panjang (Long-Term Support) dirilis setiap 12 minggu untuk tim produksi, sementara rilis mingguan ditujukan untuk pengembang plugin yang membutuhkan perubahan inti terbaru.
  • 🔐 Akun Layanan: Running Jenkins Menggunakan akun lokal atau domain khusus dengan hak akses LogonAsService lebih aman daripada akun LocalSystem dengan hak akses tinggi.
  • 🔑 Langkah Pembukaan Kunci: File initialAdminPassword di dalam folder secrets pada direktori instalasi membuka kunci controller di http://localhost:8080.
  • 🧩 Pengaturan Plugin: Memilih Instal plugin yang disarankan akan menyediakan kumpulan plugin umum, dan plugin tambahan tetap tersedia nanti melalui Kelola. Jenkins.
  • Pemulihan Kegagalan: Kesalahan login tidak valid, port terpakai, dan hilang Java Waktu eksekusi menyebabkan sebagian besar kegagalan. Windows instalasi.

Cara Mengunduh dan Menginstal Jenkins on Windows

Jenkins dapat dipasang pada salah satu Windows atau platform Unix, tetapi panduan ini berfokus pada Windows Hanya instalasi. Yang Windows Penginstal MSI mendaftar Jenkins sebagai Windows layanan dan memilih 64-bit Java runtime untuk Anda, yang menjadikannya rute tercepat menuju server otomatisasi yang berfungsi. Sebelum membuka penginstal, pastikan mesin Anda memenuhi persyaratan yang tercantum di bagian selanjutnya.

Jenkins Prasyarat dan Persyaratan Sistem

Jenkins Meskipun ringan saat tidak digunakan, kapasitasnya meningkat dengan cepat setelah riwayat pembangunan, ruang kerja, dan plugin terakumulasi. Menentukan ukuran mesin yang tepat sejak awal akan menghindari migrasi yang merepotkan di kemudian hari.

Persyaratan perangkat keras:

Sumber Minimum absolut Direkomendasikan untuk tim kecil
RAM 256 MB 4 GB atau lebih
Ruang berkendara 1 GB 50 GB atau lebih
Java runtime Java 21 Java 21 atau Java 25 (64-bit)

persyaratan perangkat lunak:

  • Jenkins berjalan Java, jadi didukung Java Kit Pengembangan (JDK) atau Java Runtime Environment (JRE) harus tersedia. Saat ini Jenkins rilis memerlukan Java 21 atau lebih baru; Java Nomor 8, 11, dan 17 tidak lagi didukung oleh lini Dukungan Jangka Panjang terbaru.
  • Diperlukan peramban web modern untuk mengaksesnya. Jenkins dasbor.
  • Akun dengan hak administratif pada Windows Mesin diperlukan untuk mendaftarkan Jenkins layanan.

Konfirmasikan instalasinya Java Periksa versi JDK dari Command Prompt sebelum melanjutkan. Jika perintah gagal atau melaporkan versi di bawah 21, instal JDK yang didukung terlebih dahulu.

:: Check the Java version available on the machine
java -version

:: Expected output resembles the following
openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)

Jenis rilis

Jenkins menerbitkan dua lini rilis, dan pilihan tersebut memengaruhi seberapa sering Anda melakukan peningkatan.

Garis rilis Irama Stabilitas Audiens yang dituju
Dukungan Jangka Panjang (LTS) Setiap 12 minggu Hanya perbaikan yang telah diuji secara luas dan diimplementasikan kembali. Pengguna akhir dan tim produksi
Mingguan Setiap minggu Fitur terbaru dan perbaikan bug, pengujian lapangan yang lebih sedikit. Pengembang plugin dan pengguna awal

Panduan ini menggunakan rilis LTS, meskipun proses instalasinya identik untuk rilis mingguan. Dengan prasyarat yang sudah terpenuhi, pengunduhan dapat dimulai.

Bagaimana cara mengunduh Jenkins?

Ikuti langkah-langkah di bawah ini untuk memperolehnya Windows instalator dan selesaikan instalasi dengan sukses:

Langkah 1) Pergi ke https://www.jenkins.io/download/ dan pilih platformnya. Dalam kasus kami, Windows.

Unduh Jenkins

Langkah 2) Buka lokasi unduhan di komputer lokal Anda dan ekstrak paket yang telah diunduh. Double-klik file yang sudah diekstrak jenkins.msi file. Jenkins juga dapat dijalankan dari file WAR (Web application ARchive), tetapi cara tersebut tidak disarankan pada Windows karena hal ini melewati proses pendaftaran layanan yang ditangani oleh penginstal.

Unduh Jenkins

Catatan: Windows SmartScreen mungkin melaporkan bahwa mereka mencegah aplikasi yang tidak dikenal untuk dijalankan. Pilih Info lebih lanjut, kemudian Tetaplah berlari, untuk melanjutkan dengan yang telah ditandatangani Jenkins pemasang.

Langkah 3) Dalam majalah Jenkins Layar pengaturan, klik Selanjutnya.

Unduh Jenkins

Langkah 4) Pilih lokasi di mana Jenkins Instance tersebut harus diinstal. Lokasi default pada installer 64-bit saat ini adalah C: \ Program Files \JenkinsPerhatikan jalur ini, karena kata sandi administrator awal tersimpan di dalamnya. Klik Selanjutnya.

Unduh Jenkins

Langkah 5) Program instalasi kemudian meminta kredensial masuk layanan dan nomor port. Berikan akun lokal atau domain khusus dan klik Kredensial Ujilalu atur port dan klik Pelabuhan Uji. Pelabuhan 8080 adalah pengaturan default. Sedang berjalan Jenkins Menggunakan akun layanan bernama lebih aman daripada opsi LocalSystem, yang memberikan Jenkins akses penuh ke mesin tersebut.

Unduh Jenkins

Langkah 6) Konfirmasikan Java Direktori beranda yang dideteksi oleh penginstal, tinjau opsi pengaturan khusus, dan klik Install tombol. Setelah instalasi selesai, klik Finish.

Unduh Jenkins

Langkah 7) Selama proses instalasi, panel informasi mungkin muncul untuk memberi tahu Anda bahwa restart diperlukan setelah instalasi selesai. Klik OK tombol saat panel informasi muncul.

Unduh Jenkins

File-file tersebut kini tersimpan di disk dan layanan telah terdaftar. Tahap selanjutnya membuka kunci antarmuka web.

Cara Membuka Blokir Jenkins?

Setelah menyelesaikan Jenkins Pada fase instalasi, pengontrol terkunci hingga Anda memasukkan kata sandi yang dihasilkan secara otomatis. Langkah-langkah di bawah ini menjelaskan cara membuka kunci pengontrol. Jenkins Aplikasi:

Langkah 1) Setelah proses instalasi selesai, sebuah tab browser akan terbuka dan meminta kata sandi administrator awal. Untuk mengaksesnya, Jenkins, buka jalur berikut di peramban web Anda.
http://localhost:8080

Jika alamat di atas dapat diakses, berarti instalasi berhasil dan layanan sedang berjalan.

membuka blokir Jenkins

Langkah 2) Kata sandi administrator awal disimpan di bawah Jenkins jalur instalasi yang Anda tetapkan pada Langkah 4 instalasi. Untuk lokasi default C: \ Program Files \Jenkins, sebuah file bernama Kata Sandi Admin awal ditemukan di bawah C: \ Program Files \JenkinsrahasiaJika jalur kustom dipilih, periksa lokasi tersebut sebagai gantinya. Nilai yang sama juga ditulis ke jenkins.err.log file di Jenkins direktori rumah.

membuka blokir Jenkins

Langkah 3) Buka file yang disorot dan salin isi file tersebut. Kata Sandi Admin awal file.

membuka blokir Jenkins

Langkah 4) Tempelkan kata sandi ke dalam Kata sandi administrator bidang pada Buka Kunci Jenkins buka halaman di browser Anda dan klik Continue .

membuka blokir Jenkins

Setelah kontroler tidak terkunci, wizard pengaturan beralih ke plugin dan akun pengguna pertama.

Menyesuaikan Jenkins

Anda juga dapat menyesuaikan Jenkins lingkungan menggunakan langkah-langkah yang diberikan di bawah ini:

Langkah 1) klik Instal plugin yang disarankan tombol sehingga Jenkins Mengambil dan menginstal plugin-plugin penting.

Menyesuaikan Jenkins

Jenkins Mulai mengunduh dan menginstal semua plugin yang dibutuhkan untuk membuat yang baru. Jenkins pekerjaan.

Menyesuaikan Jenkins

Catatan: Anda dapat memilih opsi tersebut. Pilih plugin yang akan diinstal dan pilih hanya plugin yang Anda inginkan. Plugin dapat ditambahkan atau dihapus nanti dari Mengelola Jenkins > PluginJadi, pilihan ini tidak bersifat permanen.

Menyesuaikan Jenkins

Langkah 2) Setelah semua plugin yang disarankan terpasang, maka Buat Pengguna Admin Pertama Panel akan muncul. Isi semua kolom dengan detail akun yang diinginkan dan klik. Simpan dan Selesai .

Menyesuaikan Jenkins

Langkah 3) Jenkins akhirnya meminta URL di mana instance akan diakses. Biarkan nilai default untuk menghindari kebingungan di kemudian hari. Jika aplikasi lain sudah menggunakan port 8080, berikan port yang berbeda di sini, lalu klik Simpan dan Lanjutkan .

Menyesuaikan Jenkins

Selamat! Sebuah pencapaian baru Jenkins Server sudah terpasang. Klik Mulai menggunakan Jenkins .

Menyesuaikan Jenkins

The Jenkins Instans sudah aktif dan berjalan, siap untuk pekerjaan pertama Anda. Singkat Jenkins tutorial untuk pemula menjelaskan cara menciptakan pekerjaan tersebut.

Menyesuaikan Jenkins

Bagaimana cara memverifikasinya? Jenkins Instalasi dan Pengelolaan Layanan

Dasbor yang hanya dimuat sekali bukanlah bukti instalasi yang sehat. Karena penginstal MSI mendaftarkan Jenkins sebagai Windows Untuk layanan ini, layanan tersebut harus tetap berfungsi setelah sistem di-restart dan dapat dimulai ulang dengan bersih sesuai permintaan. Lakukan pemeriksaan di bawah ini segera setelah wizard pengaturan ditutup.

  1. Konfirmasikan apakah layanan tersebut ada. Media Win + R, Jenis services.msc, lalu tekan Enter. Temukan entri yang bernama Jenkins dan konfirmasikan bahwa statusnya berbunyi Running dan tipe startupnya berbunyi secara otomatis.
  2. Periksa akun yang digunakan. Buka properti dari Jenkins layanan dan ulasan Masuk tab. Akun layanan khusus lebih disukai daripada LocalSystem untuk segala hal di luar eksperimen lokal.
  3. Verifikasi port yang digunakan untuk mendengarkan. Run netstat -ano | findstr :8080 dari Command Prompt. Entri LISTENING mengkonfirmasi bahwa Jenkins memegang port tersebut.
  4. Baca banner versi. Masuk di http://localhost:8080 dan bacalah nomor versi di pojok kanan bawah dasbor. Bandingkan dengan rilis yang telah Anda unduh.
  5. Nyalakan ulang sekali. Restart Windows lalu buka kembali dasbor tanpa memulai apa pun secara manual. Jika halaman dimuat, layanan tersebut benar-benar otomatis.

Layanan ini juga dapat dikontrol dari Command Prompt dengan hak akses administrator, yang lebih cepat daripada konsol grafis dan berfungsi dengan baik di dalam skrip penyebaran:

:: Stop, start, and query the Jenkins Windows service
net stop "Jenkins"
net start "Jenkins"
sc query "Jenkins"

:: Install Jenkins silently on a fleet of machines
msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^
  INSTALLDIR="D:\Jenkins" ^
  PORT=8080 ^
  /L*v "C:\logs\jenkins-install.txt"

💡 Kiat: Penginstal senyap menerima INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME, dan SERVICE_PASSWORD sebagai penggantian properti. Apa pun yang tidak Anda berikan akan kembali ke nilai default-nya, dan dalam mode senyap, layanan berjalan sebagai LocalSystem kecuali jika akun layanan diberikan.

Jika salah satu dari pemeriksaan ini gagal, penyebabnya biasanya dapat diprediksi, seperti yang akan ditunjukkan pada bagian selanjutnya.

Umum Jenkins Kesalahan Instalasi pada Windows dan Cara Memperbaikinya

Paling gagal Windows instalasi trackembali ke sejumlah kecil penyebab: tidak didukung Java runtime, port yang sedang digunakan, atau akun layanan yang tidak memiliki hak untuk masuk sebagai layanan. Masing-masing menghasilkan gejala yang berbeda, sehingga perbaikannya biasanya cepat setelah pesan dibaca dengan cermat.

  • Kredensial login layanan tidak valid: Pihak pemasang menolak akun tersebut selama proses Kredensial Uji langkah. Buka secpol.msc, memperluas Kebijakan Lokal > Penetapan Hak Pengguna, Buka Masuk sebagai layanan, lalu tambahkan akun tersebut. Kemudian coba lagi pengujian kredensial.
  • Port 8080 sudah digunakan: The Pelabuhan Uji Tombol berubah menjadi merah karena aplikasi lain, seringkali Tomcat lokal atau server pengembangan, sudah menggunakan port tersebut. Pilih port yang kosong seperti 8081, atau hentikan proses yang bertentangan yang diidentifikasi oleh netstat -ano.
  • Tidak didukung atau hilang Java: Penginstal tidak dapat mengisi sebelumnya Java direktori home, atau layanan dimulai dan langsung berhenti. Instal JDK 21 64-bit atau yang lebih baru, lalu arahkan penginstal ke direktori home-nya.
  • SmartScreen memblokir penginstal: Windows Melaporkan aplikasi yang tidak dikenal. Pilih Info lebih lanjut, kemudian Tetaplah berlari, setelah memastikan bahwa file tersebut berasal dari sumber resmi Jenkins halaman unduh.
  • Berkas initialAdminPassword tidak ditemukan: Direktori instalasi khusus telah dipilih. Lihat di dalam secrets folder direktori tersebut, atau baca kata sandinya dari jenkins.err.log dalam Jenkins direktori rumah.

Sekali Jenkins Setelah berjalan dengan andal, langkah selanjutnya yang wajar adalah menghubungkannya ke repositori sumber dan pipeline build. Panduan langkah demi langkah tentang Jenkins Integrasi GitHub dan Pipa CI/CD Jelaskan bagaimana integrasi berkelanjutan disusun di sekitar instalasi ini.

Pertanyaan Umum Demo Slot

Ya. Jenkins mengirimkan paket asli untuk keperluan utama Linux distribusi, sebuah formula Homebrew untuk macOS, dan citra kontainer resmi. Panduan penyiapan identik di semua platform; hanya perintah instalasi dan jalur file yang berbeda.

Hentikan Jenkins layanan, cadangkan Jenkins Di direktori home, kemudian jalankan installer MSI versi terbaru di atas instalasi yang sudah ada. Installer akan mempertahankan job dan konfigurasi. RevLihat catatan peningkatan LTS resmi sebelum beralih ke versi utama berikutnya.

AI Asisten mengelompokkan kegagalan build yang berulang, menyoroti pengujian yang tidak stabil, dan meringkas log konsol yang panjang menjadi kemungkinan penyebab utama. Hal ini mempersingkat waktu triase secara signifikan, meskipun manusia tetap menyetujui setiap perubahan konfigurasi.

Ya. Asisten pengkodean modern menyusun kode deklaratif. JenkinsFile-file tersebut berasal dari deskripsi sederhana proses pembuatan. Anggap output tersebut sebagai titik awal: validasi sintaksis, konfirmasikan penanganan kredensial, dan uji. pipa saluran Kerjakan di lingkungan uji coba terlebih dahulu.

Itu tergantung pada tujuannya. Buruh pelabuhan membuat Jenkins Portabel dan mudah diatur ulang, sehingga cocok untuk eksperimen. Installer MSI terintegrasi dengan Windows layanan dan rangkaian alat lokal, yang cocok untuk tim yang sedang membangun Windows atau aplikasi .NET.

Ringkaslah postingan ini dengan: