Hvordan laste ned og installere Jenkins on Windows

Jenkins kan installeres på begge Windows eller Unix-plattformer, men denne gjennomgangen fokuserer på Windows kun installasjon. Den Windows MSI-installasjonsprogrammet registrerer seg Jenkins som en Windows tjenesten og velger en 64-bit Java kjøretid for deg, noe som gjør det til den raskeste ruten til en fungerende automatiseringsserver. Før du åpner installasjonsprogrammet, må du bekrefte at maskinen din oppfyller kravene som er oppført i neste avsnitt.

Jenkins Forutsetninger og systemkrav

Jenkins er lett i hvilemodus, men vokser raskt når byggehistorikk, arbeidsområder og plugins akkumuleres. Riktig dimensjonering av maskinen i starten unngår en smertefull migrering senere.

Maskinvarekrav:

Programvare krav:

• Jenkins kjører på Java, så en støttet Java Utviklingssett (JDK) eller Java Runtime Environment (JRE) må være til stede. Gjeldende Jenkins utgivelser krever Java 21 eller senere; Java 8, 11 og 17 støttes ikke lenger av den nyeste langsiktige støttelinjen.
• En moderne nettleser er nødvendig for å nå Jenkins dashbordet.
• En konto med administratorrettigheter på Windows maskinen er nødvendig for å registrere Jenkins service.

Bekreft den installerte Java versjon fra ledeteksten før du fortsetter. Hvis kommandoen mislykkes eller rapporterer en versjon eldre enn 21, må du først installere en stø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)

Utgivelsestyper

Jenkins publiserer to utgivelseslinjer, og valget påvirker hvor ofte du oppgraderer.

Denne gjennomgangen bruker LTS-utgivelsen, men installasjonsprosessen er identisk for den ukentlige utgivelsen. Når forutsetningene er på plass, kan nedlastingen begynne.

Hvordan laste ned Jenkins?

Følg trinnene nedenfor for å få tak i Windows installasjonsprogram og fullfør en vellykket installasjon:

Trinn 1) Gå til https://www.jenkins.io/download/ og velg plattformen. I vårt tilfelle, Windows.

Trinn 2) Gå til nedlastingsstedet på den lokale datamaskinen din og pakk ut den nedlastede pakken. Double-klikk på den utpakkede filen jenkins.msi filen. Jenkins kan også kjøres fra en WAR-fil (Web Application ARchive), men den ruten anbefales ikke på Windows fordi den hopper over tjenesteregistreringen som håndteres av installatøren.

OBS: Windows SmartScreen kan rapportere at den forhindret at et ukjent program startet. Velg Informasjon, deretter Løp uansett, for å fortsette med det signerte Jenkins installatør.

Trinn 3) på Jenkins Oppsettskjermen, klikk neste.

Trinn 4) Velg stedet der Jenkins instansen bør installeres. Standardplasseringen på nåværende 64-biters installasjonsprogrammer er C: \ Program Files \JenkinsMerk deg denne banen, fordi det opprinnelige administratorpassordet er lagret i den. Klikk neste.

Trinn 5) Installasjonsprogrammet ber deretter om tjenestens påloggingsinformasjon og portnummer. Oppgi en dedikert lokal konto eller domenekonto og klikk. Testlegitimasjon, angi deretter porten og klikk på Test port. Havn 8080 er standardinnstillingen. Kjører Jenkins under en navngitt tjenestekonto er tryggere enn LocalSystem-alternativet, som gir Jenkins full tilgang til maskinen.

Trinn 6) Bekreft Java hjemmekatalogen som installasjonsprogrammet oppdager, se gjennom alternativene for tilpasset oppsett og klikk på Install -knappen. Når installasjonen er fullført, klikker du på Finish.

Trinn 7) Under installasjonsprosessen kan det hende at et informasjonspanel vises som informerer deg om at en omstart er nødvendig etter at den gjeldende installasjonen er fullført. Klikk på OK -knappen når informasjonspanelet vises.

Filene er nå på disk, og tjenesten er registrert. Neste trinn låser opp webgrensesnittet.

Hvordan fjerne blokkering Jenkins?

Etter å ha fullført Jenkins I installasjonsfasen er kontrolleren låst inntil du oppgir et automatisk generert passord. Trinnene nedenfor forklarer hvordan du opphever blokkeringen av Jenkins søknaden:

Trinn 1) Etter at installasjonsprosessen er fullført, åpnes en nettleserfane der du blir bedt om å oppgi det opprinnelige administratorpassordet. Jenkins, bla til følgende sti i nettleseren din.
http://localhost:8080

Hvis adressen ovenfor lastes inn, var installasjonen vellykket, og tjenesten kjører.

Trinn 2) Det opprinnelige administratorpassordet er lagret under Jenkins installasjonsbanen du anga i trinn 4 av installasjonen. For standardplasseringen C: \ Program Files \Jenkins, en fil kalt initialAdminPassword finnes under C: \ Program Files \JenkinshemmeligheterHvis en tilpasset bane ble valgt, sjekk den plasseringen i stedet. Den samme verdien skrives også til jenkins.err.log fil i Jenkins hjemmekatalog.

Trinn 3) Åpne den uthevede filen og kopier innholdet i initialAdminPassword filen.

Trinn 4) Lim inn passordet i Administratorpassord feltet på Lås opp Jenkins siden i nettleseren din og klikk på Fortsett knapp.

Når kontrolleren er opplåst, går installasjonsveiviseren videre til pluginer og den første brukerkontoen.

Tilpass Jenkins

