Hostovanie Jenkins na Managed VPS znamená zostavovať, testovať a nasadzovať svoje projekty z vlastného stroja, ktorý naše tímy udržiavajú aktuálny a dohliadajú naň vo dne v noci. Jenkins je slobodný softvér pod licenciou MIT. Tento sprievodca postupuje podľa jeho oficiálnej dokumentácie: výber vydania LTS, inštalácia cez Docker Compose alebo balíky pre Linux, HTTPS a URL Jenkinsu, agenti, oprávnenia, pluginy, zálohy a aktualizácie.
Autor: Simon Vasconcelos Lee
Publikované 16. novembra 2026Čas čítania: 15 minút
jenkins/jenkins a jeho značiek lts alebo z balíkov projektu pre Linux, za reverznou proxy s HTTPS; túto adresu potom nastavte ako URL Jenkinsu.JENKINS_HOME, súbor secrets/master.key uchovávajte osobitne a pred použitím každého LTS si prečítajte jeho príručku aktualizácie.Jenkins sa opisuje ako popredný otvorený automatizačný server. Je postavený na Jave a ponúka viac než 2 000 pluginov na automatizáciu prakticky čohokoľvek. README uvádza jeho najčastejšie použitia: zostavovanie projektov, spúšťanie testov na odhalenie chýb hneď, ako sa objavia, statickú analýzu kódu a nasadzovanie.
Jenkinsfile, ktorý dokumentácia odporúča ukladať do správy zdrojového kódu projektu.Jenkins vychádza pod licenciou MIT. Umožňuje používať, kopírovať, upravovať, zlučovať, zverejňovať, šíriť, poskytovať sublicencie a predávať softvér pod jednou podmienkou: zachovať upozornenie o autorských právach a text licencie v každej kópii. Jenkins teda môžete prevádzkovať vo svojej firme, pre svoje projekty aj projekty svojich klientov, bez licencie, ktorú by ste museli kupovať.
Licencia sa vzťahuje na kód. Názov „Jenkins“ je registrovaná ochranná známka spoločnosti LF Charities, Inc., organizácie spojenej s Linux Foundation, a projekt uplatňuje politiku ochrannej známky Linux Foundation. Táto politika sa týka každého, kto dáva toto slovo do názvu vlastného produktu alebo služby, a navrhuje na to tvary ako „váš produkt for Jenkins“: prečítajte si ju, ak budujete ponuku okolo tohto softvéru. Uvádzať Jenkins na jeho opis, ako to robí tento sprievodca, je férové použitie.
Táto publikácia je nezávislá od projektu Jenkins, spoločnosti LF Charities, Inc. a Linux Foundation: nie je s nimi prepojená, nie je nimi sponzorovaná ani schválená.
Jenkins vychádza v dvoch líniách. Týždenné vydanie prináša každý týždeň nové funkcie a opravy. Línia LTS, z anglického Long-Term Support, vychádza z týždenného vydania vybraného každých 12 týždňov ako jej základ a potom dostáva spätne prenesené opravy. Dokumentácia predstavuje značky LTS obrazu Docker ako stabilnejšie vydanie pripravené na produkciu: práve to tento sprievodca inštaluje.
| Línia | K 8. novembru 2026 | Tempo |
|---|---|---|
| LTS | 2.580.2 z 28. októbra 2026, po 2.580.1 z 30. septembra | Tri vydania na základ, .1, .2 a .3, každé po dvoch týždňoch spätného prenosu a dvoch týždňoch testovania |
| Týždenné | 2.589 | Jedno vydanie týždenne |
LTS 2.580.2 vyžaduje Java 21 alebo Java 25: s inou verziou riadiaci server nebeží. Projekt plánuje ukončiť podporu Java 21 v septembri 2027 a Java 25 v septembri 2029. Požiadavka platí pre celý systém, riadiaci server, agentov aj príkazový riadok; vaše projekty sa samy zostavujú s verziou Javy, ktorá im vyhovuje.
Dokumentácia odporúča oficiálny obraz jenkins/jenkins. Značka lts sleduje LTS na Java 21, lts-jdk25 to isté LTS na Java 25 a latest týždenné vydanie. Na serveri s nainštalovaným Dockerom vytvorte priečinok a umiestnite doň tento súbor compose.yaml, prevzatý z príkladu pre Caddy v dokumentácii: Caddy prijíma návštevníkov na portoch 80 a 443, získa certifikát HTTPS a odovzdáva Jenkinsu, ktorý je dostupný len vo vnútornej sieti.
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: sú v ňom všetky údaje, vrátane pluginov a konfigurácie. README obrazu ho uprednostňuje pred priečinkom na hostiteľovi, ktorý môže spôsobiť problémy s oprávneniami: používateľ jenkins v kontajneri má ID 1000.web. Port 50000 používajú prichádzajúci agenti TCP; agenti WebSocket a SSH sa bez neho zaobídu, preto tu nie je publikovaný.2.580.2-lts-jdk25 verziu zafixuje, zatiaľ čo lts-jdk25 sleduje aktuálne LTS.Dokumentácia stanovuje minimum 256 MB pamäte a 1 GB disku, aspoň 10 GB v kontajneri Docker, a pre malý tím odporúča 4 GB pamäte alebo viac a 50 GB disku alebo viac. Vysvetľuje, že pamäť riadiaceho servera sa pohybuje od 200 MB pri malej inštalácii po viac než 70 GB pri tých najväčších; každý pripojený agent v ňom zaberá 2 alebo 3 vlákna, približne 2 MB alebo viac. Väčšina práce, samotné buildy, beží na agentoch.
Na spravovanom VPS (Managed VPS) nám opíšte svoje projekty a to, ako často zostavujete: odporučíme vám vhodnú veľkosť pre riadiaci server aj pre agentov.
Projekt zverejňuje aj balíky pre Debian a Ubuntu, Fedoru, Red Hat Enterprise Linux a jeho deriváty. Na Debiane alebo Ubuntu najprv nainštalujte Javu: dokumentácia to dôrazne odporúča, pretože Jenkins nainštalovaný pred Javou nemusí pri štarte nájsť platnú inštaláciu Javy.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Potom pridajte repozitár LTS, debian-stable, s jeho podpisovým kľúčom a nainštalujte 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
Balík vytvorí službu systemd a používateľa jenkins, posiela svoj záznam do journald (journalctl -u jenkins.service), uchováva údaje v /var/lib/jenkins a počúva na porte 8080, na všetkých rozhraniach. Za proxy na tom istom serveri ho obmedzte na lokálnu adresu príkazom sudo systemctl edit jenkins a potom sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Tento blok preberá príklad Nginx z dokumentácie, zredukovaný na blok location /, teda tvar, ktorý dokumentácia uvádza pre prípad, keď Nginx sám nečíta súbory Jenkinsu:
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 bez koncovej lomky: dokumentácia upozorňuje, že lomka na konci tejto hodnoty spôsobuje problémy.Upgrade a Connection slúžia agentom WebSocket a map udržiava pripojenia aktívne pre zvyšok prenosu.proxy_request_buffering off je potrebné pre príkazy príkazového riadka Jenkinsu posielané cez HTTP.client_max_body_size nastavuje maximálnu veľkosť nahrávaného súboru, v príklade 10 MB.Certbot potom nainštaluje certifikát a postará sa o jeho obnovu:
sudo certbot --nginx
Keď je Jenkins online, nastavte jeho verejnú adresu, napríklad https://jenkins.example.com/, v Manage Jenkins, System, v časti Jenkins Location. Jenkins ju používa pre všetky adresy, ktoré generuje, v rozhraní aj v súboroch agentov, a na komunikáciu s agentmi a externými nástrojmi. Voľby portov na tom nič nemenia: rozhoduje táto URL.
Jenkins sleduje svoju vlastnú reverznú proxy. Ak zobrazí „It appears that your reverse proxy setup is broken“, najprv overte, že táto URL zodpovedá adrese, ktorú používate, a potom, že proxy posiela X-Forwarded-Proto, keď prijíma HTTPS, a s Jenkinsom komunikuje cez HTTP, ako to robia oba príklady v tomto sprievodcovi.
Ak sa Jenkins obsluhuje pod cestou ako /jenkins namiesto vlastného doménového mena, musí túto cestu poznať: --prefix=/jenkins, cez JENKINS_OPTS s Dockerom alebo JENKINS_PREFIX s balíkmi. Dokumentácia odporúča rovnakú cestu na oboch stranách, pretože jej prepisovanie v proxy znamená opravovať veľké množstvo adries.
Pri prvom prístupe si Jenkins vypýta automaticky vygenerované heslo, ktoré zapíše do svojho záznamu a do secrets/initialAdminPassword. Otvorte svoju adresu HTTPS a potom si ho prečítajte:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin zostane ako heslo heslo na odomknutie.Sprievodca ponechá stratégiu autorizácie „Logged-in users can do anything“: každý prihlásený účet má plné práva. Vyhovuje vám, pokiaľ majú účet len ľudia, ktorým úplne dôverujete. Skôr než otvoríte ďalšie účty, prejdite na maticové zabezpečenie opísané nižšie.
Build spúšťa príkazy, ktoré ovládajú aj iní ľudia než správca: skripty zostavenia, testy, kód každého commitu. Na zabudovanom uzle majú tieto príkazy rovnaký prístup k súborovému systému riadiaceho servera ako samotný Jenkins. Dokumentácia preto odporúča nespúšťať na zabudovanom uzle žiadne buildy a odovzdať ich agentom, čím zároveň procesor a pamäť riadiaceho servera zostanú pre jeho vlastnú prácu.
| Pripojenie | Ako | Zo strany siete |
|---|---|---|
| SSH | Riadiaci server sa pripája k agentovi pomocou pluginu SSH Build Agents | Na riadiacom serveri netreba otvárať žiadny port |
| WebSocket | Agent sa pripája k riadiacemu serveru cez jeho adresu HTTPS, od Jenkinsu 2.217 | Žiadny ďalší port: proxy odovzdáva WebSocket |
| Prichádzajúce TCP | Agent sa pripája k riadiacemu serveru na vyhradenom porte TCP | Pevný port, ktorý treba otvoriť a publikovať, v obraze Docker 50000 |
Dokumentácia radí používať generických, zameniteľných agentov, pripravených nástrojom na správu konfigurácie, vopred pripraveným obrazom alebo kontajnerom: agenta, ktorý vypadne, potom bez námahy nahradíte. Pri jedinom serveri navrhuje agenta bežiaceho pod iným používateľom operačného systému, bez prístupu na čítanie a zápis do JENKINS_HOME a bez sudo. Na Managed VPS môže ako agent slúžiť aj druhý VPS, dimenzovaný pre vaše buildy.
Kontrola prístupu od agenta k riadiacemu serveru, ktorá bráni napadnutému agentovi posielať riadiacemu serveru príkazy, je od Jenkinsu 2.326 vždy zapnutá.
Jenkins oddeľuje overenie, ktoré zisťuje, kto ste, od autorizácie, ktorá určuje, čo smiete robiť. Jeho zabudovaná databáza používateľov, predvolene zapnutá, vyhovuje malým tímom; LDAP, Active Directory, SAML alebo OpenID Connect sa pripájajú cez pluginy. Pre autorizáciu dokumentácia opisuje tieto stratégie:
| Stratégia | Čo udeľuje | Kedy ju zvoliť |
|---|---|---|
| Anyone can do anything | Plné práva, aj anonymným návštevníkom | Len na lokálny test |
| Logged-in users can do anything | Plné práva každému prihlásenému účtu; nastavenie, ktoré ponechá sprievodca | Pokiaľ majú účet len ľudia, ktorým úplne dôverujete |
| Matrix-based security | Oprávnenia pridelené jednotlivým používateľom alebo skupinám | Východisko, ktoré dokumentácia odporúča pre produkciu |
| Project-based Matrix Authorization Strategy | Tá istá matica, rozšírená projekt po projekte | Na vyhradenie niektorých projektov niektorým ľuďom |
Obe maticové stratégie pochádzajú z pluginu Matrix Authorization Strategy, ktorý patrí medzi pluginy navrhované sprievodcom. V matici udeľte málo riadkom anonymous a authenticated: Overall/Administer udelené authenticated sa rovná „Logged-in users can do anything“. Rovnako opatrne postupujte, ak otvoríte samoregistráciu alebo poskytovateľa identity, u ktorého si účet môže vytvoriť ktokoľvek.
JENKINS_HOME šifrované kľúčmi z priečinka secrets, ktorým sa časť o zálohách venuje osobitne.Pluginy robia Jenkins taký všestranným a každý z nich je kód, ktorý beží vnútri riadiaceho servera. Jenkins kontroluje Update Center raz za 24 hodín; aktualizácie sa zobrazujú na karte Updates v Manage Jenkins, Plugins a prejavia sa po reštarte. Tlačidlo Check now vynúti kontrolu.
S Dockerom si tiež môžete zostaviť vlastný obraz z jenkins/jenkins a nainštalovať doň svoje pluginy pomocou jenkins-plugin-cli, zo zoznamu plugins.txt, ktorý pripína ich verzie a ktorý nástroj vie aktualizovať. README obrazu túto metódu opisuje.
Upozornenia na buildy prechádzajú cez plugin Mailer: neúspešný build, úspech po neúspechu alebo build, ktorý sa stane nestabilným, spustí e-mail. Odosielací server sa nastavuje v Manage Jenkins, System, v časti E-mail Notification.
Na VPS Simafri odosielanie prechádza cez overené relé SMTP na porte 587: adresa poštového účtu, ktorý už máte, alebo Simafri Suite. V rozšírených voľbách zaškrtnite Use SMTP Authentication s používateľským menom a heslom účtu a potom Use TLS: plugin potom použije port 587. Voľba Test configuration by sending test e-mail odošle testovaciu správu.
Dokumentácia označuje zálohy riadiaceho servera za kriticky dôležité: slúžia na obnovu po havárii, na obnovu konfigurácie zmenenej omylom alebo súboru, ktorý sa poškodil či odstránil. Všetko je v JENKINS_HOME: /var/jenkins_home v obraze Docker, /var/lib/jenkins s balíkmi.
| Prvok | Čo uchováva | Zálohovať |
|---|---|---|
*.xml, vrátane config.xml | Hlavná konfigurácia a konfigurácia systému | Povinne |
jobs/ | Úlohy a história buildov; v builds/archive archivované artefakty | Povinne; artefakty podľa potreby, sú objemné |
plugins/*.jpi | Nainštalované pluginy v ich verziách | Odporúčané, na identickú obnovu |
secrets/ | Kľúče, ktoré šifrujú prístupové údaje | Priečinok okrem master.key, uchovávaného osobitne |
workspace/ | Súbory načítané zo správy zdrojového kódu pre buildy | Voliteľné: nové načítanie ich znova vytvorí |
war/, cache/, tools/ | Rozbalený súbor WAR, stiahnuté a rozbalené nástroje | Voliteľné: vytvoria sa znova podľa potreby |
Dokumentácia žiada nikdy nedávať hlavný kľúč do bežnej zálohy. secrets/master.key šifruje kľúč, ktorý chráni vaše prístupové údaje: kto má vaše zálohy a tento kľúč, prečíta všetko. Skopírujte ho raz a uložte osobitne na veľmi bezpečné miesto, ako súkromný kľúč SSH; úplná obnova ho potrebuje.
README obrazu žiada zaobchádzať s jenkins_home ako s databázou. Na čas kopírovania Jenkins zastavte a potom zväzok archivujte pomocou dočasného kontajnera, podľa metódy z dokumentácie Docker:
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
Kópia urobená pri zastavenej službe je konzistentná. Na zálohovanie bez zastavenia dokumentácia odkazuje na snímky súborového systému, LVM, btrfs alebo ZFS, ktoré sú konzistentnejšie a rýchlejšie než kopírovanie za behu; spomedzi otvorených pluginov na zálohovanie uvádza thinBackup ako jediný stále udržiavaný. Každej kópii dajte názov s časovou značkou, vyhnite sa /tmp, ktorý sa môže pri reštarte vyčistiť, a hotové kópie posielajte na vzdialený server.
Uložené na disku servera sa tieto archívy dostanú aj do jeho nočných záloh.
Dokumentácia žiada overiť každú zálohu a uvádza jednoduchú metódu: obnovte ju do dočasného priečinka, vráťte doň master.key a spustite na nej druhý Jenkins tej istej verzie, na inom porte:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Pred každou aktualizáciou jadra si prečítajte stránku cieľového LTS v príručkách aktualizácie projektu: každá časť sa venuje aktualizácii z predchádzajúceho LTS. Pre 2.580.2 neuvádza žiadne významné zmeny. Pre 2.580.1 poznamenáva, že viacero pluginov oddelených od jadra už nie je súčasťou súboru WAR: Jenkins ich nainštaluje sám, keď je Update Center dostupné. Potom zálohujte JENKINS_HOME a aktualizujte:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; Jenkins zostáva vaším softvérom, s vašimi pipelinami, nastaveniami a údajmi.
| Téma | Naše tímy | Vy |
|---|---|---|
| Server | Aktualizácie systému a zabezpečenia, vrátane zásahov na serveri | Čas, ktorý vyhovuje vašej činnosti |
| Dohľad | Server sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanie | Čítanie záznamov vašej inštancie a vašich buildov |
| Jenkins | Proaktívne sledovanie: chyby, spomalenia a miesto na disku, s odporúčanou opravou | Jeho inštalácia, aktualizácie, pluginy a nastavenia, ktoré zapracujete vy alebo váš AI asistent |
| Pipeliny a agenti | Servery, ktoré ich nesú, sledované a zálohované | Úlohy, agenti, účty, oprávnenia a prístupové údaje |
| Zálohy | Každú noc, šifrované a uchovávané mimo stroja; obnova je v cene | Archívy špecifické pre Jenkins, súbor master.key a žiadosť o obnovu, keď ju potrebujete |
| Migrácia | Váš súčasný server prenesený zdarma | Čas prepnutia |
Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.
S Managed VPS od Simafri udržiavajú naše tímy server vašej inštancie Jenkins aktuálny, sledujú ho vo dne v noci a zasahujú bez čakania na vaše zavolanie; vašu inštanciu navyše proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy alebo váš AI asistent. Zálohy sa každú noc šifrujú a uchovávajú mimo stroja, ich obnova je v cene a migrácia vášho súčasného servera je zdarma.
Áno. Jenkins vychádza pod licenciou MIT: môžete ho vo firme používať, upravovať a prevádzkovať bez licencie, ktorú by ste museli kupovať, pokiaľ zachováte jeho upozornenie o autorských právach a licencii. Zostáva náklad na servery, ktoré nesú riadiaci server a agentov.
Líniu LTS, ktorú dokumentácia predstavuje ako pripravenú na produkciu: k 28. októbru 2026 je to 2.580.2. Vyžaduje Java 21 alebo Java 25. Nový základ LTS sa vyberá každých 12 týždňov a každý základ dostáva tri opravné vydania.
Použite oficiálny obraz jenkins/jenkins so značkou LTS, napríklad lts-jdk25, a pomenovaný zväzok pripojený na /var/jenkins_home. Pred neho umiestnite reverznú proxy s HTTPS, napríklad Caddy v tom istom súbore compose.yaml, a potom nastavte verejnú adresu ako URL Jenkinsu.
V zázname zo spustenia a v súbore secrets/initialAdminPassword v JENKINS_HOME: /var/jenkins_home s obrazom Docker, /var/lib/jenkins s balíkmi. Vložte ho na stránku Unlock Jenkins a potom si vytvorte vlastný účet správcu.
Dokumentácia odporúča spúšťať ich na agentoch: na zabudovanom uzle má build rovnaký prístup k súborom riadiaceho servera ako Jenkins. Pripojte agenta, cez SSH alebo WebSocket, a potom nastavte počet vykonávateľov zabudovaného uzla na 0.
Obsluhujte ju cez HTTPS za reverznou proxy, prejdite na maticové zabezpečenie, Overall/Administer vyhraďte dôveryhodným ľuďom, ochranu CSRF nechajte zapnutú, buildy spúšťajte na agentoch a vydania LTS s bezpečnostnými opravami používajte bez odkladu.
Archivujte JENKINS_HOME pri zastavenej službe alebo cez snímku súborového systému. Súbor secrets/master.key nechajte mimo tejto zálohy, uložený osobitne na veľmi bezpečnom mieste, a každú zálohu overte obnovou na testovacom Jenkinse spustenom na inom porte.
Managed VPS pokrýva server: systém, zabezpečenie, dohľad a zálohy. Naše tímy vašu inštanciu aj proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy. Zásah v samotnej aplikácii sa fakturuje hodinovo alebo paušálne.
Simafri
Porozprávajme sa o vašom zámere
Povedzte nám v pár slovách, čo potrebujete: rýchlo sa vám ozveme.
Ďakujeme! Vaša žiadosť bola odoslaná. Čoskoro sa vám ozveme.
Máte radšej e-mail? Napíšte nám na support@simafri.com.