Sådan downloader og installerer du Jenkins on Windows

Jenkins kan installeres på begge Windows eller Unix-platforme, men denne gennemgang fokuserer på Windows kun installation. Den Windows MSI-installationsprogrammet registrerer Jenkins som en Windows tjeneste og vælger en 64-bit Java runtime for dig, hvilket gør det til den hurtigste vej til en fungerende automatiseringsserver. Før du åbner installationsprogrammet, skal du bekræfte, at din maskine opfylder kravene i næste afsnit.

Jenkins Forudsætninger og systemkrav

Jenkins er let i hviletilstand, men vokser hurtigt, når byggehistorik, arbejdsområder og plugins akkumuleres. Korrekt dimensionering af maskinen i starten forhindrer en smertefuld migrering senere.

Hardwarekrav:

Softwarekrav:

• Jenkins kører på Java, så en understøttet Java Udviklingssæt (JDK) eller Java Runtime Environment (JRE) skal være til stede. Aktuel Jenkins udgivelser kræver Java 21 eller senere; Java 8, 11 og 17 understøttes ikke længere af den nyeste langsigtede supportlinje.
• En moderne webbrowser er nødvendig for at nå Jenkins instrumentbræt.
• En konto med administratorrettigheder på Windows maskinen er nødvendig for at registrere Jenkins service.

Bekræft den installerede Java version fra kommandoprompten, før du fortsætter. Hvis kommandoen mislykkes eller rapporterer en version under 21, skal du først installere en understøttet 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)

Udgivelsestyper

Jenkins udgiver to udgivelseslinjer, og valget påvirker, hvor ofte du opgraderer.

Denne gennemgang bruger LTS-udgivelsen, selvom installationsprocessen er identisk for den ugentlige udgivelse. Når forudsætningerne er på plads, kan downloadingen begynde.

Sådan downloades Jenkins?

Følg nedenstående trin for at få Windows installationsprogram og fuldfør en vellykket installation:

Trin 1) Gå til https://www.jenkins.io/download/ og vælg platformen. I vores tilfælde, Windows.

Trin 2) Gå til downloadplaceringen på din lokale computer, og udpak den downloadede pakke. Double-klik på den udpakkede fil jenkins.msi fil. Jenkins kan også køre fra en WAR-fil (Web Application ARchive), men den rute anbefales ikke på Windows fordi den springer den serviceregistrering, der håndteres af installationsprogrammet, over.

Bemærk: Windows SmartScreen rapporterer muligvis, at den forhindrede et ukendt program i at starte. Vælg Mere info, derefter Kør alligevel, for at fortsætte med den underskrevne Jenkins installatør.

Trin 3) I Jenkins Opsætningsskærmen, klik på Næste.

Trin 4) Vælg den placering, hvor Jenkins instansen skal installeres. Standardplaceringen på nuværende 64-bit installationsprogrammer er C: \ Program Files \JenkinsBemærk denne sti, fordi den oprindelige administratoradgangskode er gemt i den. Klik Næste.

Trin 5) Installationsprogrammet beder derefter om tjenestens logonoplysninger og portnummeret. Angiv en dedikeret lokal konto eller domænekonto, og klik på Testlegitimationsoplysninger, indstil derefter porten og klik på Test port. Havn 8080 er standardindstillingen. Kører Jenkins under en navngiven servicekonto er sikrere end LocalSystem-indstillingen, som giver Jenkins fuld adgang til maskinen.

Trin 6) Bekræft Java den hjemmemappe, som installationsprogrammet registrerer, gennemgå de brugerdefinerede opsætningsindstillinger, og klik på Installer knappen. Når installationen er færdig, skal du klikke på Finish.

Trin 7) Under installationsprocessen kan der vises et informationspanel, der informerer dig om, at en genstart er nødvendig efter den aktuelle installation. Klik på OK knappen, når informationspanelet vises.

Filerne er nu på disken, og tjenesten er registreret. Næste trin låser webgrænsefladen op.

Sådan fjerner du blokering Jenkins?

Efter afsluttet Jenkins I installationsfasen er controlleren låst, indtil du angiver en automatisk genereret adgangskode. Trinene nedenfor forklarer, hvordan du fjerner blokeringen af Jenkins ansøgning:

Trin 1) Når installationsprocessen er færdig, åbnes en browserfane, hvor du bliver bedt om at indtaste den oprindelige administratoradgangskode. Jenkins, skal du gå til følgende sti i din webbrowser.
http://localhost:8080

Hvis ovenstående adresse indlæses, er installationen lykkedes, og tjenesten kører.

Trin 2) Den oprindelige administratoradgangskode er gemt under Jenkins installationsstien, som du angav i trin 4 af installationen. For standardplaceringen C: \ Program Files \Jenkins, en fil kaldet initialAdminPassword findes under C: \ Program Files \JenkinshemmelighederHvis en brugerdefineret sti blev valgt, skal du i stedet kontrollere den placering. Den samme værdi skrives også til jenkins.err.log fil i Jenkins hjemmekatalog.

Trin 3) Åbn den markerede fil, og kopier indholdet af initialAdminPassword fil.

Trin 4) Indsæt adgangskoden i Administratoradgangskode feltet på Lås op Jenkins side i din browser og klik på Fortsæt. .

Når controlleren er låst op, går installationsguiden videre til plugins og den første brugerkonto.