Du kan også tilpasse din Jenkins miljøet ved å følge trinnene nedenfor:

Trinn 1) Klikk på Installer foreslåtte programtillegg knappen slik at Jenkins henter og installerer de viktigste programtilleggene.

Jenkins begynner å laste ned og installere alle programtilleggene som trengs for å lage nye Jenkins arbeidsplasser.

OBS: Du kan velge alternativet Velg programtillegg som skal installeres og velg bare de programtilleggene du ønsker. Programtillegg kan legges til eller fjernes senere fra Administrer Jenkins > Programtillegg, så dette valget er ikke permanent.

Trinn 2) Etter at alle foreslåtte programtillegg er installert, Opprett første administratorbruker panelet vises. Fyll ut alle feltene med ønsket kontoinformasjon og klikk på Lagre og fullfør knapp.

Trinn 3) Jenkins ber til slutt om URL hvor forekomsten vil bli nådd. La standardverdien stå for å unngå forvirring senere. Hvis et annet program allerede bruker port 8080, oppgi en annen port her, og klikk deretter på Lagre og fortsett knapp.

Gratulerer! En ny Jenkins Serveren er nå installert. Klikk på Begynn å bruke Jenkins knapp.

Ocuco Jenkins instansen er oppe og går, klar for din første jobb. En kort Jenkins veiledning for nybegynnere forklarer hvordan man oppretter den jobben.

Slik bekrefter du Jenkins Installasjon og administrasjon av tjenesten

Et dashbord som lastes inn én gang er ikke bevis på en feilfri installasjon. Fordi MSI-installasjonsprogrammet registrerer Jenkins som en Windows tjenesten, må tjenesten overleve en omstart og starte på nytt uten problemer på forespørsel. Gå gjennom kontrollene nedenfor umiddelbart etter at installasjonsveiviseren lukkes.

1. Bekreft at tjenesten finnes. Press Win + R, Type services.msc, og trykk Enter. Finn oppføringen med navnet Jenkins og bekreft at statusen viser kjører og oppstartstypen leser Automatisk.
2. Sjekk kontoen som er i bruk. Åpne egenskapene til Jenkins tjenesten og gjennomgå den Logg på tab. En dedikert tjenestekonto er å foretrekke fremfor LocalSystem for alt utover lokal eksperimentering.
3. Bekreft lytteporten. Kjør netstat -ano | findstr :8080 fra ledeteksten. En LYTTING-oppføring bekrefter det. Jenkins holder havnen.
4. Les versjonsbanneret. Logg inn på http://localhost:8080 og les versjonsnummeret nederst til høyre på dashbordet. Sammenlign det med versjonen du lastet ned.
5. Start på nytt én gang. Restart Windows og bla til dashbordet igjen uten å starte noe manuelt. Hvis siden lastes inn, er tjenesten virkelig automatisk.

Tjenesten kan også styres fra en forhøyet kommandolinje, som er raskere enn den grafiske konsollen og fungerer bra i distribusjonsskript:

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

💡 Tips: Den stille installatøren godtar INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAMEog SERVICE_PASSWORD som egenskapsoverstyringer. Alt du ikke sender går tilbake til standardverdien, og i stille modus kjører tjenesten som LocalSystem med mindre en tjenestekonto er oppgitt.

Hvis noen av disse kontrollene mislykkes, er årsakene vanligvis forutsigbare, som neste avsnitt viser.

Felles Jenkins Installasjonsfeil på Windows og hvordan du fikser dem

De fleste mislyktes Windows installasjon tractilbake til et lite sett med årsaker: en ustøttet Java kjøretid, en okkupert port eller en tjenestekonto som mangler rettighet til å logge på som en tjeneste. Hver av dem gir et distinkt symptom, så løsningen er vanligvis rask når meldingen leses nøye.

• Ugyldig tjenestepåloggingsinformasjon: Installasjonsprogrammet avviser kontoen i løpet av Testlegitimasjon trinn. Åpne secpol.msc, utvide Lokale retningslinjer > Tildeling av brukerrettigheter, åpen Logg på som en tjeneste, og legg til kontoen. Prøv deretter legitimasjonstesten på nytt.
• Port 8080 er allerede i bruk: Ocuco Test port knappen blir rød fordi et annet program, ofte en lokal Tomcat eller en utviklingsserver, allerede har porten. Velg en ledig port, for eksempel 8081, eller stopp den konfliktfylte prosessen som identifiseres av netstat -ano.
• Ikke støttet eller mangler Java: Installasjonsprogrammet kan ikke forhåndsfylle Java hjemmekatalogen, eller tjenesten starter og stopper umiddelbart. Installer en 64-biters JDK 21 eller nyere, og pek deretter installasjonsprogrammet mot hjemmekatalogen.
• SmartScreen blokkerer installasjonsprogrammet: Windows rapporterer en ukjent applikasjon. Velg Informasjon, deretter Løp uansett, etter å ha bekreftet at filen kom fra den offisielle Jenkins nedlastingsside.
• initialAdminPassword-filen ble ikke funnet: En tilpasset installasjonskatalog ble valgt. Se inni secrets mappen i den katalogen, eller les passordet fra jenkins.err.log i Jenkins hjemmekatalog.

Gang Jenkins kjører pålitelig, er det naturlige neste trinnet å koble den til et kildelager og en byggepipeline. Gjennomgangene på Jenkins GitHub-integrasjon og CI/CD pipeline Forklar hvordan kontinuerlig integrasjon er satt sammen rundt denne installasjonen.

Spørsmål og svar