Găzduirea Jenkins pe un Managed VPS înseamnă să vă construiți, testați și implementați proiectele de pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Jenkins este un software liber sub licență MIT. Acest ghid urmează documentația sa oficială: alegerea versiunii LTS, instalarea cu Docker Compose sau prin pachetele Linux, HTTPS și URL-ul Jenkins, agenții, permisiunile, pluginurile, backupurile și actualizările.
Autor: Simon Vasconcelos Lee
Publicat la 16 noiembrie 2026Timp de citire: 15 minute
jenkins/jenkins și etichetele ei lts sau prin pachetele Linux ale proiectului, în spatele unui proxy invers în HTTPS; treceți apoi această adresă în URL-ul Jenkins.JENKINS_HOME, păstrați separat secrets/master.key și citiți ghidul de actualizare al fiecărei LTS înainte de a o aplica.Jenkins se prezintă ca principalul server open source de automatizare. Scris în Java, el oferă peste 2.000 de pluginuri pentru a automatiza aproape orice. README-ul său enumeră utilizările cele mai obișnuite: construirea proiectelor, rularea testelor pentru a depista un defect de îndată ce apare, analiza statică a codului și implementarea.
Jenkinsfile, pe care documentația recomandă să îl versionați împreună cu codul proiectului.Jenkins este publicat sub licența MIT. Ea permite folosirea, copierea, modificarea, fuzionarea, publicarea, distribuirea, sublicențierea și vânzarea software-ului, cu o singură condiție: păstrarea mențiunii de copyright și a textului licenței în fiecare copie. Puteți deci rula Jenkins în firmă, pentru propriile proiecte ca și pentru cele ale clienților dumneavoastră, fără nicio licență de cumpărat.
Licența acoperă codul. Numele „Jenkins” este o marcă înregistrată a LF Charities, Inc., o organizație asociată cu Linux Foundation, iar proiectul aplică politica de marcă a Linux Foundation. Această politică îi privește pe cei care pun cuvântul în numele propriului produs sau serviciu și propune în acest scop forme precum „produsul dumneavoastră for Jenkins”: citiți-o dacă construiți o ofertă în jurul software-ului. Numirea Jenkins pentru a-l descrie, ca în acest ghid, este o utilizare loială.
Această publicație este independentă de proiectul Jenkins, de LF Charities, Inc. și de Linux Foundation: ea nu este afiliată acestora și nici sponsorizată sau aprobată de ele.
Jenkins apare pe două linii. Versiunea săptămânală (weekly) aduce în fiecare săptămână funcții noi și corecturi. Linia LTS, pentru Long-Term Support, pornește de la o versiune săptămânală aleasă ca bază la fiecare 12 săptămâni, apoi primește corecturi aduse din versiunile mai noi. Documentația prezintă etichetele LTS ale imaginii Docker ca versiunea mai stabilă, pregătită pentru producție: pe aceasta o instalează acest ghid.
| Linie | La 8 noiembrie 2026 | Ritm |
|---|---|---|
| LTS | 2.580.2 din 28 octombrie 2026, după 2.580.1 din 30 septembrie | Trei versiuni pe bază, .1, .2 și .3, fiecare după două săptămâni de preluare a corecturilor și două săptămâni de teste |
| Săptămânală | 2.589 | O versiune pe săptămână |
LTS 2.580.2 cere Java 21 sau Java 25: cu orice altă versiune, controlerul nu pornește. Proiectul prevede încheierea suportului pentru Java 21 în septembrie 2027 și pentru Java 25 în septembrie 2029. Cerința se aplică întregului sistem, controler, agenți și linie de comandă; proiectele dumneavoastră se construiesc cu versiunea de Java care li se potrivește.
Documentația recomandă imaginea oficială jenkins/jenkins. Eticheta lts urmărește LTS pe Java 21, lts-jdk25 aceeași LTS pe Java 25, iar latest versiunea săptămânală. Pe un server unde Docker este instalat, creați un director și puneți în el acest compose.yaml, preluat din exemplul Caddy al documentației: Caddy primește vizitatorii pe porturile 80 și 443, obține certificatul HTTPS și transmite către Jenkins, accesibil doar în rețeaua internă.
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: toate datele se află acolo, inclusiv pluginurile și configurația. README-ul imaginii preferă acest volum unui director de pe gazdă, care poate duce la probleme de permisiuni: utilizatorul jenkins din container are ID-ul 1000.web. Portul 50000 servește agenților TCP de intrare; agenții WebSocket și SSH se descurcă fără el, așa că nu este publicat aici.2.580.2-lts-jdk25 fixează versiunea, pe când lts-jdk25 urmărește LTS-ul curent.Documentația fixează un minim de 256 MB de memorie și 1 GB de disc, cel puțin 10 GB într-un container Docker, și recomandă 4 GB de memorie sau mai mult și 50 GB de disc sau mai mult pentru o echipă mică. Ea explică faptul că memoria controlerului variază de la 200 MB pentru o instalare mică la peste 70 GB pentru cele mai mari; fiecare agent conectat ocupă acolo 2 sau 3 fire de execuție, aproximativ 2 MB sau mai mult. Grosul muncii, buildurile, rulează pe agenți.
Pe un Managed VPS, descrieți-ne proiectele dumneavoastră și cât de des construiți: vă recomandăm dimensiunea potrivită pentru controler și pentru agenți.
Proiectul publică și pachete pentru Debian și Ubuntu, Fedora, Red Hat Enterprise Linux și derivatele sale. Pe Debian sau Ubuntu, instalați mai întâi Java: documentația recomandă insistent acest lucru, deoarece un Jenkins instalat înaintea lui Java poate să nu găsească la pornire o instalare Java validă.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Adăugați apoi depozitul LTS, debian-stable, cu cheia sa de semnare, și instalați 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
Pachetul creează un serviciu systemd și un utilizator jenkins, își trimite jurnalul către journald (journalctl -u jenkins.service), își păstrează datele în /var/lib/jenkins și ascultă pe portul 8080, pe toate interfețele. În spatele unui proxy de pe același server, restrângeți-l la adresa locală cu sudo systemctl edit jenkins, apoi sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Acest bloc preia exemplul Nginx din documentație, redus la blocul său location /, forma pe care o prevede pentru cazul în care Nginx nu citește el însuși fișierele 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 fără bară oblică la final: documentația avertizează că terminarea acestei valori cu o bară oblică provoacă probleme.Upgrade și Connection servesc agenților WebSocket, iar map menține conexiunile deschise pentru restul traficului.proxy_request_buffering off este necesar pentru comenzile liniei de comandă Jenkins trimise prin HTTP.client_max_body_size fixează dimensiunea maximă a unui upload, 10 MB în exemplu.Certbot instalează apoi certificatul și se ocupă de reînnoirea lui:
sudo certbot --nginx
Odată ce Jenkins este online, setați-i adresa publică, de exemplu https://jenkins.example.com/, în Manage Jenkins, System, secțiunea Jenkins Location. Jenkins o folosește pentru toate adresele pe care le generează, în interfață ca și în fișierele agenților, și pentru a comunica cu agenții și cu instrumentele externe. Opțiunile de port nu schimbă nimic: acest URL este cel care contează.
Jenkins își supraveghează propriul proxy invers. Dacă afișează „It appears that your reverse proxy setup is broken”, verificați mai întâi că acest URL corespunde adresei pe care o folosiți, apoi că proxy-ul trimite X-Forwarded-Proto când primește HTTPS și comunică cu Jenkins în HTTP, cum fac cele două exemple din acest ghid.
Servit pe o cale precum /jenkins, mai degrabă decât pe un nume de domeniu propriu, Jenkins trebuie să cunoască această cale: --prefix=/jenkins, prin JENKINS_OPTS cu Docker sau JENKINS_PREFIX cu pachetele. Documentația recomandă aceeași cale de ambele părți, deoarece rescrierea ei în proxy înseamnă corectarea unui număr mare de adrese.
La primul acces, Jenkins cere o parolă generată automat, pe care o scrie în jurnalul său și în secrets/initialAdminPassword. Deschideți adresa dumneavoastră HTTPS, apoi citiți-o:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin păstrează ca parolă parola de deblocare.Asistentul lasă în vigoare strategia de autorizare „Logged-in users can do anything”: fiecare cont conectat are toate drepturile. Ea vă convine cât timp doar persoane de deplină încredere au un cont. Înainte de a deschide alte conturi, treceți la securitatea pe matrice, descrisă mai jos.
Un build rulează comenzi controlate de alte persoane decât administratorul: scripturi de build, teste, codul fiecărui commit. Pe nodul integrat (built-in node), aceste comenzi au același acces la sistemul de fișiere al controlerului ca Jenkins însuși. Documentația recomandă deci să nu rulați niciun build pe nodul integrat și să le încredințați agenților, ceea ce păstrează și procesorul și memoria controlerului pentru propria sa muncă.
| Conexiune | Cum | Partea de rețea |
|---|---|---|
| SSH | Controlerul se conectează la agent, cu pluginul SSH Build Agents | Niciun port de deschis pe controler |
| WebSocket | Agentul se conectează la controler prin adresa sa HTTPS, începând cu Jenkins 2.217 | Niciun port suplimentar: proxy-ul transmite WebSocket |
| TCP de intrare | Agentul se conectează la controler pe un port TCP dedicat | Un port fix de deschis și de publicat, 50000 în imaginea Docker |
Documentația sfătuiește agenți generici, interschimbabili, pregătiți cu un instrument de gestionare a configurației, o imagine gata făcută sau un container: un agent care cade este atunci înlocuit fără efort. Cu un singur server, ea sugerează un agent care rulează sub alt utilizator al sistemului de operare, fără acces la citire sau scriere în JENKINS_HOME și fără sudo. Pe un Managed VPS, un al doilea VPS poate servi și el drept agent, dimensionat pentru buildurile dumneavoastră.
Controlul accesului de la agent la controler, care împiedică un agent compromis să trimită comenzi controlerului, este mereu activ începând cu Jenkins 2.326.
Jenkins separă autentificarea, care stabilește cine sunteți, de autorizare, care spune ce aveți voie să faceți. Baza sa de utilizatori integrată, activă implicit, se potrivește echipelor mici; LDAP, Active Directory, SAML sau OpenID Connect se adaugă prin pluginuri. Pentru autorizare, iată strategiile pe care le descrie documentația:
| Strategie | Ce acordă | Când să o alegeți |
|---|---|---|
| Anyone can do anything | Toate drepturile, chiar și vizitatorilor anonimi | Doar pentru un test local |
| Logged-in users can do anything | Toate drepturile fiecărui cont conectat; setarea lăsată de asistent | Cât timp doar persoane de deplină încredere au un cont |
| Matrix-based security | Permisiuni acordate pe utilizator sau pe grup | Punctul de plecare pe care documentația îl recomandă pentru producție |
| Project-based Matrix Authorization Strategy | Aceeași matrice, extinsă proiect cu proiect | Pentru a rezerva unele proiecte unor anumite persoane |
Ambele strategii pe matrice provin din pluginul Matrix Authorization Strategy, care face parte din pluginurile sugerate de asistent. În matrice, acordați puțin liniilor anonymous și authenticated: Overall/Administer acordat lui authenticated echivalează cu „Logged-in users can do anything”. Aveți aceeași grijă dacă deschideți înregistrarea liberă sau un furnizor de identitate unde oricine își poate crea un cont.
JENKINS_HOME cu cheile din directorul secrets, pe care secțiunea despre backupuri îl tratează separat.Pluginurile sunt cele care fac Jenkins atât de versatil, iar fiecare dintre ele este cod care rulează în controler. Jenkins verifică Update Center o dată la 24 de ore; actualizările apar în fila Updates din Manage Jenkins, Plugins, și intră în vigoare după o repornire. Butonul Check now forțează o verificare.
Cu Docker, puteți și construi propria imagine pornind de la jenkins/jenkins și instala în ea pluginurile cu jenkins-plugin-cli, dintr-o listă plugins.txt care le fixează versiunile și pe care instrumentul o poate actualiza. README-ul imaginii descrie această metodă.
Notificările de build trec prin pluginul Mailer: un build eșuat, un succes după un eșec sau un build care devine instabil declanșează un e-mail. Serverul de trimitere se setează în Manage Jenkins, System, secțiunea E-mail Notification.
Pe un VPS Simafri, trimiterea trece printr-un releu SMTP autentificat, pe portul 587: adresa unui cont de e-mail pe care îl aveți deja sau Simafri Suite. În opțiunile avansate, bifați Use SMTP Authentication cu numele de utilizator și parola contului, apoi Use TLS: pluginul folosește atunci portul 587. Opțiunea Test configuration by sending test e-mail trimite un mesaj de test.
Documentația consideră backupurile controlerului de o importanță critică: ele servesc la recuperarea după un dezastru, la recuperarea unei configurații modificate din greșeală sau a unui fișier corupt sau șters. Totul se află în JENKINS_HOME: /var/jenkins_home în imaginea Docker, /var/lib/jenkins cu pachetele.
| Element | Ce păstrează | De salvat |
|---|---|---|
*.xml, inclusiv config.xml | Configurația principală și configurația sistemului | Obligatoriu |
jobs/ | Joburile și istoricul buildurilor; în builds/archive, artefactele arhivate | Obligatoriu; artefactele după nevoie, ele devin voluminoase |
plugins/*.jpi | Pluginurile instalate, în versiunile lor | Recomandat, pentru o restaurare identică |
secrets/ | Cheile care criptează datele de acces | Directorul, cu excepția master.key, păstrat separat |
workspace/ | Fișierele preluate din controlul versiunilor pentru builduri | Facultativ: o nouă preluare le recreează |
war/, cache/, tools/ | WAR-ul despachetat, instrumentele descărcate și extrase | Facultativ: recreate după nevoie |
Documentația cere să nu puneți niciodată cheia principală în backupul obișnuit. secrets/master.key criptează cheia care vă protejează datele de acces: cine deține backupurile dumneavoastră și această cheie poate citi totul. Copiați-o o singură dată și păstrați-o separat, într-un loc foarte sigur, ca pe o cheie privată SSH; o restaurare completă are nevoie de ea.
README-ul imaginii cere să tratați jenkins_home ca pe o bază de date. Opriți Jenkins pe durata copierii, apoi arhivați volumul cu un container temporar, după metoda din documentația 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
O copie făcută cu serviciul oprit este coerentă. Pentru un backup fără oprire, documentația indică instantaneele sistemului de fișiere, LVM, btrfs sau ZFS, mai coerente și mai rapide decât o copie la cald; dintre pluginurile de backup open source, ea îl numește pe thinBackup ca singurul încă întreținut. Dați fiecărei copii un nume datat, evitați /tmp, care poate fi golit la repornire, și trimiteți copiile finalizate pe un server la distanță.
Puse pe discul serverului, aceste arhive intră și în backupurile sale de noapte.
Documentația cere să validați fiecare backup și dă metoda simplă: restaurați-l într-un director temporar, puneți la loc master.key și porniți pe el un al doilea Jenkins de aceeași versiune, pe alt port:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Înaintea fiecărei actualizări a nucleului, citiți pagina LTS-ului țintă din ghidurile de actualizare ale proiectului: fiecare secțiune tratează trecerea de la LTS-ul precedent. Pentru 2.580.2, ea nu enumeră nicio schimbare notabilă. Pentru 2.580.1, ea notează că mai multe pluginuri desprinse din nucleu nu mai sunt incluse în WAR: Jenkins le instalează singur când Update Center este accesibil. Salvați apoi JENKINS_HOME și actualizați:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; Jenkins rămâne software-ul dumneavoastră, cu pipeline-urile, setările și datele sale.
| Subiect | Echipele noastre | Dumneavoastră |
|---|---|---|
| Serverul | Actualizări de sistem și de securitate, intervenții pe server incluse | Momentul potrivit activității dumneavoastră |
| Monitorizarea | Server urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelul | Citirea jurnalelor instanței și ale buildurilor dumneavoastră |
| Jenkins | Urmărire proactivă: erori, încetiniri și spațiu pe disc depistate, corectură recomandată | Instalarea, actualizările, pluginurile și setările sale, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI |
| Pipeline-urile și agenții | Serverele care le poartă, supravegheate și salvate | Joburile, agenții, conturile, permisiunile și datele de acces |
| Backupurile | În fiecare noapte, criptate și păstrate în afara mașinii; restaurare inclusă | Arhivele proprii Jenkins, fișierul master.key și cererea de restaurare, când aveți nevoie de ea |
| Migrarea | Serverul dumneavoastră actual migrat, gratuit | Momentul trecerii |
Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.
Cu un Managed VPS Simafri, echipele noastre țin la zi serverul instanței dumneavoastră Jenkins, îl monitorizează zi și noapte și intervin fără a vă aștepta apelul; ele vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI. Backupurile sunt criptate în fiecare noapte și păstrate în afara mașinii, restaurarea lor este inclusă, iar migrarea serverului actual este gratuită.
Da. Jenkins este sub licență MIT: îl puteți folosi, modifica și rula în firmă fără nicio licență de cumpărat, cu condiția să păstrați mențiunea sa de copyright și de licență. Rămâne costul serverelor care poartă controlerul și agenții.
Linia LTS, pe care documentația o prezintă ca pregătită pentru producție: 2.580.2 la 28 octombrie 2026. Ea cere Java 21 sau Java 25. O nouă bază LTS este aleasă la fiecare 12 săptămâni, iar fiecare bază primește trei versiuni de corecturi.
Folosiți imaginea oficială jenkins/jenkins cu o etichetă LTS, precum lts-jdk25, și un volum numit montat pe /var/jenkins_home. Puneți în față un proxy invers în HTTPS, de exemplu Caddy în același fișier compose.yaml, apoi setați adresa publică drept URL Jenkins.
În jurnalul de pornire și în fișierul secrets/initialAdminPassword din JENKINS_HOME: /var/jenkins_home cu imaginea Docker, /var/lib/jenkins cu pachetele. Lipiți-o pe pagina Unlock Jenkins, apoi creați-vă propriul cont de administrator.
Documentația recomandă să le rulați pe agenți: pe nodul integrat, un build are același acces la fișierele controlerului ca Jenkins. Conectați un agent, prin SSH sau WebSocket, apoi setați la 0 executorii nodului integrat.
Serviți-o în HTTPS în spatele unui proxy invers, treceți la securitatea pe matrice, rezervați Overall/Administer persoanelor de încredere, păstrați activă protecția CSRF, rulați buildurile pe agenți și aplicați fără întârziere versiunile LTS care aduc corecturi de securitate.
Arhivați JENKINS_HOME, cu serviciul oprit sau printr-un instantaneu al sistemului de fișiere. Țineți secrets/master.key în afara acestui backup, păstrat separat într-un loc foarte sigur, și validați fiecare backup restaurându-l pe un Jenkins de test pornit pe alt port.
Un Managed VPS acoperă serverul: sistemul, securitatea, monitorizarea și backupurile. Echipele noastre vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră. O intervenție în aplicație se facturează la oră sau la preț fix.
Simafri
Să discutăm despre site-ul dumneavoastră
Povestiți-ne despre proiectul dumneavoastră în câteva cuvinte: vă vom răspunde rapid.
Mulțumim! Cererea dumneavoastră a fost trimisă. Vă vom răspunde în curând.
Preferați e-mailul? Scrieți-ne la support@simafri.com.