Gostovanje Jenkins na Managed VPS pomeni, da svoje projekte gradite, preizkušate in uvajate z lastnega stroja, ki ga naše ekipe posodabljajo in podnevi in ponoči spremljajo. Jenkins je prosta programska oprema pod licenco MIT. Ta vodnik sledi njegovi uradni dokumentaciji: izbira izdaje LTS, namestitev z Docker Compose ali paketi Linux, HTTPS in URL Jenkins, agenti, dovoljenja, vtičniki, varnostne kopije in nadgradnje.
Avtor: Simon Vasconcelos Lee
Objavljeno 16. novembra 2026Čas branja: 15 minut
jenkins/jenkins in njenimi oznakami lts ali s paketi Linux projekta, za obratnim posredniškim strežnikom s HTTPS; ta naslov nato nastavite kot URL Jenkins.JENKINS_HOME, secrets/master.key hranite ločeno in vodnik za nadgradnjo vsake LTS preberite, preden jo uvedete.Jenkins se opisuje kot vodilni odprtokodni strežnik za avtomatizacijo. Zgrajen v Javi ponuja več kot 2.000 vtičnikov za avtomatizacijo skoraj česar koli. README našteva njegove najpogostejše rabe: gradnjo projektov, izvajanje preizkusov za odkrivanje napak takoj, ko se pojavijo, statično analizo kode in uvajanje.
Jenkinsfile, ki jo dokumentacija priporoča shraniti v sistem za upravljanje izvorne kode projekta.Jenkins je objavljen pod licenco MIT. Ta dovoljuje uporabo, kopiranje, spreminjanje, združevanje, objavo, razširjanje, podlicenciranje in prodajo programske opreme, pod enim pogojem: obvestilo o avtorskih pravicah in besedilo licence ohranite v vsaki kopiji. Jenkins torej lahko poganjate v svojem podjetju, za svoje projekte in za projekte svojih strank, ne da bi morali kupiti licenco.
Licenca pokriva kodo. Ime „Jenkins“ je registrirana blagovna znamka LF Charities, Inc., organizacije, povezane s fundacijo Linux Foundation, projekt pa uporablja pravilnik o blagovnih znamkah fundacije Linux Foundation. Ta pravilnik velja za vsakogar, ki besedo vključi v ime lastnega izdelka ali storitve, in v ta namen predlaga oblike, kot je „vaš izdelek for Jenkins“: preberite ga, če okoli programske opreme gradite ponudbo. Navajanje imena Jenkins za njegov opis, kot v tem vodniku, je poštena raba.
Ta objava je neodvisna od projekta Jenkins, LF Charities, Inc. in fundacije Linux Foundation ter z njimi ni povezana, niti jo sponzorirajo ali odobravajo.
Jenkins izhaja v dveh linijah. Tedenska izdaja vsak teden prinaša nove funkcije in popravke. Linija LTS, za Long-Term Support, izhaja iz tedenske izdaje, ki se vsakih 12 tednov izbere za osnovo, nato pa prejema prenesene popravke. Dokumentacija oznake LTS slike Docker predstavlja kot stabilnejšo izdajo, pripravljeno za produkcijo: to izdajo namesti ta vodnik.
| Linija | Na dan 8. novembra 2026 | Ritem |
|---|---|---|
| LTS | 2.580.2 z dne 28. oktobra 2026, po 2.580.1 z dne 30. septembra | Tri izdaje na osnovo, .1, .2 in .3, vsaka po dveh tednih prenašanja popravkov in dveh tednih preizkušanja |
| Tedenska | 2.589 | Ena izdaja na teden |
LTS 2.580.2 zahteva Java 21 ali Java 25: s katero koli drugo različico krmilnik ne deluje. Projekt namerava podporo za Java 21 končati septembra 2027, za Java 25 pa septembra 2029. Zahteva velja za ves sistem, krmilnik, agente in ukazno vrstico; vaši projekti sami se gradijo s tisto različico Jave, ki jim ustreza.
Dokumentacija priporoča uradno sliko jenkins/jenkins. Oznaka lts sledi LTS na Java 21, lts-jdk25 isti LTS na Java 25, latest pa tedenski izdaji. Na strežniku z nameščenim Dockerjem ustvarite mapo in vanjo postavite ta compose.yaml, povzet po primeru Caddy iz dokumentacije: Caddy sprejema obiskovalce na vratih 80 in 443, pridobi potrdilo HTTPS in jih posreduje programu Jenkins, ki je dosegljiv le v notranjem omrežju.
services:
jenkins:
image: jenkins/jenkins:lts-jdk25
container_name: jenkins
restart: unless-stopped
volumes:
- jenkins_home:/var/jenkins_home
expose:
- "8080"
networks:
- web
caddy:
image: caddy:2
container_name: caddy
restart: unless-stopped
depends_on:
- jenkins
ports:
- "80:80"
- "443:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/config
networks:
- web
networks:
web:
driver: bridge
volumes:
jenkins_home:
caddy_data:
caddy_config:
jenkins.example.com {
encode zstd gzip
reverse_proxy jenkins:8080
}
docker compose up -d
/var/jenkins_home: tam živijo vsi podatki, vključno z vtičniki in konfiguracijo. README slike ta nosilec raje uporablja kot mapo na gostitelju, ki lahko povzroči težave z dovoljenji: uporabnik jenkins v vsebniku ima ID 1000.web. Vrata 50000 uporabljajo dohodni agenti TCP; agenti WebSocket in SSH jih ne potrebujejo, zato tukaj niso objavljena.2.580.2-lts-jdk25, določi različico, lts-jdk25 pa sledi trenutni LTS.Dokumentacija določa najmanj 256 MB pomnilnika in 1 GB diska, vsaj 10 GB v vsebniku Docker, za majhno ekipo pa priporoča 4 GB pomnilnika ali več in 50 GB diska ali več. Pojasnjuje, da pomnilnik krmilnika sega od 200 MB za majhno namestitev do več kot 70 GB za največje; vsak povezan agent tam zasede 2 ali 3 niti, približno 2 MB ali več. Večina dela, gradnje, poteka na agentih.
Na Managed VPS nam opišite svoje projekte in kako pogosto gradite: priporočimo vam ustrezno velikost za krmilnik in za agente.
Projekt objavlja tudi pakete za Debian in Ubuntu, Fedoro, Red Hat Enterprise Linux in njegove izpeljanke. Na Debianu ali Ubuntuju najprej namestite Javo: dokumentacija to močno priporoča, saj Jenkins, nameščen pred Javo, ob zagonu morda ne najde veljavne namestitve Jave.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Nato dodajte repozitorij LTS, debian-stable, z njegovim podpisnim ključem, in namestite Jenkins:
sudo wget -O /etc/apt/keyrings/jenkins-keyring.asc \
https://pkg.jenkins.io/debian-stable/jenkins.io-2026.key
echo "deb [signed-by=/etc/apt/keyrings/jenkins-keyring.asc]" \
https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
/etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt update
sudo apt install jenkins
Paket ustvari storitev systemd in uporabnika jenkins, svoj dnevnik pošilja v journald (journalctl -u jenkins.service), podatke hrani v /var/lib/jenkins in posluša na vratih 8080, na vseh vmesnikih. Za posredniškim strežnikom na istem strežniku ga omejite na lokalni naslov s sudo systemctl edit jenkins, nato sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Ta blok sledi primeru Nginx iz dokumentacije, skrajšanemu na blok location /, obliko, ki jo ta predvideva za primer, ko Nginx sam ne bere datotek programa Jenkins:
upstream jenkins {
keepalive 32;
server 127.0.0.1:8080;
}
map $http_upgrade $connection_upgrade {
default upgrade;
'' '';
}
server {
listen 80;
server_name jenkins.example.com;
ignore_invalid_headers off;
location / {
sendfile off;
proxy_pass http://jenkins;
proxy_redirect default;
proxy_http_version 1.1;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_max_temp_file_size 0;
client_max_body_size 10m;
client_body_buffer_size 128k;
proxy_connect_timeout 90;
proxy_send_timeout 90;
proxy_read_timeout 90;
proxy_request_buffering off;
}
}
proxy_pass brez končne poševnice: dokumentacija opozarja, da končna poševnica v tej vrednosti povzroča težave.Upgrade in Connection služita agentom WebSocket, map pa ohranja povezave žive za preostali promet.proxy_request_buffering off je obvezen za ukaze ukazne vrstice Jenkins, poslane prek HTTP.client_max_body_size določa največjo velikost nalaganja, v primeru 10 MB.Certbot nato namesti potrdilo in poskrbi za njegovo obnavljanje:
sudo certbot --nginx
Ko je Jenkins na spletu, nastavite njegov javni naslov, na primer https://jenkins.example.com/, v Manage Jenkins, System, v razdelku Jenkins Location. Jenkins ga uporablja za vse naslove, ki jih ustvari, v vmesniku in v datotekah agentov, ter za komunikacijo z agenti in zunanjimi orodji. Možnosti vrat na to ne vplivajo: šteje ta URL.
Jenkins nadzira lasten obratni posredniški strežnik. Če prikaže „It appears that your reverse proxy setup is broken“, najprej preverite, da se ta URL ujema z naslovom, ki ga uporabljate, nato da posredniški strežnik pošilja X-Forwarded-Proto, ko prejme HTTPS, in s programom Jenkins govori prek HTTP, kot to počneta oba primera v tem vodniku.
Če Jenkins strežete pod potjo, kot je /jenkins, namesto pod lastnim imenom domene, mora to pot poznati: --prefix=/jenkins, prek JENKINS_OPTS z Dockerjem ali JENKINS_PREFIX s paketi. Dokumentacija priporoča isto pot na obeh straneh, saj njeno prepisovanje v posredniškem strežniku pomeni popravljanje zelo veliko naslovov.
Ob prvem dostopu Jenkins zahteva samodejno ustvarjeno geslo, ki ga zapiše v svoj dnevnik in v secrets/initialAdminPassword. Odprite svoj naslov HTTPS, nato ga preberite:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin kot geslo obdrži geslo za odklepanje.Čarovnik pusti strategijo pooblaščanja „Logged-in users can do anything“: vsak prijavljen račun ima vse pravice. Ustreza vam, dokler imajo račun le osebe, ki jim povsem zaupate. Preden odprete več računov, preidite na varnost na podlagi matrike, opisano v nadaljevanju.
Gradnja izvaja ukaze, ki jih nadzirajo tudi drugi, ne le skrbnik: skripti za gradnjo, preizkusi, koda vsake potrditve. Na vgrajenem vozlišču imajo ti ukazi enak dostop do datotečnega sistema krmilnika kot sam Jenkins. Dokumentacija zato priporoča, da na vgrajenem vozlišču ne poganjate nobenih gradenj in jih prepustite agentom, kar procesor in pomnilnik krmilnika ohrani tudi za njegovo lastno delo.
| Povezava | Kako | Na strani omrežja |
|---|---|---|
| SSH | Krmilnik se poveže z agentom, z vtičnikom SSH Build Agents | Na krmilniku ni treba odpreti nobenih vrat |
| WebSocket | Agent se s krmilnikom poveže prek njegovega naslova HTTPS, od Jenkins 2.217 | Brez dodatnih vrat: posredniški strežnik posreduje WebSocket |
| Dohodni TCP | Agent se s krmilnikom poveže na namenskih vratih TCP | Stalna vrata, ki jih je treba odpreti in objaviti, v sliki Docker 50000 |
Dokumentacija svetuje splošne, zamenljive agente, pripravljene z orodjem za upravljanje konfiguracije, vnaprej pripravljeno sliko ali vsebnikom: agenta, ki odpove, je nato mogoče brez truda zamenjati. Pri enem samem strežniku predlaga agenta, ki teče kot drug uporabnik operacijskega sistema, brez dostopa za branje ali pisanje do JENKINS_HOME in brez sudo. Na Managed VPS lahko vlogo agenta prevzame tudi drug VPS, dimenzioniran za vaše gradnje.
Nadzor dostopa od agenta do krmilnika, ki ogroženemu agentu preprečuje pošiljanje ukazov krmilniku, je od Jenkins 2.326 vedno vključen.
Jenkins loči overjanje, ki ugotovi, kdo ste, od pooblaščanja, ki pove, kaj smete. Njegova vgrajena zbirka uporabnikov, privzeto vključena, ustreza majhnim ekipam; LDAP, Active Directory, SAML ali OpenID Connect se priključijo prek vtičnikov. Za pooblaščanje dokumentacija opisuje te strategije:
| Strategija | Kaj dodeli | Kdaj jo izbrati |
|---|---|---|
| Anyone can do anything | Vse pravice, tudi anonimnim obiskovalcem | Le za lokalni preizkus |
| Logged-in users can do anything | Vse pravice vsakemu prijavljenemu računu; nastavitev, ki jo pusti čarovnik | Dokler imajo račun le osebe, ki jim povsem zaupate |
| Matrix-based security | Dovoljenja, dodeljena po uporabnikih ali skupinah | Izhodišče, ki ga dokumentacija priporoča za produkcijo |
| Project-based Matrix Authorization Strategy | Ista matrika, razširjena projekt za projektom | Za rezervacijo nekaterih projektov za nekatere osebe |
Obe strategiji z matriko izhajata iz vtičnika Matrix Authorization Strategy, ki je med vtičniki, ki jih predlaga čarovnik. V matriki vrsticama anonymous in authenticated dodelite malo: Overall/Administer, dodeljen authenticated, je enakovreden „Logged-in users can do anything“. Enako previdni bodite, če odprete samoregistracijo ali ponudnika identitete, pri katerem lahko račun ustvari vsakdo.
JENKINS_HOME šifrirani s ključi iz mape secrets, ki jo razdelek o varnostnih kopijah obravnava posebej.Vtičniki so tisto, kar Jenkins naredi tako vsestranskega, in vsak od njih je koda, ki teče v krmilniku. Jenkins središče za posodobitve preveri enkrat na 24 ur; posodobitve se pojavijo v zavihku Updates v Manage Jenkins, Plugins in začnejo veljati po ponovnem zagonu. Gumb Check now vsili preverjanje.
Z Dockerjem lahko iz jenkins/jenkins zgradite tudi lastno sliko in vanjo namestite svoje vtičnike z jenkins-plugin-cli, iz seznama plugins.txt, ki določa njihove različice in ga orodje zna posodobiti. README slike opisuje to metodo.
Obvestila o gradnjah gredo prek vtičnika Mailer: neuspela gradnja, uspeh po neuspehu ali gradnja, ki postane nestabilna, sproži e-poštno sporočilo. Strežnik za pošiljanje se nastavi v Manage Jenkins, System, v razdelku E-mail Notification.
Na VPS Simafri pošiljanje poteka prek overjenega releja SMTP, na vratih 587: z naslovom poštnega računa, ki ga že imate, ali s Simafri Suite. V naprednih možnostih označite Use SMTP Authentication z uporabniškim imenom in geslom računa, nato Use TLS: vtičnik nato uporabi vrata 587. Možnost Test configuration by sending test e-mail pošlje preizkusno sporočilo.
Dokumentacija varnostne kopije krmilnika označuje za ključnega pomena: služijo obnovi po nesreči, povrnitvi pomotoma spremenjene konfiguracije ali datoteke, ki je bila poškodovana ali izbrisana. Vse živi v JENKINS_HOME: /var/jenkins_home v sliki Docker, /var/lib/jenkins s paketi.
| Element | Kaj hrani | Varnostna kopija |
|---|---|---|
*.xml, vključno s config.xml | Glavno konfiguracijo in konfiguracijo sistema | Obvezno |
jobs/ | Opravila in zgodovino gradenj; v builds/archive arhivirane artefakte | Obvezno; artefakte po potrebi, ker so obsežni |
plugins/*.jpi | Nameščene vtičnike, v njihovih različicah | Priporočeno, za enako obnovo |
secrets/ | Ključe, ki šifrirajo dostopne podatke | Mapo, razen master.key, ki se hrani ločeno |
workspace/ | Datoteke, prevzete iz sistema za upravljanje izvorne kode za gradnje | Neobvezno: nov prevzem jih ustvari znova |
war/, cache/, tools/ | Razširjeno datoteko WAR, prenesena in razpakirana orodja | Neobvezno: ustvarijo se znova po potrebi |
Dokumentacija prosi, naj glavnega ključa nikoli ne vključite v redno varnostno kopijo. secrets/master.key šifrira ključ, ki ščiti vaše dostopne podatke: kdor ima vaše varnostne kopije in ta ključ, lahko prebere vse. Kopirajte ga enkrat in ga hranite ločeno na zelo varnem mestu, kot zasebni ključ SSH; popolna obnova ga potrebuje.
README slike prosi, naj jenkins_home obravnavate kot podatkovno zbirko. Med kopiranjem Jenkins ustavite, nato nosilec arhivirajte z začasnim vsebnikom, po metodi iz dokumentacije Dockerja:
docker compose stop jenkins
docker run --rm --volumes-from jenkins -v "$(pwd)":/backup ubuntu \
tar -czf /backup/jenkins_home-$(date +%F).tar.gz --exclude=./secrets/master.key -C /var/jenkins_home .
docker compose start jenkins
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key
sudo systemctl stop jenkins
sudo tar -czf jenkins_home-$(date +%F).tar.gz --exclude=./secrets/master.key -C /var/lib/jenkins .
sudo systemctl start jenkins
Kopija, narejena z ustavljeno storitvijo, je dosledna. Za varnostno kopiranje brez ustavitve dokumentacija napotuje na posnetke datotečnega sistema, LVM, btrfs ali ZFS, ki so doslednejši in hitrejši od kopije med delovanjem; med odprtokodnimi vtičniki za varnostno kopiranje kot edinega, ki se še vzdržuje, navaja thinBackup. Vsaki kopiji dajte ime s časovnim žigom, izogibajte se /tmp, ki se ob ponovnem zagonu lahko počisti, dokončane kopije pa pošljite na oddaljeni strežnik.
Shranjeni na disku strežnika ti arhivi vstopijo tudi v njegove nočne varnostne kopije.
Dokumentacija prosi, naj preverite vsako varnostno kopijo, in navaja preprosto metodo: obnovite jo v začasno mapo, vrnite master.key in na njej zaženite drug Jenkins iste različice, na drugih vratih:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Pred vsako nadgradnjo jedra preberite stran ciljne LTS v vodnikih za nadgradnjo projekta: vsak razdelek pokriva nadgradnjo s prejšnje LTS. Za 2.580.2 ne navaja nobenih pomembnih sprememb. Za 2.580.1 navaja, da več vtičnikov, ločenih od jedra, ni več priloženih datoteki WAR: Jenkins jih namesti sam, ko je središče za posodobitve dosegljivo. Nato varnostno kopirajte JENKINS_HOME in nadgradite:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Samostojno gostovanje poleg aplikacije zahteva tudi vzdrževanje strežnika. Na Managed VPS naše ekipe prevzamejo strežnik in proaktivno spremljajo vašo instanco; Jenkins ostaja vaša programska oprema, z vašimi cevovodi, nastavitvami in podatki.
| Tema | Naše ekipe | Vi |
|---|---|---|
| Strežnik | Posodobitve sistema in varnosti, vključno s posegi na strežniku | Trenutek, ki ustreza vaši dejavnosti |
| Nadzor | Strežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klic | Branje dnevnikov vaše instance in vaših gradenj |
| Jenkins | Proaktivno spremljanje: napake, upočasnitve in prostor na disku, s priporočenim popravkom | Namestitev, posodobitve, vtičniki in nastavitve, ki jih uvedete vi ali vaš AI pomočnik |
| Cevovodi in agenti | Strežniki, ki jih nosijo, pod nadzorom in varnostno kopirani | Opravila, agenti, računi, dovoljenja in dostopni podatki |
| Varnostne kopije | Vsako noč, šifrirane in shranjene zunaj stroja; obnova je vključena | Arhivi, značilni za Jenkins, datoteka master.key in zahteva za obnovo, ko jo potrebujete |
| Selitev | Selitev vašega sedanjega strežnika, brezplačno | Trenutek preklopa |
Če želite, da naše ekipe posežejo v samo aplikacijo, se ta storitev zaračuna po urah ali pavšalno, z oceno stroškov, sporočeno pred posegom.
Z Managed VPS Simafri naše ekipe strežnik vaše instance Jenkins sproti posodabljajo, ga podnevi in ponoči nadzirajo ter posežejo brez čakanja na vaš klic; vašo instanco tudi proaktivno spremljajo in vam priporočajo koristne popravke, ki jih uvedete vi ali vaš AI pomočnik. Varnostne kopije so vsako noč šifrirane in shranjene zunaj stroja, njihova obnova je vključena, selitev vašega sedanjega strežnika pa je brezplačna.
Da. Jenkins je pod licenco MIT: v podjetju ga lahko uporabljate, spreminjate in poganjate, ne da bi morali kupiti licenco, če ohranite njegovo obvestilo o avtorskih pravicah in licenci. Ostane le strošek strežnikov, ki nosijo krmilnik in agente.
Linijo LTS, ki jo dokumentacija predstavlja kot pripravljeno za produkcijo: 2.580.2 na dan 28. oktobra 2026. Zahteva Java 21 ali Java 25. Nova osnova LTS se izbere vsakih 12 tednov, vsaka osnova pa prejme tri izdaje s popravki.
Uporabite uradno sliko jenkins/jenkins z oznako LTS, kot je lts-jdk25, in poimenovan nosilec, priklopljen na /var/jenkins_home. Pred njo postavite obratni posredniški strežnik s HTTPS, na primer Caddy v isti datoteki compose.yaml, nato javni naslov nastavite kot URL Jenkins.
V dnevniku zagona in v datoteki secrets/initialAdminPassword v JENKINS_HOME: /var/jenkins_home s sliko Docker, /var/lib/jenkins s paketi. Prilepite ga na stran Unlock Jenkins, nato ustvarite svoj skrbniški račun.
Dokumentacija priporoča, da jih poganjate na agentih: na vgrajenem vozlišču ima gradnja enak dostop do datotek krmilnika kot Jenkins. Povežite agenta, prek SSH ali WebSocket, nato izvajalce vgrajenega vozlišča nastavite na 0.
Strežite jo prek HTTPS za obratnim posredniškim strežnikom, preidite na varnost na podlagi matrike, Overall/Administer rezervirajte za osebe, ki jim zaupate, zaščito CSRF pustite vključeno, gradnje poganjajte na agentih in hitro uvajajte izdaje LTS z varnostnimi popravki.
Arhivirajte JENKINS_HOME, z ustavljeno storitvijo ali s posnetkom datotečnega sistema. secrets/master.key izločite iz te varnostne kopije in ga hranite ločeno na zelo varnem mestu, vsako varnostno kopijo pa preverite z obnovo na preizkusnem programu Jenkins, zagnanem na drugih vratih.
Managed VPS pokriva strežnik: sistem, varnost, nadzor in varnostne kopije. Naše ekipe proaktivno spremljajo tudi vašo instanco in vam priporočajo koristne popravke, ki jih uvedete vi. Poseg v aplikacijo se zaračuna po urah ali pavšalno.
Simafri
Pogovorimo se o vašem projektu
Povejte nam v nekaj besedah, kaj potrebujete: hitro se vam oglasimo.
Hvala! Vaše povpraševanje je bilo poslano. Kmalu vam bomo odgovorili.
Imate raje e-pošto? Pišite nam na support@simafri.com.