Găzduirea Jenkins® pe un Managed VPS: buildurile pe propriul server

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.

Simon Vasconcelos Lee Autor: Publicat la 16 noiembrie 2026Timp de citire: 15 minute

Toate ghidurile

Esențialul

  1. Licența MIT permite folosirea liberă a Jenkins în firmă, cu condiția să păstrați mențiunea sa de licență. Numele ține separat de politica de marcă adoptată de proiect, cea a Linux Foundation.
  2. Alegeți linia LTS: 2.580.2 la 28 octombrie 2026, care rulează pe Java 21 sau Java 25. O nouă bază LTS este aleasă la fiecare 12 săptămâni.
  3. Instalați-l cu imaginea oficială 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.
  4. Rulați buildurile pe agenți și setați la 0 executorii controlerului. Acordați permisiunile cu securitatea pe matrice și păstrați activă protecția CSRF.
  5. Salvați JENKINS_HOME, păstrați separat secrets/master.key și citiți ghidul de actualizare al fiecărei LTS înainte de a o aplica.

Ce face Jenkins

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.

Licența MIT și marca

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.

LTS sau versiunea săptămânală: ce versiune să instalați

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.

LinieLa 8 noiembrie 2026Ritm
LTS2.580.2 din 28 octombrie 2026, după 2.580.1 din 30 septembrieTrei 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.589O 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.

Instalarea cu Docker Compose

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

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
}
Terminal
docker compose up -d

Dimensionarea serverului

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.

Cu pachetele Debian sau Ubuntu

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

Terminal
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:

Terminal
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:

Suprascrierea serviciului
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"

Cu Nginx și Certbot

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:

Bloc 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 instalează apoi certificatul și se ocupă de reînnoirea lui:

Terminal
sudo certbot --nginx

URL-ul Jenkins și proxy-ul invers

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.

Prima pornire: parola inițială și asistentul de configurare

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:

Terminal, cu Docker Compose
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
Terminal, cu pachetele
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  1. Lipiți această parolă pe pagina Unlock Jenkins.
  2. Alegeți Install suggested plugins, setul pe care documentația îl sfătuiește când nu știți încă bine de ce pluginuri aveți nevoie; celelalte se adaugă ulterior în Manage Jenkins, Plugins.
  3. Creați primul administrator, cu o parolă solidă. Dacă săriți această etapă, contul admin păstrează ca parolă parola de deblocare.
  4. Setați URL-ul Jenkins, ca în secțiunea precedentă.

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.

Buildurile pe agenți, controlerul pentru orchestrare

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

  1. Conectați cel puțin un agent: o altă mașină, un container sau un cloud. Agentul are nevoie de Java și de o conexiune de rețea la controler.
  2. În Manage Jenkins, Nodes, deschideți Built-In Node, apoi Configure, și setați numărul de executori la 0. Faceți acest lucru după ce un agent este în funcțiune, deoarece buildurile așteaptă atunci un agent pentru a porni. Imaginea Docker setează implicit 2.
ConexiuneCumPartea de rețea
SSHControlerul se conectează la agent, cu pluginul SSH Build AgentsNiciun port de deschis pe controler
WebSocketAgentul se conectează la controler prin adresa sa HTTPS, începând cu Jenkins 2.217Niciun port suplimentar: proxy-ul transmite WebSocket
TCP de intrareAgentul se conectează la controler pe un port TCP dedicatUn 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.

Conturile și permisiunile

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:

StrategieCe acordăCând să o alegeți
Anyone can do anythingToate drepturile, chiar și vizitatorilor anonimiDoar pentru un test local
Logged-in users can do anythingToate drepturile fiecărui cont conectat; setarea lăsată de asistentCât timp doar persoane de deplină încredere au un cont
Matrix-based securityPermisiuni acordate pe utilizator sau pe grupPunctul de plecare pe care documentația îl recomandă pentru producție
Project-based Matrix Authorization StrategyAceeași matrice, extinsă proiect cu proiectPentru 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.

Pluginurile și actualizările lor

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 prin e-mail

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.

Backupul JENKINS_HOME

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.

ElementCe păstreazăDe salvat
*.xml, inclusiv config.xmlConfigurația principală și configurația sistemuluiObligatoriu
jobs/Joburile și istoricul buildurilor; în builds/archive, artefactele arhivateObligatoriu; artefactele după nevoie, ele devin voluminoase
plugins/*.jpiPluginurile instalate, în versiunile lorRecomandat, pentru o restaurare identică
secrets/Cheile care criptează datele de accesDirectorul, cu excepția master.key, păstrat separat
workspace/Fișierele preluate din controlul versiunilor pentru builduriFacultativ: o nouă preluare le recreează
war/, cache/, tools/WAR-ul despachetat, instrumentele descărcate și extraseFacultativ: 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.

Cu Docker Compose

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:

Terminal, în directorul fișierului 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
Terminal, o singură dată: cheia principală
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key

Cu pachetele

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

Validarea unui backup

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:

Terminal
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999

Actualizările

Î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:

Terminal, cu Docker Compose
docker compose pull
docker compose up -d
Terminal, cu pachetele
sudo apt update
sudo apt install jenkins

Cine ce face pe un Managed VPS

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.

SubiectEchipele noastreDumneavoastră
ServerulActualizări de sistem și de securitate, intervenții pe server incluseMomentul potrivit activității dumneavoastră
MonitorizareaServer urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelulCitirea jurnalelor instanței și ale buildurilor dumneavoastră
JenkinsUrmă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țiiServerele care le poartă, supravegheate și salvateJoburile, 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
MigrareaServerul dumneavoastră actual migrat, gratuitMomentul 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.

Jenkins, pe un server întreținut pentru dumneavoastră

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

Descoperiți gama Managed VPS

Întrebări frecvente

Este Jenkins gratuit pentru o firmă?

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.

Ce versiune de Jenkins să instalez?

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.

Cum instalez Jenkins cu Docker?

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.

Unde găsesc parola inițială de administrator 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.

Trebuie să ruleze buildurile pe controlerul Jenkins?

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.

Cum securizez o instanță Jenkins?

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.

Cum fac backup la Jenkins?

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.

Acoperă un Managed VPS și Jenkins?

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.

Surse și documentație oficială

Contactați-ne