...
Eroare System Design · SPOF, căderi în cascadă, securitate și monitorizare

Site-ul cade sau dă 502 la fiecare deploy

Pe scurt

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

Greșit
# aplicația iese imediat la SIGTERM
Corect
server.shutdown=graceful
spring.lifecycle.timeout-per-shutdown-phase=30s

Aplicaț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ă

Greșit
strategy:
  type: Recreate
Corect
strategy:
  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ă tu

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

Alte forme ale mesajului

  • 502 Bad Gateway during deployment
  • connect() failed (111: Connection refused) while connecting to upstream
  • upstream 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

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

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