Hostovat Jenkins® na Managed VPS: vaše sestavení na vašem serveru

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.

Simon Vasconcelos Lee Autor: Publikováno 16. listopadu 2026Doba čtení: 15 minut

Všichni průvodci

To nejdůležitější

  1. Licence MIT dovoluje Jenkins ve firmě volně používat, pokud zachováte jeho licenční upozornění. Název spadá zvlášť pod zásady k ochranným známkám, které projekt přijal, tedy zásady Linux Foundation.
  2. Zvolte řadu LTS: k 28. říjnu 2026 verzi 2.580.2, která běží na Javě 21 nebo Javě 25. Nový základ LTS se vybírá každých 12 týdnů.
  3. Nainstalujte ho z oficiálního obrazu 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.
  4. Sestavení spouštějte na agentech a počet exekutorů kontroleru nastavte na 0. Oprávnění udělujte maticovým zabezpečením a ochranu CSRF nechte zapnutou.
  5. Zálohujte JENKINS_HOME, secrets/master.key uchovávejte zvlášť a před každou LTS si přečtěte její průvodce aktualizací.

Co Jenkins umí

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í.

Licence MIT a ochranná známka

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.

LTS, nebo týdenní: které vydání nainstalovat

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.

ŘadaK 8. listopadu 2026Tempo
LTS2.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.589Jedno 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.

Instalace pomocí Docker Compose

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.

compose.yaml
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:
Caddyfile
jenkins.example.com {
  encode zstd gzip
  reverse_proxy jenkins:8080
}
Terminál
docker compose up -d

Dimenzování serveru

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.

S balíčky pro Debian nebo Ubuntu

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.

Terminál
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:

Terminál
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:

Přepis služby
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"

S Nginx a Certbotem

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:

Blok Nginx
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;
  }
}

Certbot pak nainstaluje certifikát a postará se o jeho obnovu:

Terminál
sudo certbot --nginx

Jenkins URL a reverzní proxy

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.

První spuštění: úvodní heslo a průvodce nastavením

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:

Terminál, s Docker Compose
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
Terminál, s balíčky
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  1. Vložte toto heslo na stránce Unlock Jenkins.
  2. Zvolte Install suggested plugins, sadu, kterou dokumentace radí, když ještě nevíte jistě, které pluginy potřebujete; další se přidávají později v Manage Jenkins, Plugins.
  3. Vytvořte prvního správce se silným heslem. Pokud tento krok přeskočíte, ponechá si účet admin jako heslo heslo pro odemčení.
  4. Nastavte Jenkins URL, jako v předchozí části.

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í na agentech, kontroler pro řízení

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.

  1. Připojte alespoň jednoho agenta: jiný stroj, kontejner nebo cloud. Agent potřebuje Javu a síťové spojení s kontrolerem.
  2. V Manage Jenkins, Nodes otevřete Built-In Node, pak Configure, a nastavte počet exekutorů na 0. Udělejte to, jakmile je agent nasazený, protože sestavení pak čekají, až se agent spustí. Obraz Docker má ve výchozím nastavení 2.
PřipojeníJakZe strany sítě
SSHKontroler se připojuje k agentovi pomocí pluginu SSH Build AgentsNa kontroleru není třeba otevírat žádný port
WebSocketAgent se připojuje ke kontroleru přes jeho adresu HTTPS, od Jenkins 2.217Žádný další port: proxy předává WebSocket
Příchozí TCPAgent se připojuje ke kontroleru na vyhrazeném portu TCPPevný 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é.

Účty a oprávnění

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:

StrategieCo udělujeKdy ji zvolit
Anyone can do anythingPlná práva, i anonymním návštěvníkůmJen pro místní test
Logged-in users can do anythingPlná práva každému přihlášenému účtu; nastavení, které ponechá průvodceDokud mají účet jen lidé, kterým plně důvěřujete
Matrix-based securityOprávnění udělená jednotlivým uživatelům nebo skupinámVýchozí bod, který dokumentace doporučuje pro produkční provoz
Project-based Matrix Authorization StrategyStejná matice, rozšířená projekt po projektuPro 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.

Pluginy a jejich aktualizace

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.

E-mailová oznámení

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.

Zálohování JENKINS_HOME

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žkaCo uchováváZálohovat
*.xml, včetně config.xmlHlavní konfiguraci a konfiguraci systémuPovinně
jobs/Úlohy a historii sestavení; v builds/archive archivované artefaktyPovinně; artefakty podle potřeby, bývají objemné
plugins/*.jpiNainstalované pluginy v jejich verzíchDoporučeno, pro obnovu ve stejné podobě
secrets/Klíče, které šifrují přístupové údajeSlož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ástrojeVolitelně: 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.

S Docker Compose

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:

Terminál, ve složce se souborem compose.yaml
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
Terminál, jednou: hlavní klíč
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key

S balíčky

Terminál
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.

Ověření zálohy

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:

Terminál
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999

Aktualizace

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:

Terminál, s Docker Compose
docker compose pull
docker compose up -d
Terminál, s balíčky
sudo apt update
sudo apt install jenkins

Kdo co dělá na Managed VPS

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émaNaše týmyVy
ServerAktualizace systému a zabezpečení, včetně zásahů na serveruOkamžik, který vyhovuje vašemu provozu
DohledServer 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í
JenkinsProaktivní sledování: chyby, zpomalení a místo na disku zachycené, doporučená opravaJeho instalace, aktualizace, pluginy a nastavení, které zapracujete vy nebo váš AI asistent
Pipeline a agentiServery, které je nesou, hlídané a zálohovanéÚlohy, agenti, účty, oprávnění a přístupové údaje
ZálohyKaž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
MigraceVáš stávající server přenesen zdarmaOkamž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.

Jenkins na serveru, o který se staráme za vás

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.

Objevit Managed VPS

Časté otázky

Je Jenkins pro firmu 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.

Kterou verzi Jenkins nainstalovat?

Ř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í.

Jak nainstalovat Jenkins s Dockerem?

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.

Kde najdu úvodní heslo správce Jenkins?

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.

Mají sestavení běžet na kontroleru Jenkins?

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.

Jak zabezpečit instanci Jenkins?

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.

Jak zálohovat Jenkins?

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.

Pokrývá Managed VPS i Jenkins?

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.

Zdroje a oficiální dokumentace

Kontaktujte nás