Hostati Jenkins na Managed VPS-u znači graditi, testirati i postavljati svoje projekte sa stroja koji je vaš, a koji naši timovi održavaju ažurnim i nadziru danju i noću. Jenkins je slobodan softver pod licencom MIT. Ovaj vodič prati njegovu službenu dokumentaciju: odabir izdanja LTS, instalaciju s Docker Composeom ili Linux paketima, HTTPS i URL Jenkinsa, agente, dopuštenja, dodatke, sigurnosne kopije i nadogradnje.
Autor: Simon Vasconcelos Lee
Objavljeno 16. studenoga 2026.Vrijeme čitanja: 15 minuta
jenkins/jenkins i njezinim oznakama lts ili s Linux paketima projekta, iza obrnutog proxyja s HTTPS-om; zatim tu adresu postavite kao URL Jenkinsa.JENKINS_HOME, secrets/master.key čuvajte zasebno i pročitajte vodič za nadogradnju svakog izdanja LTS prije nego ga primijenite.Jenkins se opisuje kao vodeći poslužitelj za automatizaciju otvorenog koda. Izrađen u Javi, nudi više od 2000 dodataka za automatizaciju gotovo svega. Njegov README navodi najčešće upotrebe: izradu projekata, pokretanje testova kako bi se pogreške uočile čim se pojave, statičku analizu koda i postavljanje.
Jenkinsfile, koju dokumentacija preporučuje spremiti u sustav za upravljanje izvornim kodom projekta.Jenkins je objavljen pod licencom MIT. Ona dopušta upotrebu, kopiranje, izmjenu, spajanje, objavljivanje, distribuciju, podlicenciranje i prodaju softvera, uz jedan uvjet: zadržati napomenu o autorskim pravima i tekst licence u svakom primjerku. Stoga Jenkins možete pokretati u tvrtki, za svoje projekte kao i za projekte svojih klijenata, bez kupnje licence.
Licenca pokriva kod. Naziv „Jenkins” registrirani je žig organizacije LF Charities, Inc., povezane sa zakladom Linux Foundation, a projekt primjenjuje politiku žigova zaklade Linux Foundation. Ta se politika odnosi na svakoga tko tu riječ stavlja u naziv vlastitog proizvoda ili usluge, a za to predlaže oblike poput „vaš proizvod for Jenkins”: pročitajte je ako gradite ponudu oko softvera. Navođenje Jenkinsa radi njegova opisa, kao u ovom vodiču, poštena je upotreba.
Ova je publikacija neovisna o projektu Jenkins, organizaciji LF Charities, Inc. i zakladi Linux Foundation te nije s njima povezana, niti su je oni sponzorirali ili odobrili.
Jenkins izlazi u dvije linije. Tjedno izdanje svaki tjedan donosi nove funkcije i ispravke. Linija LTS, od Long-Term Support, polazi od tjednog izdanja koje se svakih 12 tjedana odabire kao osnovica, a zatim prima prenesene ispravke. Dokumentacija oznake LTS Docker slike predstavlja kao stabilnije izdanje, spremno za produkciju: njega instalira ovaj vodič.
| Linija | Na dan 8. studenoga 2026. | Ritam |
|---|---|---|
| LTS | 2.580.2 od 28. listopada 2026., nakon 2.580.1 od 30. rujna | Tri izdanja po osnovici, .1, .2 i .3, svako nakon dva tjedna prenošenja ispravaka i dva tjedna testiranja |
| Tjedno | 2.589 | Jedno izdanje tjedno |
LTS 2.580.2 zahtijeva Javu 21 ili Javu 25: s bilo kojom drugom inačicom kontroler se ne pokreće. Projekt planira završiti podršku za Javu 21 u rujnu 2027., a za Javu 25 u rujnu 2029. Zahtjev vrijedi za cijeli sustav, kontroler, agente i naredbeni redak; vaši se projekti grade s inačicom Jave koja im odgovara.
Dokumentacija preporučuje službenu sliku jenkins/jenkins. Oznaka lts prati LTS na Javi 21, lts-jdk25 isti LTS na Javi 25, a latest tjedno izdanje. Na poslužitelju s instaliranim Dockerom izradite mapu i u nju stavite ovaj compose.yaml, preuzet iz primjera za Caddy iz dokumentacije: Caddy prima posjetitelje na portovima 80 i 443, pribavlja HTTPS certifikat i prosljeđuje Jenkinsu, koji je dostupan samo na internoj mreži.
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: tu se nalaze svi podaci, uključujući dodatke i konfiguraciju. README slike taj volumen pretpostavlja mapi na poslužitelju domaćinu, koja može izazvati probleme s dopuštenjima: korisnik jenkins u kontejneru ima ID 1000.web. Port 50000 koriste dolazni TCP agenti; agenti WebSocket i SSH rade bez njega, pa ovdje nije objavljen.2.580.2-lts-jdk25 fiksira inačicu, dok lts-jdk25 prati trenutačni LTS.Dokumentacija postavlja minimum od 256 MB memorije i 1 GB diska, barem 10 GB u Docker kontejneru, a za mali tim preporučuje 4 GB memorije ili više i 50 GB diska ili više. Objašnjava da se memorija kontrolera kreće od 200 MB za malu instalaciju do više od 70 GB za najveće; svaki povezani agent ondje zauzima 2 ili 3 dretve, otprilike 2 MB ili više. Najveći dio posla, buildovi, odvija se na agentima.
Na Managed VPS-u opišite nam svoje projekte i koliko često gradite: preporučujemo vam odgovarajuću veličinu za kontroler i za agente.
Projekt objavljuje i pakete za Debian i Ubuntu, Fedoru, Red Hat Enterprise Linux i njegove izvedenice. Na Debianu ili Ubuntuu najprije instalirajte Javu: dokumentacija to izričito preporučuje, jer Jenkins instaliran prije Jave pri pokretanju možda neće pronaći valjanu instalaciju Jave.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Zatim dodajte repozitorij LTS, debian-stable, s njegovim ključem za potpisivanje i instalirajte 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 izrađuje uslugu systemd i korisnika jenkins, svoj zapisnik šalje u journald (journalctl -u jenkins.service), svoje podatke čuva u /var/lib/jenkins i sluša na portu 8080, na svim sučeljima. Iza proxyja na istom poslužitelju ograničite ga na lokalnu adresu s sudo systemctl edit jenkins, a zatim sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Ovaj blok preuzima primjer za Nginx iz dokumentacije, sveden na blok location /, oblik koji ona predviđa kada Nginx sam ne čita datoteke Jenkinsa:
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 kose crte na kraju: dokumentacija upozorava da kosa crta na kraju te vrijednosti stvara probleme.Upgrade i Connection služe agentima WebSocket, a map održava veze živima za ostatak prometa.proxy_request_buffering off nužan je za naredbe naredbenog retka Jenkinsa poslane preko HTTP-a.client_max_body_size određuje najveću veličinu prijenosa, 10 MB u primjeru.Certbot zatim postavlja certifikat i brine se za njegovu obnovu:
sudo certbot --nginx
Kada je Jenkins na internetu, postavite njegovu javnu adresu, primjerice https://jenkins.example.com/, u izborniku Manage Jenkins, System, u odjeljku Jenkins Location. Jenkins je koristi za svaku adresu koju generira, u sučelju kao i u datotekama agenata, te za komunikaciju s agentima i vanjskim alatima. Opcije porta na to ne utječu: važan je taj URL.
Jenkins sam nadzire svoj obrnuti proxy. Ako prikaže „It appears that your reverse proxy setup is broken”, najprije provjerite odgovara li taj URL adresi koju koristite, a zatim šalje li proxy X-Forwarded-Proto kada prima HTTPS i komunicira li s Jenkinsom preko HTTP-a, kao oba primjera iz ovog vodiča.
Ako se Jenkins poslužuje pod putanjom poput /jenkins umjesto pod vlastitim nazivom domene, mora znati tu putanju: --prefix=/jenkins, preko JENKINS_OPTS uz Docker ili JENKINS_PREFIX uz pakete. Dokumentacija preporučuje istu putanju s obje strane, jer njezino prepisivanje u proxyju znači ispravljanje velikog broja adresa.
Pri prvom pristupu Jenkins traži automatski generiranu lozinku, koju upisuje u svoj zapisnik i u secrets/initialAdminPassword. Otvorite svoju HTTPS adresu, a zatim je pročitajte:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin zadržava lozinku za otključavanje kao svoju lozinku.Čarobnjak ostavlja strategiju autorizacije „Logged-in users can do anything”: svaki prijavljeni račun ima puna prava. To vam odgovara dok račun imaju samo osobe u koje imate potpuno povjerenje. Prije otvaranja dodatnih računa prijeđite na sigurnost temeljenu na matrici, opisanu u nastavku.
Build pokreće naredbe koje kontroliraju i druge osobe osim administratora: skripte za izradu, testove, kod svakog commita. Na ugrađenom čvoru te naredbe imaju isti pristup datotečnom sustavu kontrolera kao i sam Jenkins. Dokumentacija stoga preporučuje da na ugrađenom čvoru ne pokrećete nijedan build i da ih prepustite agentima, čime procesor i memorija kontrolera ostaju i za njegov vlastiti posao.
| Veza | Kako | Mrežna strana |
|---|---|---|
| SSH | Kontroler se povezuje s agentom, s dodatkom SSH Build Agents | Nijedan port za otvaranje na kontroleru |
| WebSocket | Agent se povezuje s kontrolerom preko njegove HTTPS adrese, od Jenkinsa 2.217 | Nijedan dodatni port: proxy prosljeđuje WebSocket |
| Dolazni TCP | Agent se povezuje s kontrolerom na namjenskom TCP portu | Fiksni port koji treba otvoriti i objaviti, 50000 u Docker slici |
Dokumentacija savjetuje generičke, međusobno zamjenjive agente, pripremljene alatom za upravljanje konfiguracijom, unaprijed izrađenom slikom ili kontejnerom: agent koji padne tada se bez napora zamjenjuje. S jednim poslužiteljem predlaže agenta koji radi kao drugi korisnik operacijskog sustava, bez prava čitanja ili pisanja u JENKINS_HOME i bez sudo. Na Managed VPS-u i drugi VPS može služiti kao agent, dimenzioniran za vaše buildove.
Kontrola pristupa od agenta prema kontroleru, koja kompromitiranom agentu onemogućuje slanje naredbi kontroleru, uvijek je uključena od Jenkinsa 2.326.
Jenkins razdvaja autentifikaciju, koja utvrđuje tko ste, od autorizacije, koja određuje što smijete raditi. Njegova ugrađena baza korisnika, uključena prema zadanim postavkama, odgovara malim timovima; LDAP, Active Directory, SAML ili OpenID Connect priključuju se preko dodataka. Za autorizaciju dokumentacija opisuje ove strategije:
| Strategija | Što dodjeljuje | Kada je odabrati |
|---|---|---|
| Anyone can do anything | Puna prava, čak i anonimnim posjetiteljima | Samo za lokalni test |
| Logged-in users can do anything | Puna prava svakom prijavljenom računu; postavka koju ostavlja čarobnjak | Dok račun imaju samo osobe u koje imate potpuno povjerenje |
| Matrix-based security | Dopuštenja dodijeljena po korisniku ili po grupi | Polazište koje dokumentacija preporučuje za produkciju |
| Project-based Matrix Authorization Strategy | Ista matrica, proširena projekt po projekt | Kako biste neke projekte rezervirali za neke osobe |
Obje strategije s matricom dolaze iz dodatka Matrix Authorization Strategy, koji je među dodacima koje predlaže čarobnjak. U matrici malo dodijelite retcima anonymous i authenticated: Overall/Administer dodijeljen retku authenticated jednak je postavci „Logged-in users can do anything”. Jednako pazite ako otvorite samostalnu registraciju ili pružatelja identiteta kod kojeg svatko može izraditi račun.
JENKINS_HOME ključevima iz mape secrets, koju odjeljak o sigurnosnim kopijama obrađuje zasebno.Dodaci Jenkinsu daju njegovu svestranost, a svaki je od njih kod koji radi unutar kontrolera. Jenkins provjerava Update Center jednom u 24 sata; ažuriranja se pojavljuju na kartici Updates u izborniku Manage Jenkins, Plugins i stupaju na snagu nakon ponovnog pokretanja. Gumb Check now pokreće provjeru odmah.
Uz Docker možete izraditi i vlastitu sliku iz jenkins/jenkins i u nju instalirati svoje dodatke s jenkins-plugin-cli, iz popisa plugins.txt koji fiksira njihove inačice i koji alat može ažurirati. README slike opisuje tu metodu.
Obavijesti o buildovima idu preko dodatka Mailer: neuspio build, uspjeh nakon neuspjeha ili build koji postane nestabilan pokreće poruku e-pošte. Poslužitelj za slanje postavlja se u izborniku Manage Jenkins, System, u odjeljku E-mail Notification.
Na Simafri VPS-u pošta odlazi preko autentificiranog SMTP releja, na portu 587: adresa računa e-pošte koji već imate ili Simafri Suite. U naprednim opcijama označite Use SMTP Authentication s korisničkim imenom i lozinkom računa, a zatim Use TLS: dodatak tada koristi port 587. Opcija Test configuration by sending test e-mail šalje probnu poruku.
Dokumentacija sigurnosne kopije kontrolera naziva presudno važnima: služe za oporavak nakon katastrofe, za vraćanje konfiguracije promijenjene greškom ili datoteke koja je oštećena ili izbrisana. Sve se nalazi u JENKINS_HOME: /var/jenkins_home u Docker slici, /var/lib/jenkins uz pakete.
| Element | Što čuva | Za sigurnosno kopiranje |
|---|---|---|
*.xml, uključujući config.xml | Glavnu konfiguraciju i konfiguraciju sustava | Obavezno |
jobs/ | Zadatke i povijest buildova; u builds/archive arhivirane artefakte | Obavezno; artefakte prema potrebi, jer postaju veliki |
plugins/*.jpi | Instalirane dodatke, u njihovim inačicama | Preporučeno, za identično vraćanje |
secrets/ | Ključeve koji šifriraju pristupne podatke | Mapu, osim master.key, koji se čuva zasebno |
workspace/ | Datoteke preuzete iz sustava za upravljanje izvornim kodom za buildove | Neobavezno: novo preuzimanje ponovno ih izrađuje |
war/, cache/, tools/ | Raspakiranu datoteku WAR, preuzete i raspakirane alate | Neobavezno: ponovno se izrađuju prema potrebi |
Dokumentacija traži da glavni ključ nikad ne stavljate u redovnu sigurnosnu kopiju. secrets/master.key šifrira ključ koji štiti vaše pristupne podatke: tko ima vaše sigurnosne kopije i taj ključ, može pročitati sve. Kopirajte ga jednom i čuvajte zasebno na vrlo sigurnom mjestu, kao privatni SSH ključ; potreban je za potpuno vraćanje.
README slike traži da se prema jenkins_home odnosite kao prema bazi podataka. Zaustavite Jenkins za vrijeme kopiranja, a zatim arhivirajte volumen privremenim kontejnerom, prema metodi iz dokumentacije Dockera:
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 napravljena uz zaustavljenu uslugu je dosljedna. Za sigurnosno kopiranje bez zaustavljanja dokumentacija upućuje na snimke datotečnog sustava, LVM, btrfs ili ZFS, koje su dosljednije i brže od kopiranja tijekom rada; među dodacima otvorenog koda za sigurnosno kopiranje navodi thinBackup kao jedini koji se još održava. Svakoj kopiji dajte naziv s vremenskom oznakom, izbjegavajte /tmp, koji se može očistiti pri ponovnom pokretanju, i gotove kopije šaljite na udaljeni poslužitelj.
Postavljene na disk poslužitelja, te arhive ulaze i u njegove noćne sigurnosne kopije.
Dokumentacija traži da provjerite svaku sigurnosnu kopiju i daje jednostavnu metodu: vratite je u privremenu mapu, vratite master.key na mjesto i na njoj pokrenite drugi Jenkins iste inačice, na drugom portu:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Prije svake nadogradnje jezgre pročitajte stranicu ciljanog izdanja LTS u projektnim vodičima za nadogradnju: svaki odjeljak pokriva nadogradnju s prethodnog izdanja LTS. Za 2.580.2 ne navodi nijednu značajnu promjenu. Za 2.580.1 napominje da nekoliko dodataka odvojenih od jezgre više nije uključeno u WAR: Jenkins ih sam instalira kada je Update Center dostupan. Zatim sigurnosno kopirajte JENKINS_HOME i nadogradite:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Jenkins ostaje vaš softver, sa svojim pipelineovima, postavkama i podacima.
| Tema | Naši timovi | Vi |
|---|---|---|
| Poslužitelj | Ažuriranja sustava i sigurnosti, uključujući intervencije na poslužitelju | Trenutak koji odgovara vašem poslovanju |
| Nadzor | Poslužitelj pod nadzorom 24 sata dnevno, 7 dana u tjednu, s intervencijom bez čekanja vašeg poziva | Čitanje zapisnika vaše instance i vaših buildova |
| Jenkins | Proaktivno praćenje: uočene pogreške, usporavanja i prostor na disku, preporučen ispravak | Njegova instalacija, ažuriranja, dodaci i postavke, koje primjenjujete vi ili vaš AI asistent |
| Pipelineovi i agenti | Poslužitelji koji ih nose, nadzirani i sigurnosno kopirani | Zadaci, agenti, računi, dopuštenja i pristupni podaci |
| Sigurnosne kopije | Svake noći, šifrirane i čuvane izvan stroja; vraćanje uključeno | Arhive specifične za Jenkins, datoteka master.key i zahtjev za vraćanje, kada vam zatreba |
| Migracija | Vaš trenutačni poslužitelj migriran, besplatno | Trenutak prelaska |
Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.
Uz Simafri Managed VPS naši timovi održavaju poslužitelj vaše instance Jenkinsa ažurnim, nadziru ga danju i noću i interveniraju bez čekanja vašeg poziva; uz to proaktivno prate vašu instancu i preporučuju vam korisne ispravke, koje primjenjujete vi ili vaš AI asistent. Sigurnosne kopije svake se noći šifriraju i čuvaju izvan stroja, njihovo vraćanje je uključeno, a migracija vašeg trenutačnog poslužitelja je besplatna.
Da. Jenkins je pod licencom MIT: možete ga koristiti, mijenjati i pokretati u tvrtki bez kupnje licence, uz zadržavanje napomene o autorskim pravima i licenci. Ostaje trošak poslužitelja na kojima rade kontroler i agenti.
Liniju LTS, koju dokumentacija predstavlja kao spremnu za produkciju: 2.580.2 na dan 28. listopada 2026. Zahtijeva Javu 21 ili Javu 25. Nova osnovica LTS odabire se svakih 12 tjedana, a svaka osnovica dobiva tri izdanja s ispravcima.
Koristite službenu sliku jenkins/jenkins s oznakom LTS, poput lts-jdk25, i imenovani volumen montiran na /var/jenkins_home. Ispred postavite obrnuti proxy s HTTPS-om, primjerice Caddy u istoj datoteci compose.yaml, a zatim javnu adresu postavite kao URL Jenkinsa.
U zapisniku pokretanja i u datoteci secrets/initialAdminPassword unutar JENKINS_HOME: /var/jenkins_home uz Docker sliku, /var/lib/jenkins uz pakete. Zalijepite je na stranicu Unlock Jenkins, a zatim izradite vlastiti administratorski račun.
Dokumentacija preporučuje da ih pokrećete na agentima: na ugrađenom čvoru build ima isti pristup datotekama kontrolera kao i Jenkins. Povežite agenta, preko SSH-a ili WebSocketa, a zatim broj izvršitelja ugrađenog čvora postavite na 0.
Poslužujte je preko HTTPS-a iza obrnutog proxyja, prijeđite na sigurnost temeljenu na matrici, Overall/Administer rezervirajte za osobe od povjerenja, zaštitu CSRF ostavite uključenom, buildove pokrećite na agentima i bez odgađanja primjenjujte izdanja LTS sa sigurnosnim ispravcima.
Arhivirajte JENKINS_HOME, uz zaustavljenu uslugu ili snimkom datotečnog sustava. Datoteku secrets/master.key držite izvan te sigurnosne kopije, zasebno na vrlo sigurnom mjestu, i provjerite svaku sigurnosnu kopiju vraćanjem na probni Jenkins pokrenut na drugom portu.
Managed VPS pokriva poslužitelj: sustav, sigurnost, nadzor i sigurnosne kopije. Naši timovi proaktivno prate i vašu instancu te vam preporučuju korisne ispravke, koje primjenjujete vi. Intervencija u aplikaciji naplaćuje se po satu ili paušalno.
Simafri
Porazgovarajmo o Vašem projektu
Recite nam u nekoliko riječi što trebate: javljamo Vam se brzo.
Hvala! Vaš upit je poslan. Javit ćemo vam se uskoro.
Više volite e-mail? Pišite nam na support@simafri.com.