Kuinka ladata ja asentaa Jenkins on Windows

Jenkins voidaan asentaa kummallekin Windows tai Unix-alustoille, mutta tämä läpikäynti keskittyy Windows vain asennus. Windows MSI-asennusohjelman rekisterit Jenkins kuten Windows palvelun ja valitsee 64-bittisen Java ajonaikaisen ympäristön puolestasi, mikä tekee siitä nopeimman reitin toimivaan automaatiopalvelimeen. Ennen asennusohjelman avaamista varmista, että koneesi täyttää seuraavassa osiossa luetellut vaatimukset.

Jenkins Edellytykset ja järjestelmävaatimukset

Jenkins on kevyt lepotilassa, mutta kasvaa nopeasti koontihistorian, työtilojen ja laajennusten kertyessä. Koneen oikean kokoaminen alussa välttää tuskallisen migraation myöhemmin.

Laitteistovaatimukset:

Ohjelmistovaatimukset:

• Jenkins käy Java, joten tuettu Java Kehityspakkaus (JDK) tai Java Ajonaikaisen ympäristön (JRE) on oltava asennettuna. Nykyinen Jenkins julkaisut vaativat Java 21 tai uudempi; Java Uusin pitkäaikaisen tuen tuotelinja ei enää tue versioita 8, 11 ja 17.
• Nykyaikainen verkkoselain tarvitaan sivuston käyttämiseen. Jenkins kojelautaan.
• Tili, jolla on järjestelmänvalvojan oikeudet Windows konetta tarvitaan rekisteröintiin Jenkins palvelusta.

Vahvista asennettu Java versio komentokehotteesta ennen kuin jatkat. Jos komento epäonnistuu tai ilmoittaa version, joka on vanhempi kuin 21, asenna ensin tuettu 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)

Julkaisutyypit

Jenkins julkaisee kaksi julkaisuversiota, ja valinta vaikuttaa päivitystiheyteen.

Tässä ohjeessa käytetään LTS-julkaisua, vaikka asennusprosessi on identtinen viikoittaisen julkaisun kanssa. Kun edellytykset on täytetty, lataus voi alkaa.

Lataaminen Jenkins?

Noudata alla olevia ohjeita saadaksesi Windows asennusohjelma ja suorita asennus onnistuneesti loppuun:

Vaihe 1) Mene https://www.jenkins.io/download/ ja valitse alusta. Meidän tapauksessamme Windows.

Vaihe 2) Siirry latauskansioon paikallisella tietokoneellasi ja pura ladattu paketti. Double- napsauta purettua zip-tiedostoa jenkins.msi tiedosto. Jenkins voi myös suorittaa WAR (Web application ARchive) -tiedostosta, mutta tätä reittiä ei suositella Windows koska se ohittaa asentajan käsittelemän palvelun rekisteröinnin.

Huomautus: Windows SmartScreen saattaa ilmoittaa estäneensä tuntemattoman sovelluksen käynnistymisen. Valitse Lisätietoja, sitten Suorita silti, jatkaakseen allekirjoitettua Jenkins asentaja.

Vaihe 3) In Jenkins Asennusnäyttö, napsauta seuraava.

Vaihe 4) Valitse sijainti, jossa Jenkins instanssin pitäisi olla asennettuna. Nykyisten 64-bittisten asennusohjelmien oletussijainti on C: \ Program Files \Jenkins. Kirjoita tämä polku muistiin, koska alkuperäinen järjestelmänvalvojan salasana on tallennettu sen sisään. Napsauta seuraava.

Vaihe 5) Asennusohjelma pyytää sitten palvelun kirjautumistietoja ja portin numeroa. Anna erillinen paikallinen tai verkkotunnustili ja napsauta Testitiedot, aseta sitten portti ja napsauta Testiportti. Portti 8080 on oletusarvo. Käynnissä Jenkins nimetyn palvelutilin alla on turvallisempi kuin LocalSystem-vaihtoehto, joka myöntää Jenkins täysi pääsy koneeseen.

Vaihe 6) Vahvista Java asennusohjelman tunnistaman kotihakemiston, tarkista mukautetut asennusasetukset ja napsauta install -painiketta. Kun asennus on valmis, napsauta Suorittaa loppuun.

