Calitatea hostingului dă valoare site-ului tău.

Containere și deploy · Ghid practic

Healthcheck și restart în Docker Compose: ce repară fiecare

Un proces pornit nu înseamnă neapărat că aplicația poate servi cereri. Înțelege diferența dintre healthcheck, dependențe și restart policy și proiectează verificări care detectează probleme reale fără bucle de restart.

Procesul activ nu confirmă aplicația sănătoasă

Un container poate rula, iar procesul principal poate exista, deși aplicația nu poate conecta baza de date sau nu răspunde pe endpointul necesar. Un healthcheck adaugă o probă periodică și clasifică starea serviciului în funcție de rezultatul acelei probe. Testul ar trebui să confirme funcția relevantă, nu doar să găsească un proces cu un anumit nume.

Alege endpointul cu grijă. O verificare simplă poate testa că serverul web răspunde, în timp ce o verificare mai completă poate confirma dependențe esențiale. Dacă testul include fiecare serviciu extern, o indisponibilitate din afara aplicației poate marca întregul container ca nesănătos și poate genera alarme în cascadă.

Configurează intervalul, timeout-ul și numărul de încercări după timpul normal de pornire și comportamentul aplicației. Testează și cazul de pornire lentă; dacă healthcheck-ul este prea agresiv, o aplicație validă poate fi marcată înainte să termine inițializarea.

Healthcheck-ul și restart policy au roluri diferite

În Compose, healthcheck-ul raportează starea serviciului, iar politica `restart` controlează ce se întâmplă când procesul containerului se termină. O stare `unhealthy` nu înseamnă automat că orice configurație va recrea sau reporni containerul. Nu proiecta recuperarea presupunând că simpla declarare a verificării rezolvă incidentul.

Restart policy precum `on-failure` sau `unless-stopped` poate fi utilă dacă procesul se închide și este sigur să pornească din nou. Dacă procesul rămâne blocat fără să iasă, restartul nu se declanșează doar pentru că endpointul eșuează, în funcție de runtime și orchestrare. Monitorizarea trebuie să alerteze, iar recuperarea să fie definită explicit.

Un restart loop poate șterge indicii și poate repeta operații parțiale. Păstrează logurile, codul de ieșire și timestampurile și verifică dependențele, volumele, variabilele și limitele resurselor înainte de a schimba politica.

Ordinea de pornire nu este disponibilitate

`depends_on` exprimă relația de dependență și ordonarea serviciilor, dar pornirea containerului bazei de date nu dovedește că serverul este pregătit să accepte interogări. Compose poate folosi starea `service_healthy` atunci când serviciul dependent are un healthcheck definit pentru dependență.

Chiar și cu healthcheck, aplicația trebuie să trateze întreruperile ulterioare. Baza poate reporni după ce aplicația a pornit, rețeaua poate avea o eroare temporară sau conexiunile pot expira. Adaugă retry limitat cu backoff și erori observabile, evitând reîncercări infinite care ocupă procese fără să informeze operatorul.

Verifică starea la nivelul fluxului real: un răspuns de healthcheck nu confirmă automat că autentificarea, căutarea ori checkout-ul funcționează. Folosește teste separate pentru dependențe și pentru experiența vizitatorului.

Testează scenariile de eșec și revenire

În staging, oprește temporar o dependență, întârzie pornirea ei sau furnizează o configurație greșită controlată. Observă dacă aplicația raportează clar starea și dacă revine după remediere fără intervenții manuale ascunse. Nu executa experimente distructive în producție fără un plan de revenire.

Păstrează logurile containerului și ale serviciilor de pe gazdă, deoarece healthcheck-ul arată rezultatul probei, nu neapărat cauza. După deploy, verifică statusul fiecărui serviciu, endpointurile publice, conexiunea la baza de date și rata de restarturi. Documentează cine primește alerta și ce verificări urmează.

Întrebări frecvente

Healthcheck-ul repornește un container unhealthy?

Nu automat în orice mediu. Healthcheck-ul evaluează și marchează starea; politica de restart și orchestrarea au comportamente separate.

Ce verifică un healthcheck bun?

Un semnal relevant pentru disponibilitatea aplicației, suficient de simplu și rapid. Verificările profunde ale tuturor dependențelor pot provoca alarme în cascadă.

De ce aplicația pornește înaintea bazei?

Ordinea de pornire nu este același lucru cu pregătirea bazei pentru conexiuni. Folosește healthcheck și retry controlat în aplicație.

Surse și documentare

Explicație editorială generală, bazată pe documentația de mai jos. Configurația concretă și condițiile furnizorului pot diferi. Documentare: 22 noiembrie 2026.