Hostovat Jenkins na Managed VPS znamená sestavovat, testovat a nasazovat své projekty z vlastního stroje, který naše týmy udržují aktuální a ve dne i v noci hlídají. Jenkins je svobodný software pod licencí MIT. Tento průvodce sleduje jeho oficiální dokumentaci: volbu vydání LTS, instalaci pomocí Docker Compose nebo balíčků pro Linux, HTTPS a adresu Jenkins URL, agenty, oprávnění, pluginy, zálohy a aktualizace.
Autor: Simon Vasconcelos Lee
Publikováno 16. listopadu 2026Doba čtení: 15 minut
jenkins/jenkins a jeho značek lts, nebo z balíčků projektu pro Linux, za reverzní proxy s HTTPS; tuto adresu pak nastavte jako Jenkins URL.JENKINS_HOME, secrets/master.key uchovávejte zvlášť a před každou LTS si přečtěte její průvodce aktualizací.Jenkins se představuje jako přední otevřený automatizační server. Je postavený na Javě a nabízí přes 2 000 pluginů, se kterými lze automatizovat prakticky cokoli. Jeho README uvádí nejčastější použití: sestavování projektů, spouštění testů, které zachytí chyby hned při jejich zavedení, statickou analýzu kódu a nasazování.
Jenkinsfile, jejž dokumentace doporučuje ukládat do správy verzí projektu.Jenkins je vydáván pod licencí MIT. Ta dovoluje software používat, kopírovat, upravovat, slučovat, zveřejňovat, šířit, sublicencovat a prodávat, s jedinou podmínkou: zachovat v každé kopii upozornění o autorských právech a text licence. Jenkins tedy můžete provozovat ve své firmě, pro vlastní projekty i pro projekty svých klientů, aniž byste kupovali licenci.
Licence se týká kódu. Název „Jenkins“ je registrovaná ochranná známka LF Charities, Inc., organizace spojené s Linux Foundation, a projekt se řídí zásadami Linux Foundation k ochranným známkám. Tyto zásady se vztahují na každého, kdo slovo umístí do názvu vlastního produktu nebo služby, a navrhují k tomu tvary jako „váš produkt for Jenkins“: přečtěte si je, pokud kolem softwaru stavíte nabídku. Zmínit Jenkins, abychom ho popsali, jako to dělá tento průvodce, je přípustné užití.
Tato publikace je nezávislá na projektu Jenkins, na LF Charities, Inc. i na Linux Foundation: není s nimi přidružena a není jimi sponzorována ani schválena.
Jenkins vychází ve dvou řadách. Týdenní vydání přináší každý týden nové funkce a opravy. Řada LTS, Long-Term Support, vychází z týdenního vydání vybraného každých 12 týdnů jako základ a pak dostává zpětně přenesené opravy. Dokumentace představuje značky LTS obrazu Docker jako stabilnější vydání připravené pro produkční provoz: právě to tento průvodce instaluje.
| Řada | K 8. listopadu 2026 | Tempo |
|---|---|---|
| LTS | 2.580.2 z 28. října 2026, po 2.580.1 z 30. září | Tři vydání na jeden základ, .1, .2 a .3, každé po dvou týdnech zpětného přenášení a dvou týdnech testování |
| Týdenní | 2.589 | Jedno vydání týdně |
LTS 2.580.2 vyžaduje Javu 21 nebo Javu 25: s jinou verzí kontroler nepoběží. Projekt plánuje ukončit podporu Javy 21 v září 2027 a Javy 25 v září 2029. Požadavek platí pro celý systém, kontroler, agenty i příkazový řádek; vaše projekty samotné se sestavují s takovou verzí Javy, jaká jim vyhovuje.
Dokumentace doporučuje oficiální obraz jenkins/jenkins. Značka lts sleduje LTS na Javě 21, lts-jdk25 tutéž LTS na Javě 25 a latest týdenní vydání. Na serveru s nainstalovaným Dockerem vytvořte složku a umístěte do ní tento compose.yaml, převzatý z příkladu dokumentace pro Caddy: Caddy přijímá návštěvníky na portech 80 a 443, získá certifikát HTTPS a předává provoz Jenkinsu, který je dostupný jen ve vnitřní síti.
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 jsou všechna data, včetně pluginů a konfigurace. README obrazu dává tomuto svazku přednost před složkou na hostiteli, která může vést k potížím s oprávněními: uživatel jenkins v kontejneru má ID 1000.web. Port 50000 používají příchozí agenti TCP; agenti WebSocket a SSH se bez něj obejdou, proto zde publikovaný není.2.580.2-lts-jdk25 verzi pevně určí, kdežto lts-jdk25 sleduje aktuální LTS.Dokumentace stanoví minimum 256 MB paměti a 1 GB disku, v kontejneru Docker alespoň 10 GB, a pro malý tým doporučuje 4 GB paměti nebo více a 50 GB disku nebo více. Vysvětluje, že paměť kontroleru sahá od 200 MB u malé instalace po více než 70 GB u těch největších; každý připojený agent v ní zabírá 2 nebo 3 vlákna, zhruba 2 MB nebo více. Hlavní práce, sestavení, běží na agentech.
Na Managed VPS nám popište své projekty a to, jak často sestavujete: doporučíme vám vhodnou velikost pro kontroler i pro agenty.
Projekt zveřejňuje také balíčky pro Debian a Ubuntu, Fedoru, Red Hat Enterprise Linux a jeho odvozeniny. Na Debianu nebo Ubuntu nejdřív nainstalujte Javu: dokumentace to důrazně doporučuje, protože Jenkins nainstalovaný před Javou nemusí při spuštění najít platnou instalaci Javy.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Pak přidejte repozitář LTS, debian-stable, s jeho podpisovým klíčem a nainstalujte 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íček vytvoří službu systemd a uživatele jenkins, posílá svůj protokol do journald (journalctl -u jenkins.service), uchovává svá data v /var/lib/jenkins a naslouchá na portu 8080 na všech rozhraních. Za proxy na stejném serveru ho omezte na místní adresu pomocí sudo systemctl edit jenkins a pak sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Tento blok vychází z příkladu Nginx v dokumentaci, zkráceného na blok location /, tedy na podobu, kterou dokumentace uvádí pro případ, kdy Nginx soubory Jenkinsu sám nečte:
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 koncového lomítka: dokumentace upozorňuje, že lomítko na konci této hodnoty způsobuje potíže.Upgrade a Connection slouží agentům WebSocket a map udržuje spojení otevřená pro zbytek provozu.proxy_request_buffering off je nutné pro příkazy příkazového řádku Jenkins posílané přes HTTP.client_max_body_size určuje maximální velikost nahrávaných dat, v příkladu 10 MB.Certbot pak nainstaluje certifikát a postará se o jeho obnovu:
sudo certbot --nginx
Jakmile je Jenkins online, nastavte jeho veřejnou adresu, například https://jenkins.example.com/, v Manage Jenkins, System, v části Jenkins Location. Jenkins ji používá pro každou adresu, kterou vytváří, v rozhraní i v souborech agentů, a pro komunikaci s agenty a externími nástroji. Volby portu na tom nic nemění: rozhoduje tato adresa URL.
Jenkins svou reverzní proxy sám sleduje. Pokud zobrazí „It appears that your reverse proxy setup is broken“, nejdřív ověřte, že tato adresa URL odpovídá adrese, kterou používáte, a pak že proxy posílá X-Forwarded-Proto, když přijímá HTTPS, a s Jenkinsem mluví přes HTTP, jako oba příklady v tomto průvodci.
Pokud Jenkins provozujete pod cestou, například /jenkins, místo vlastního doménového jména, musí tuto cestu znát: --prefix=/jenkins, přes JENKINS_OPTS s Dockerem nebo JENKINS_PREFIX s balíčky. Dokumentace doporučuje stejnou cestu na obou stranách, protože její přepisování v proxy znamená opravovat velké množství adres.
Při prvním přístupu Jenkins požaduje automaticky vygenerované heslo, které zapisuje do svého protokolu a do secrets/initialAdminPassword. Otevřete svou adresu HTTPS a pak si ho přečtěte:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin jako heslo heslo pro odemčení.Průvodce ponechá strategii autorizace „Logged-in users can do anything“: každý přihlášený účet má plná práva. Vyhovuje, dokud mají účet jen lidé, kterým plně důvěřujete. Než otevřete další účty, přejděte na maticové zabezpečení popsané níže.
Sestavení spouští příkazy, které ovládají i jiní lidé než správce: skripty sestavení, testy, kód každého commitu. Na vestavěném uzlu mají tyto příkazy stejný přístup k souborovému systému kontroleru jako samotný Jenkins. Dokumentace proto doporučuje na vestavěném uzlu žádná sestavení nespouštět a předávat je agentům, čímž si kontroler navíc ponechá CPU a paměť pro vlastní práci.
| Připojení | Jak | Ze strany sítě |
|---|---|---|
| SSH | Kontroler se připojuje k agentovi pomocí pluginu SSH Build Agents | Na kontroleru není třeba otevírat žádný port |
| WebSocket | Agent se připojuje ke kontroleru přes jeho adresu HTTPS, od Jenkins 2.217 | Žádný další port: proxy předává WebSocket |
| Příchozí TCP | Agent se připojuje ke kontroleru na vyhrazeném portu TCP | Pevný port, který je třeba otevřít a publikovat, v obrazu Docker 50000 |
Dokumentace radí obecné, zaměnitelné agenty, připravené nástrojem pro správu konfigurace, předem připraveným obrazem nebo kontejnerem: agent, který vypadne, se pak bez námahy nahradí. S jediným serverem navrhuje agenta běžícího pod jiným uživatelem operačního systému, bez přístupu ke čtení nebo zápisu do JENKINS_HOME a bez sudo. Na Managed VPS může jako agent sloužit i druhý VPS, dimenzovaný pro vaše sestavení.
Řízení přístupu z agenta na kontroler, které brání napadenému agentovi posílat kontroleru příkazy, je od Jenkins 2.326 vždy zapnuté.
Jenkins odděluje ověření, které určuje, kdo jste, od autorizace, která říká, co smíte dělat. Jeho vestavěná databáze uživatelů, ve výchozím nastavení zapnutá, vyhovuje malým týmům; LDAP, Active Directory, SAML nebo OpenID Connect se připojují přes pluginy. Pro autorizaci popisuje dokumentace tyto strategie:
| Strategie | Co uděluje | Kdy ji zvolit |
|---|---|---|
| Anyone can do anything | Plná práva, i anonymním návštěvníkům | Jen pro místní test |
| Logged-in users can do anything | Plná práva každému přihlášenému účtu; nastavení, které ponechá průvodce | Dokud mají účet jen lidé, kterým plně důvěřujete |
| Matrix-based security | Oprávnění udělená jednotlivým uživatelům nebo skupinám | Výchozí bod, který dokumentace doporučuje pro produkční provoz |
| Project-based Matrix Authorization Strategy | Stejná matice, rozšířená projekt po projektu | Pro vyhrazení některých projektů některým lidem |
Obě maticové strategie pocházejí z pluginu Matrix Authorization Strategy, který patří mezi pluginy navrhované průvodcem. V matici udělujte málo řádkům anonymous a authenticated: Overall/Administer udělené authenticated se rovná „Logged-in users can do anything“. Stejně opatrní buďte, pokud otevřete samoregistraci nebo poskytovatele identity, u kterého si účet může vytvořit kdokoli.
JENKINS_HOME šifrované klíči ze složky secrets, kterou část o zálohách řeší zvlášť.Pluginy jsou tím, co dělá Jenkins tak všestranným, a každý z nich je kód běžící uvnitř kontroleru. Jenkins kontroluje Update Center jednou za 24 hodin; aktualizace se objevují na kartě Updates v Manage Jenkins, Plugins a projeví se po restartu. Tlačítko Check now kontrolu vynutí.
S Dockerem si také můžete sestavit vlastní obraz z jenkins/jenkins a nainstalovat do něj své pluginy pomocí jenkins-plugin-cli, ze seznamu plugins.txt, který určuje jejich verze a který nástroj umí aktualizovat. Tuto metodu popisuje README obrazu.
Oznámení o sestaveních vedou přes plugin Mailer: neúspěšné sestavení, úspěch po neúspěchu nebo sestavení, které se stane nestabilním, vyvolá e-mail. Odesílací server se nastavuje v Manage Jenkins, System, v části E-mail Notification.
Na VPS Simafri vede odesílání přes ověřené relé SMTP na portu 587: adresa poštovního účtu, který už máte, nebo Simafri Suite. V pokročilých volbách zaškrtněte Use SMTP Authentication s uživatelským jménem a heslem účtu a pak Use TLS: plugin pak použije port 587. Volba Test configuration by sending test e-mail odešle testovací zprávu.
Dokumentace označuje zálohy kontroleru za zásadně důležité: slouží k obnově po havárii, k obnovení omylem změněné konfigurace nebo souboru, který se poškodil či byl smazán. Vše je v JENKINS_HOME: /var/jenkins_home v obrazu Docker, /var/lib/jenkins s balíčky.
| Položka | Co uchovává | Zálohovat |
|---|---|---|
*.xml, včetně config.xml | Hlavní konfiguraci a konfiguraci systému | Povinně |
jobs/ | Úlohy a historii sestavení; v builds/archive archivované artefakty | Povinně; artefakty podle potřeby, bývají objemné |
plugins/*.jpi | Nainstalované pluginy v jejich verzích | Doporučeno, pro obnovu ve stejné podobě |
secrets/ | Klíče, které šifrují přístupové údaje | Složku, kromě master.key, uchovávaného zvlášť |
workspace/ | Soubory stažené ze správy verzí pro sestavení | Volitelně: nové stažení je znovu vytvoří |
war/, cache/, tools/ | Rozbalený WAR, stažené a rozbalené nástroje | Volitelně: podle potřeby se vytvoří znovu |
Dokumentace žádá nikdy nedávat hlavní klíč do běžné zálohy. secrets/master.key šifruje klíč, který chrání vaše přístupové údaje: kdo má vaše zálohy i tento klíč, přečte vše. Zkopírujte ho jednou a uložte zvlášť na velmi bezpečné místo, jako soukromý klíč SSH; úplná obnova ho potřebuje.
README obrazu žádá zacházet s jenkins_home jako s databází. Po dobu kopírování Jenkins zastavte a pak svazek zarchivujte pomocí dočasného kontejneru, metodou z dokumentace Dockeru:
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
Kopie pořízená při zastavené službě je konzistentní. Pro zálohu bez zastavení odkazuje dokumentace na snímky souborového systému, LVM, btrfs nebo ZFS, které jsou konzistentnější a rychlejší než kopie za běhu; mezi otevřenými zálohovacími pluginy jmenuje thinBackup jako jediný dosud udržovaný. Každé kopii dejte název s časovým razítkem, vyhněte se /tmp, který se při restartu může vyčistit, a hotové kopie posílejte na vzdálený server.
Uložené na disku serveru se tyto archivy dostanou i do jeho nočních záloh.
Dokumentace žádá každou zálohu ověřit a uvádí jednoduchou metodu: obnovte ji do dočasné složky, vraťte do ní master.key a spusťte nad ní druhý Jenkins stejné verze, na jiném portu:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Před každou aktualizací jádra si přečtěte stránku cílové LTS v průvodcích aktualizací projektu: každá část pokrývá aktualizaci z předchozí LTS. Pro 2.580.2 neuvádí žádné významné změny. Pro 2.580.1 poznamenává, že několik pluginů oddělených od jádra už není součástí souboru WAR: Jenkins je nainstaluje sám, když je Update Center dostupné. Pak zálohujte JENKINS_HOME a aktualizujte:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; Jenkins zůstává vaším softwarem, s jeho pipeline, nastavením a daty.
| Téma | Naše týmy | Vy |
|---|---|---|
| Server | Aktualizace systému a zabezpečení, včetně zásahů na serveru | Okamžik, který vyhovuje vašemu provozu |
| Dohled | Server sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše volání | Čtení protokolů vaší instance a vašich sestavení |
| Jenkins | Proaktivní sledování: chyby, zpomalení a místo na disku zachycené, doporučená oprava | Jeho instalace, aktualizace, pluginy a nastavení, které zapracujete vy nebo váš AI asistent |
| Pipeline a agenti | Servery, které je nesou, hlídané a zálohované | Úlohy, agenti, účty, oprávnění a přístupové údaje |
| Zálohy | Každou noc, šifrované a uchovávané mimo stroj; obnova v ceně | Archivy vlastní Jenkinsu, soubor master.key a žádost o obnovu, když ji potřebujete |
| Migrace | Váš stávající server přenesen zdarma | Okamžik přepnutí |
Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.
S Managed VPS od Simafri udržují naše týmy server vaší instance Jenkins aktuální, hlídají ho ve dne i v noci a zasahují bez čekání na vaše volání; vaši instanci také proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy nebo váš AI asistent. Zálohy se každou noc šifrují a uchovávají mimo stroj, jejich obnova je v ceně a migrace vašeho stávajícího serveru je zdarma.
Ano. Jenkins je pod licencí MIT: můžete ho ve firmě používat, upravovat a provozovat, aniž byste kupovali licenci, pokud zachováte jeho upozornění o autorských právech a licenci. Zbývají náklady na servery, které nesou kontroler a agenty.
Řadu LTS, kterou dokumentace představuje jako připravenou pro produkční provoz: k 28. říjnu 2026 verzi 2.580.2. Vyžaduje Javu 21 nebo Javu 25. Nový základ LTS se vybírá každých 12 týdnů a každý základ dostane tři opravná vydání.
Použijte oficiální obraz jenkins/jenkins se značkou LTS, například lts-jdk25, a pojmenovaný svazek připojený na /var/jenkins_home. Před něj umístěte reverzní proxy s HTTPS, například Caddy ve stejném souboru compose.yaml, a pak nastavte veřejnou adresu jako Jenkins URL.
V protokolu při spuštění a v souboru secrets/initialAdminPassword v JENKINS_HOME: /var/jenkins_home s obrazem Docker, /var/lib/jenkins s balíčky. Vložte ho na stránce Unlock Jenkins a pak si vytvořte vlastní účet správce.
Dokumentace doporučuje spouštět je na agentech: na vestavěném uzlu má sestavení stejný přístup k souborům kontroleru jako Jenkins. Připojte agenta, přes SSH nebo WebSocket, a pak nastavte počet exekutorů vestavěného uzlu na 0.
Provozujte ji přes HTTPS za reverzní proxy, přejděte na maticové zabezpečení, Overall/Administer vyhraďte důvěryhodným lidem, ochranu CSRF nechte zapnutou, sestavení spouštějte na agentech a vydání LTS s bezpečnostními opravami nasazujte bez odkladu.
Archivujte JENKINS_HOME při zastavené službě nebo pomocí snímku souborového systému. Soubor secrets/master.key do této zálohy nedávejte, uložte ho zvlášť na velmi bezpečné místo, a každou zálohu ověřte obnovou na testovacím Jenkinsu spuštěném na jiném portu.
Managed VPS pokrývá server: systém, zabezpečení, dohled a zálohy. Naše týmy také proaktivně sledují vaši instanci a doporučí vám užitečné opravy, které zapracujete vy. Zásah v samotné aplikaci se účtuje po hodinách nebo paušálem.
Simafri
Promluvme si o vašem záměru
Řekněte nám v pár slovech, co potřebujete: rychle se vám ozveme.
Děkujeme! Vaše zpráva byla odeslána. Brzy se vám ozveme.
Máte raději e-mail? Napište nám na support@simafri.com.