Vaihe 7) Asennusprosessin aikana saattaa tulla näkyviin tietopaneeli, joka ilmoittaa, että nykyisen asennuksen lopussa on käynnistettävä uudelleen. Napsauta OK -painiketta, kun tietopaneeli tulee näkyviin.

Tiedostot ovat nyt levyllä ja palvelu on rekisteröity. Seuraava vaihe avaa web-käyttöliittymän.

Kuinka poistaa esto Jenkins?

Suoritettuasi Jenkins Asennusvaiheessa ohjain on lukittu, kunnes annat automaattisesti luodun salasanan. Alla olevat vaiheet selittävät, miten lukitus poistetaan. Jenkins sovellus:

Vaihe 1) Asennuksen päätyttyä selainvälilehti avautuu ja kysyy alkuperäistä järjestelmänvalvojan salasanaa. Päästäksesi Jenkins, selaa seuraavaan polkuun selaimessasi.
http://localhost:8080

Jos yllä oleva osoite latautuu, asennus onnistui ja palvelu on käynnissä.

Vaihe 2) Alkuperäinen järjestelmänvalvojan salasana on tallennettu kohtaan Jenkins asennuspolku, jonka asetit asennuksen vaiheessa 4. Oletussijainti C: \ Program Files \Jenkins, tiedosto nimeltä alkuperäinen AdminPassword löytyy alta C: \ Program Files \Jenkins\salaisuudetJos valittiin mukautettu polku, tarkista kyseinen sijainti. Sama arvo kirjoitetaan myös jenkins.err.log Tiedosto Jenkins kotihakemisto.

Vaihe 3) Avaa korostettu tiedosto ja kopioi sen sisältö alkuperäinen AdminPassword tiedosto.

Vaihe 4) Liitä salasana sisään Järjestelmänvalvojan salasana kenttä Avaa-kohdassa Jenkins sivu selaimessasi ja napsauta jatkaa painiketta.

Kun ohjaimen lukitus on avattu, asennustoiminto siirtyy laajennuksiin ja ensimmäiseen käyttäjätiliin.

Muokkaa Jenkins

Voit myös mukauttaa omasi Jenkins ympäristössä alla olevien vaiheiden mukaisesti:

Vaihe 1) Valitse Asenna ehdotetut laajennukset painiketta niin Jenkins hakee ja asentaa tarvittavat lisäosat.

Jenkins alkaa ladata ja asentaa kaikkia uuden luomiseen tarvittavia laajennuksia Jenkins työpaikkaa.

Huomautus: Voit valita vaihtoehdon Valitse asennettavat laajennukset ja valitse vain haluamasi laajennukset. Laajennuksia voi lisätä tai poistaa myöhemmin kohdasta hoitaa Jenkins > Laajennukset, joten tämä valinta ei ole pysyvä.

Vaihe 2) Kun kaikki ehdotetut lisäosat on asennettu, Luo ensimmäinen järjestelmänvalvoja paneeli tulee näkyviin. Täytä kaikki kentät halutuilla tilitiedoilla ja napsauta Tallenna ja lopeta painiketta.

Vaihe 3) Jenkins lopulta pyytää, että URL josta instanssiin päästään. Jätä oletusarvo myöhempien sekaannusten välttämiseksi. Jos toinen sovellus käyttää jo porttia 8080, anna tässä toinen portti ja napsauta sitten Tallenna ja jatka painiketta.

Onnittelut! Uusi Jenkins Palvelin on nyt asennettu. Napsauta Ottaa käyttöön Jenkins painiketta.

Jenkins instanssi on toiminnassa ja valmis ensimmäiseen työhösi. Lyhyt Jenkins opas aloittelijoille selittää, miten kyseinen työpaikka luodaan.

Kuinka varmistaa Jenkins Palvelun asennus ja hallinta

Kerran latautuva kojelauta ei ole todiste toimivasta asennuksesta. Koska MSI-asennusohjelma rekisteröityy Jenkins kuten Windows palvelu, palvelun on selvittävä uudelleenkäynnistyksestä ja käynnistyttävä uudelleen puhtaasti tarvittaessa. Tee alla olevat tarkistukset heti asennustoiminnon sulkeuduttua.

