Kuidas alla laadida ja installida Jenkins on Windows

Jenkins võib paigaldada mõlemale poole Windows või Unixi platvormidel, kuid see ülevaade keskendub Windows ainult paigaldus. Windows MSI installija registrid Jenkins kui Windows teenuse ja valib 64-bitise Java käituskeskkond, mis teeb sellest kiireima tee toimiva automatiseerimisserveri juurde. Enne installija avamist veenduge, et teie masin vastab järgmises jaotises loetletud nõuetele.

Jenkins Eeltingimused ja süsteeminõuded

Jenkins on puhkeolekus kerge, kuid kasvab kiiresti, kui ehitusajalugu, tööruumid ja pluginad kogunevad. Masina õige suuruse määramine alguses hoiab ära hilisema vaevalise migreerimise.

Riistvaranõuded:

Tarkvara nõuded:

• Jenkins töötab Java, seega toetatud Java Arenduskomplekt (JDK) või Java Käituskeskkond (JRE) peab olema olemas. Praegune Jenkins väljalasked nõuavad Java 21 või hiljem; Java Uusim pikaajalise toe liin ei toeta enam versioone 8, 11 ja 17.
• Siit pääsemiseks on vaja kaasaegset veebibrauserit Jenkins armatuurlaud.
• Administraatoriõigustega konto saidil Windows registreerimiseks on vaja masinat Jenkins teenust.

Kinnitage installitud Java Enne jätkamist kuvage käsuviibalt versioon. Kui käsk ebaõnnestub või annab teada versioonist, mis on vanem kui 21, installige kõigepealt toetatud JDK.

:: 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)

Väljalasketüübid

Jenkins avaldab kaks väljalaskeliini ja valik mõjutab seda, kui tihti te uuendate.

See läbivaatus kasutab LTS-väljaannet, kuigi installiprotsess on iganädalase väljaande puhul identne. Kui eeltingimused on täidetud, saab allalaadimine alata.

Kuidas alla laadida Jenkins?

Järgige alltoodud samme, et saada Windows installija ja edukalt installimine lõpule viia:

Step 1) Minna https://www.jenkins.io/download/ ja valige platvorm. Meie puhul Windows.

Step 2) Mine oma kohalikus arvutis allalaadimise asukohta ja pakki allalaaditud pakett lahti. Double-klõpsa lahtipakitud ikoonil jenkins.msi faili. Jenkins saab käivitada ka WAR-failist (veebirakenduse ARchive), kuid seda marsruuti ei soovitata Windows sest see jätab vahele paigaldaja poolt hallatava teenuse registreerimise.

Märge: Windows SmartScreen võib teatada, et see takistas tundmatu rakenduse käivitamist. Valige Rohkem infot, Siis Jookse ikkagi, allkirjastatud jätkamiseks Jenkins paigaldaja.

Step 3) aasta Jenkins Seadistusekraanil klõpsake järgmine.

Step 4) Valige asukoht, kus Jenkins eksemplar peaks olema installitud. Praeguste 64-bitiste installijate vaikesäte on C:\Programmifailid\JenkinsPange see tee tähele, sest algne administraatori parool on selle sees salvestatud. Klõpsake järgmine.

Step 5) Seejärel küsib installija teenuse sisselogimisandmeid ja pordi numbrit. Sisestage spetsiaalne kohalik või domeenikonto ja klõpsake nuppu Testi volitused, seejärel määrake port ja klõpsake Test Port. Sadam 8080 on vaikeväärtus. Töötab Jenkins nimetatud teenusekonto all on turvalisem kui LocalSystem-valik, mis annab Jenkins täielik juurdepääs masinale.

Step 6) Kinnitage Java kodukataloogi, mille installer tuvastab, vaadake üle kohandatud installivalikud ja klõpsake nuppu paigaldama nuppu. Kui installimine on lõppenud, klõpsake lõpp.

Step 7) Installiprotsessi ajal võib ilmuda infopaneel, mis teavitab teid taaskäivitamise vajadusest praeguse installi lõpus. Klõpsake nuppu OK nuppu, kui teabepaneel kuvatakse.

Failid on nüüd kettal ja teenus on registreeritud. Järgmises etapis avatakse veebiliides.

Kuidas deblokeerida Jenkins?

Pärast Jenkins Installifaasis on kontroller lukustatud, kuni sisestate automaatselt genereeritud parooli. Allolevad sammud selgitavad, kuidas kontroller avada. Jenkins kohaldamist:

Step 1) Pärast installiprotsessi lõppu avaneb brauseri vahekaart, kus küsitakse esialgset administraatori parooli. Jõudmiseks Jenkins, sirvige oma veebibrauseris järgmisele teele.
http://localhost:8080

Kui ülaltoodud aadress laadib, õnnestus installimine ja teenus töötab.

Step 2) Esialgne administraatori parool salvestatakse kausta Jenkins installitee, mille määrasite installi 4. etapis. Vaikimisi asukoha jaoks C:\Programmifailid\Jenkinsfail nimega esialgneAdminPassword on leitav alt C:\Programmifailid\Jenkins\saladusedKui valitud on kohandatud tee, kontrollige hoopis seda asukohta. Sama väärtus kirjutatakse ka jenkins.err.log failil Jenkins kodukataloog.

Step 3) Ava esiletõstetud fail ja kopeeri selle sisu esialgneAdminPassword faili.

Step 4) Kleepige parool sisse Administraatori parool väli Ava Jenkins leht oma brauseris ja klõpsake jätkama nuppu.

Kui kontroller on lukustamata, liigub häälestusviisard edasi pluginate ja esimese kasutajakonto juurde.

Kohanda Jenkins

