Site-ul cade sau dă 502 la fiecare deploy
La deploy, toate instanțele sunt oprite odată sau se opresc fără să termine cererile în curs, iar load balancer-ul le trimite încă trafic, deci utilizatorii primesc 502/503 câteva secunde sau minute. Folosește rolling sau blue-green deploy, readiness checks, drain la load balancer, graceful shutdown și migrări compatibile cu ambele versiuni.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cea mai frecventă cauză a micilor căderi nu sunt defectele hardware, ci propriile deploy-uri. Variantele: toate instanțele sunt oprite și pornite simultan; procesul se oprește imediat la SIGTERM și taie cererile în curs; load balancer-ul observă oprirea abia după câteva health check-uri eșuate; instanța nouă primește trafic înainte să fie gata (conexiuni la bază, cache-uri încălzite); o migrare de schemă incompatibilă cu versiunea care încă rulează.
Un deploy fără întrerupere are câteva piese: rolling update (câte o instanță, cu maxUnavailable: 0) sau blue-green (mediu nou complet, apoi comutare), readiness probe (trafic doar când instanța e gata), drain / deregistration delay la load balancer, graceful shutdown (termină cererile în curs la SIGTERM) și migrări de bază în doi pași (expand, apoi contract).
Ca plasă de siguranță: canary (versiunea nouă întâi pe 5% din trafic) și rollback rapid.
De ce apare: cauzele frecvente
1Oprire fără graceful shutdown
# aplicația iese imediat la SIGTERMserver.shutdown=graceful
spring.lifecycle.timeout-per-shutdown-phase=30sAplicația nu mai acceptă cereri noi și le termină pe cele în curs înainte să iasă.
2Kubernetes fără readiness și cu toate instanțele înlocuite deodată
strategy:
type: Recreatestrategy:
type: RollingUpdate
rollingUpdate: { maxUnavailable: 0, maxSurge: 1 }
readinessProbe:
httpGet: { path: /actuator/health/readiness, port: 8080 }Instanțele vechi rămân până când cele noi sunt gata să primească trafic.
Repară eroarea, direct în pagină
Răspunde la cele trei întrebări despre erorile apărute la fiecare deploy.
Indiciu
Ce se întâmplă cu cererile aflate în lucru când instanța e oprită?
Reparația
- q1: drain → graceful shutdown → oprire și pornire cu versiunea nouă → readiness → înapoi în rotație.
- q2: Aplicația se oprește imediat la SIGTERM.
- q3: Adevărat.
De ce merge
Un deploy fără întrerupere scoate întâi instanța din rotație, o lasă să termine cererile, iar instanța nouă primește trafic doar după ce e gata. Migrările trebuie să funcționeze cu ambele versiuni.
Alte forme ale mesajului
502 Bad Gateway during deploymentconnect() failed (111: Connection refused) while connecting to upstreamupstream prematurely closed connection
Cum o eviți pe viitor
- Folosește rolling sau blue-green deploy.
- Configurează readiness probe și graceful shutdown.
- Setează un deregistration delay la load balancer.
- Fă migrările de schemă compatibile cu versiunea veche.
- Lansează întâi pe un procent mic de trafic.
Întrebări frecvente
Ce e blue-green?
Două medii identice: unul servește traficul (blue), celălalt primește versiunea nouă (green). După verificare, load balancer-ul comută tot traficul pe green, iar rollback-ul înseamnă comutarea înapoi.
De ce mai apar erori cu rolling update?
De obicei lipsesc graceful shutdown-ul sau readiness probe-ul: instanțele vechi taie cererile în curs sau cele noi primesc trafic prea devreme.
Erori înrudite
502 Bad Gateway Proxy-ul sau load balancer-ul din fața aplicației a primit un răspuns invalid de la server, de obicei pentru că procesul aplicației a căzut, a repornit sau nu ascultă pe portul configurat. Verifici întâi logurile aplicației și ale proxy-ului, apoi health check-ul care trebuie să scoată instanțele moarte din rotație. upstream prematurely closed connection while reading response header from upstream Serverul din spatele nginx a închis conexiunea înainte să trimită răspunsul, deci clientul primește 502. Cel mai des procesul a căzut (excepție netratată, OOM kill) sau a închis o conexiune keep-alive pe care nginx tocmai o refolosea. Caută în logurile aplicației și în `dmesg` exact la momentul erorii. Health checks failed (Target.FailedHealthChecks) Load balancer-ul a marcat instanța ca nesănătoasă pentru că nu a răspuns corect la verificarea periodică (cod greșit, timeout, endpoint inexistent) și nu-i mai trimite trafic. Verifică endpoint-ul de health, timpul de pornire al aplicației și dacă health check-ul depinde inutil de baza de date. CDN-ul servește fișierele vechi după deploy (CSS/JS vechi, pagina stricată) După deploy, CDN-ul (și browserele) au încă în cache versiunea veche a fișierelor cu același nume, iar HTML-ul nou se combină cu JavaScript sau CSS vechi. Folosește nume de fișiere cu hash (cache busting) și TTL lung pentru ele, iar HTML-ul cu revalidare; purge-ul e doar o soluție de urgență. Învață System Design de la zero, cu exerciții la fiecare lecție
Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