1. Vahvista, että palvelu on olemassa. lehdistö Win + R, tyyppi services.mscja paina Enter-näppäintä. Etsi merkintä nimeltä Jenkins ja varmista, että tila on Running ja käynnistystyyppi lukee automaattisesti.
2. Tarkista käytössä oleva tili. Avaa kohteen ominaisuudet Jenkins palvelu ja tarkista Kirjaudu Päällä välilehti. Dedikoitu palvelutili on LocalSystemiä parempi vaihtoehto kaikessa muussa kuin paikallisessa kokeilussa.
3. Tarkista kuunteluportti. ajaa netstat -ano | findstr :8080 komentokehotteesta. LISTENING-merkintä vahvistaa, että Jenkins pitää satamaa hallussaan.
4. Lue versiotiedot. Kirjaudu sisään osoitteessa http://localhost:8080 ja lue versionumero kojelaudan oikeasta alakulmasta. Vertaa sitä lataamaasi julkaisuun.
5. Käynnistä uudelleen kerran. Käynnistä uudelleen Windows ja selaa uudelleen kojelautaan käynnistämättä mitään manuaalisesti. Jos sivu latautuu, palvelu on aidosti automaattinen.

Palvelua voidaan ohjata myös komentokehotteesta, joka on nopeampi kuin graafinen konsoli ja toimii hyvin käyttöönottoskriptien sisällä:

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

💡 Vinkki: Hiljainen asentaja hyväksyy INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAMEja SERVICE_PASSWORD ominaisuuksina ohittaa ne. Kaikki välittämättä jätetyt arvot palautuvat oletusarvoonsa, ja hiljaisessa tilassa palvelu toimii nimellä LocalSystem, ellei palvelutiliä ole annettu.

Jos jokin näistä tarkistuksista epäonnistuu, syyt ovat yleensä ennustettavissa, kuten seuraava osio osoittaa.

Yhteinen Jenkins Asennusvirheet kohdassa Windows ja kuinka korjata ne

Eniten epäonnistuneita Windows asennus tractakaisin pieneen joukkoon syitä: tuematon Java ajonaikainen, varattu portti tai palvelutili, jolta puuttuu oikeudet kirjautua palveluna. Jokainen näistä aiheuttaa erillisen oireen, joten korjaus on yleensä nopea, kun viesti on luettu huolellisesti.

• Virheelliset palvelun kirjautumistiedot: Asentaja hylkää tilin asentamisen aikana. Testitiedot askel. Avaa secpol.msc, laajenna Paikalliset käytännöt > Käyttäjäoikeuksien määrittäminen, avoin Kirjaudu palvelunaja lisää tili. Yritä sitten tunnistetietojen testausta uudelleen.
• Portti 8080 on jo käytössä: Testiportti painike muuttuu punaiseksi, koska toinen sovellus, usein paikallinen Tomcat tai kehityspalvelin, pitää jo porttia hallussaan. Valitse vapaa portti, kuten 8081, tai pysäytä ristiriitainen prosessi, jonka tunnistaa netstat -ano.
• Ei tuettu tai puuttuu Java: Asentaja ei voi täyttää valmiiksi Java kotihakemistoon, tai palvelu käynnistyy ja pysähtyy välittömästi. Asenna 64-bittinen JDK 21 tai uudempi ja osoita asennusohjelma sen kotihakemistoon.
• SmartScreen estää asentajan: Windows ilmoittaa tunnistamattomasta sovelluksesta. Valitse Lisätietoja, sitten Suorita siltivahvistettuaan tiedoston tulleen viralliselta taholta Jenkins lataussivu.
• initialAdminPassword-tiedostoa ei löydy: Valittiin mukautettu asennushakemisto. Katso hakemiston sisältä. secrets kyseisen hakemiston kansio tai lue salasana jenkins.err.log vuonna Jenkins kotihakemisto.

Kerran Jenkins toimii luotettavasti, seuraava luonnollinen vaihe on yhdistää se lähdekooditietovarastoon ja koontiputkeen. Läpikäynnit osoitteessa Jenkins GitHub-integraatio ja CI/CD-putki Selitä, miten jatkuva integraatio kootaan tämän asennuksen ympärille.

UKK