Samuti saate kohandada oma Jenkins keskkonda, kasutades alltoodud samme:

Step 1) kliki Paigalda soovitatud pluginad nuppu nii, et Jenkins hangib ja installib olulised pluginad.

Jenkins hakkab alla laadima ja installima kõiki uue loomiseks vajalikke pluginasid Jenkins töökohti.

Märge: Saate valida valiku Valige installitavad pluginad ja vali ainult soovitud pluginad. Pluginaid saab hiljem lisada või eemaldada siit juhtima Jenkins > Pluginad, seega see valik pole püsiv.

Step 2) Pärast kõigi soovitatud pluginate installimist Loo esimene administraator paneel kuvatakse. Täitke kõik väljad soovitud kontoandmetega ja klõpsake nuppu Salvesta ja lõpeta nuppu.

Step 3) Jenkins lõpuks küsib, et URL kuhu eksemplari jõutakse. Jätke vaikeväärtus samaks, et hiljem segadust vältida. Kui mõni teine ​​rakendus juba kasutab porti 8080, sisestage siia teine ​​port ja seejärel klõpsake nuppu Salvesta ja jätka nuppu.

Palju õnne! Uus Jenkins server on nüüd installitud. Klõpsake nuppu Alustage kasutamist Jenkins nuppu.

. Jenkins eksemplar on töövalmis ja valmis teie esimeseks tööks. Lühike Jenkins õpetus algajatele selgitab, kuidas seda töökohta luua.

Kuidas kontrollida Jenkins Teenuse installimine ja haldamine

Ühekordne laadimisarmatuurlaud ei ole tõend korraliku installi kohta. Sest MSI installija registreerub Jenkins kui Windows teenuse puhul peab teenus taaskäivituse üle elama ja nõudmisel puhtalt taaskäivituma. Tehke allolevad kontrollid kohe pärast häälestusviisardi sulgemist.

1. Kinnitage teenuse olemasolu. press Win + R, kirjuta services.mscja vajutage sisestusklahvi (Enter). Leidke kirje nimega Jenkins ja kinnitage, et olek on Running ja käivitustüüp on järgmine Automaatne.
2. Kontrollige kasutatavat kontot. Avage faili omadused Jenkins teenindus ja ülevaade Logi Sisse vahekaart. Lisaks kohalikele katsetustele on LocalSystemile eelistatav spetsiaalne teenusekonto.
3. Kontrollige kuulamisporti. jooks netstat -ano | findstr :8080 käsuviibalt. Kirje KUULAB kinnitab, et Jenkins hoiab sadamat.
4. Loe versioonibännerit. Logi sisse aadressil http://localhost:8080 ja lugege versiooninumbrit armatuurlaua paremas alanurgas. Võrrelge seda allalaaditud versiooniga.
5. Taaskäivitage üks kord. Restart Windows ja sirvige uuesti armatuurlauale ilma midagi käsitsi käivitamata. Kui leht laeb, on teenus tõeliselt automaatne.

Teenust saab juhtida ka kõrgendatud käsuviiba kaudu, mis on kiirem kui graafiline konsool ja töötab hästi juurutusskriptide sees:

:: 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"

💡 Näpunäide: Vaikne paigaldaja aktsepteerib INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAMEja SERVICE_PASSWORD atribuut tühistab väärtuse. Kõik, mida te ei edasta, taastatakse vaikeväärtusena ja vaikses režiimis töötab teenus nimega LocalSystem, kui teenusekontot pole määratud.

Kui mõni neist kontrollidest ebaõnnestub, on põhjused tavaliselt etteaimatavad, nagu järgmises osas näidatud.

ühine Jenkins Installimisvead saidil Windows ja kuidas neid parandada

Kõige ebaõnnestunud Windows Käitised tractagasi väikese hulga põhjuste juurde: toetuseta Java käitusaja, hõivatud pordi või teenusekontoga, millel puudub õigus teenusena sisse logida. Igaüks neist tekitab erineva sümptomi, seega on parandus tavaliselt kiire, kui teadet hoolikalt lugeda.

• Kehtetud teenuse sisselogimisandmed: Paigaldaja lükkab konto tagasi Testi volitused samm. Ava secpol.msc, laiendage Kohalikud eeskirjad > Kasutajaõiguste määramine, avatud Logi sisse teenusenaja lisage konto. Seejärel proovige volituste testi uuesti.
• Port 8080 on juba kasutusel: . Test Port nupp muutub punaseks, kuna port on juba teisel rakendusel, sageli kohalikul Tomcatil või arendusserveril. Valige vaba port, näiteks 8081, või peatage vastuoluline protsess, mille on tuvastanud netstat -ano.
• Toetamata või puudub Java: Paigaldaja ei saa eeltäita Java kodukataloogi või teenus käivitub ja peatub kohe. Installige 64-bitine JDK 21 või uuem ja seejärel suunake installer selle kodukataloogi.
• SmartScreen blokeerib installija: Windows teatab tundmatust rakendusest. Valige Rohkem infot, Siis Jookse ikkagipärast kinnitamist, et fail pärineb ametlikult Jenkins allalaaditav leht.
• initialAdminPassword faili ei leitud: Valiti kohandatud installikataloog. Vaadake kausta sisse. secrets selle kataloogi kausta või lugege parool sealt jenkins.err.log aasta Jenkins kodukataloog.

Kunagi Jenkins töötab usaldusväärselt, on loomulik järgmine samm selle ühendamine lähtekoodihoidla ja ehitustorustikuga. Läbipääsud on toodud Jenkins GitHubi integreerimine ja CI/CD torujuhe Selgitage, kuidas pidev integratsioon selle installatsiooni ümber kokku pannakse.

KKK