Tilpas Jenkins

Du kan også tilpasse din Jenkins miljø ved hjælp af nedenstående trin:

Trin 1) Klik på knappen Installer foreslåede plugins knap så det Jenkins henter og installerer de nødvendige plugins.

Jenkins begynder at downloade og installere alle de plugins, der er nødvendige for at oprette nye Jenkins beskæftigelse.

Bemærk: Du kan vælge muligheden Vælg plugins, der skal installeres og vælg kun de plugins, du ønsker. Plugins kan tilføjes eller fjernes senere fra Administrer Jenkins > Plugins, så dette valg er ikke permanent.

Trin 2) Når alle foreslåede plugins er installeret, Opret første administratorbruger panelet vises. Udfyld alle felterne med de ønskede kontooplysninger, og klik på Gem og Afslut .

Trin 3) Jenkins spørger endelig om URL hvor instansen vil blive nået. Behold standardværdien for at undgå forvirring senere. Hvis et andet program allerede bruger port 8080, skal du angive en anden port her og derefter klikke på Gem og fortsæt .

Tillykke! En ny Jenkins Serveren er nu installeret. Klik på Begynd at bruge Jenkins .

Jenkins instansen er oppe og kører, klar til dit første job. En kort Jenkins tutorial til begyndere forklarer, hvordan man opretter det job.

Sådan verificerer du Jenkins Installation og administration af tjenesten

Et dashboard, der indlæses én gang, er ikke bevis på en korrekt installation. Fordi MSI-installationsprogrammet registrerer Jenkins som en Windows tjenesten, skal tjenesten overleve en genstart og genstarte korrekt efter behov. Gennemgå kontrollerne nedenfor umiddelbart efter installationsguiden lukkes.

1. Bekræft at tjenesten eksisterer. Presse Win + RSkriv services.msc, og tryk på Enter. Find posten med navnet Jenkins og bekræft at statussen viser Løb og opstartstypen læser Automatisk Ur.
2. Tjek den konto, der er i brug. Åbn egenskaberne for Jenkins service og gennemgå Log On fane. En dedikeret servicekonto er at foretrække frem for LocalSystem til alt ud over lokal eksperimentering.
3. Bekræft lytteporten. Kør netstat -ano | findstr :8080 fra kommandoprompten. En LYTTENDE indtastning bekræfter det Jenkins holder havnen.
4. Læs versionsbanneret. Log ind på http://localhost:8080 og læs versionsnummeret i nederste højre hjørne af dashboardet. Sammenlign det med den version, du downloadede.
5. Genstart én gang. Genstart Windows og gå til dashboardet igen uden at starte noget manuelt. Hvis siden indlæses, er tjenesten virkelig automatisk.

Tjenesten kan også styres fra en kommandoprompt med administratorrettigheder, som er hurtigere end den grafiske konsol og fungerer godt i implementeringsscripts:

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

💡 Tip: Den lydløse installatør accepterer INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAMEog SERVICE_PASSWORD som egenskabsoverskrivelser. Alt, hvad du ikke sender, vender tilbage til standardværdien, og i lydløs tilstand kører tjenesten som LocalSystem, medmindre en tjenestekonto angives.

Hvis en af ​​disse kontroller fejler, er årsagerne normalt forudsigelige, som det næste afsnit viser.

Fælles Jenkins Installationsfejl på Windows og hvordan man fikser dem

De fleste mislykkedes Windows installation tractilbage til et lille sæt årsager: en ikke-understøttet Java runtime, en optaget port eller en servicekonto, der mangler rettigheden til at logge på som en service. Hver af dem giver et distinkt symptom, så løsningen er normalt hurtig, når meddelelsen læses omhyggeligt.

• Ugyldige loginoplysninger til tjenesten: Installationsprogrammet afviser kontoen under Testlegitimationsoplysninger trin. Åbn secpol.msc, udvide Lokale politikker > Tildeling af brugerrettigheder, åben Log på som en tjeneste, og tilføj kontoen. Prøv derefter legitimationstesten igen.
• Port 8080 er allerede i brug: Test port Knappen bliver rød, fordi et andet program, ofte en lokal Tomcat eller en udviklingsserver, allerede har porten. Vælg en ledig port, f.eks. 8081, eller stop den modstridende proces, der er identificeret af netstat -ano.
• Ikke understøttet eller mangler Java: Installationsprogrammet kan ikke forudfylde Java hjemmemappen, eller tjenesten starter og stopper straks. Installer en 64-bit JDK 21 eller nyere, og peg derefter installationsprogrammet på dens hjemmemappe.
• SmartScreen blokerer installationsprogrammet: Windows rapporterer en ukendt applikation. Vælg Mere info, derefter Kør alligevelefter at have bekræftet, at filen kom fra den officielle Jenkins download side.
• initialAdminPassword-fil ikke fundet: En brugerdefineret installationsmappe blev valgt. Se i secrets mappe i den pågældende mappe, eller læs adgangskoden fra jenkins.err.log i Jenkins hjemmekatalog.

Når Jenkins kører pålideligt, er det naturlige næste skridt at forbinde det til et kildelager og en build-pipeline. Gennemgangene på Jenkins GitHub-integration og CI/CD pipeline Forklar hvordan kontinuerlig integration er opbygget omkring denne installation.

Ofte Stillede Spørgsmål