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.

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.
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.
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.
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.
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.
Langkah 6) Konfirmasikan Java Direktori beranda yang dideteksi oleh penginstal, tinjau opsi pengaturan khusus, dan klik Install tombol. Setelah instalasi selesai, klik Finish.
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.
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.
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.
Langkah 3) Buka file yang disorot dan salin isi file tersebut. Kata Sandi Admin awal file.
Langkah 4) Tempelkan kata sandi ke dalam Kata sandi administrator bidang pada Buka Kunci Jenkins buka halaman di browser Anda dan klik Continue .
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.
Jenkins Mulai mengunduh dan menginstal semua plugin yang dibutuhkan untuk membuat yang baru. Jenkins pekerjaan.
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.
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 .
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 .
Selamat! Sebuah pencapaian baru Jenkins Server sudah terpasang. Klik Mulai menggunakan Jenkins .
The Jenkins Instans sudah aktif dan berjalan, siap untuk pekerjaan pertama Anda. Singkat Jenkins tutorial untuk pemula menjelaskan cara menciptakan pekerjaan tersebut.
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.
- 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. - 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.
- Verifikasi port yang digunakan untuk mendengarkan. Run
netstat -ano | findstr :8080dari Command Prompt. Entri LISTENING mengkonfirmasi bahwa Jenkins memegang port tersebut. - Baca banner versi. Masuk di
http://localhost:8080dan bacalah nomor versi di pojok kanan bawah dasbor. Bandingkan dengan rilis yang telah Anda unduh. - 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
secretsfolder 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.


















