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

Python și deploy · Ghid practic

Publicarea unei aplicații Python: Django, FastAPI și medii izolate

Un proiect Python de producție nu trebuie pornit cu serverul de dezvoltare sau cu pachetele globale ale sistemului. Ghidul separă mediul virtual, serverul WSGI/ASGI, fișierele statice, secretele și verificările după deploy.

Construiește un mediu Python dedicat aplicației

Creează un `venv` separat pentru fiecare aplicație și instalează pachetele folosind interpreterul din acel mediu. Virtualenv-ul nu este destinat să fie copiat între laptop și server: poate conține căi către interpreter, biblioteci native sau binare de pe sistemul unde a fost creat. Recreează-l la destinație din dependențele proiectului.

Folosește cerințele declarate pentru a face instalarea repetabilă și actualizează pachetele într-un proces separat de deploy. În aplicații, un requirements file poate fixa versiunile rezolvate ale mediului, în timp ce metadatele pachetului pot descrie intervale compatibile. Testează pe aceeași versiune Python și pe o platformă similară cu cea de producție.

Nu instala dependențele aplicației cu `sudo pip` în interpreterul sistemului; acest lucru poate intra în conflict cu pachetele gestionate de distribuție. Verifică `sys.executable` și `python -m pip --version` în build și serviciu pentru a confirma că folosesc același mediu.

Folosește un server WSGI sau ASGI potrivit

Django `runserver` este un server pentru dezvoltare, nu pentru publicarea unui site. Alege un server de producție compatibil cu interfața aplicației: WSGI pentru aplicații sincrone tradiționale sau ASGI când proiectul și funcțiile sale cer model asincron ori conexiuni de durată. Configurează reverse proxy-ul să transmită hostul, schema și calea corectă.

FastAPI folosește ASGI, iar numărul worker-elor trebuie ales după memorie, CPU și caracterul cererilor. Evită să multiplice worker spawning-ul în aplicație și într-un manager extern fără să înțelegi cine pornește procesele. Verifică portul ascultat, health endpoint-ul și comportamentul la SIGTERM.

Aplicația trebuie să ruleze cu setările de producție, fără debug interactiv și fără detalii interne în răspunsuri către public. Pentru Django, rulează `check --deploy` cu configurarea efectivă de producție și revizuiește fiecare avertisment relevant.

Separă setările, secretele și fișierele statice

Păstrează `SECRET_KEY`, DSN-urile și tokenurile în variabile sau fișiere protejate, nu în codul publicat. Django recomandă ca cheia să fie secretă și unică mediului; dacă o rotești, verifică efectul asupra sesiunilor și tokenurilor și folosește mecanismul de chei vechi numai în perioada necesară.

În Django, `collectstatic` copiază fișierele statice către locația configurată prin `STATIC_ROOT`, care trebuie servită separat de procesul aplicației. Testează URL-urile CSS și JavaScript după deploy. Media încărcată de utilizatori este neîncredere: păstreaz-o separată și împiedică serverul să execute fișiere încărcate.

Configurează `ALLOWED_HOSTS`, setările de HTTPS, baza de date, cache-ul și logging-ul pentru mediul real. Dacă serviciul pornește prin systemd, declară căile și mediul necesare în unitate; nu presupune că profilul shell-ului administratorului se aplică procesului web.

Verifică API-ul și procesul după publicare

Un proces poate fi activ, dar să nu răspundă pe portul reverse proxy-ului sau să eșueze la prima interogare a bazei de date. Testează endpointurile local și prin domeniu, verifică statusurile HTTP, logurile și header-ele proxy-ului. Separă problema de aplicație de o problemă de DNS ori firewall prin probe pe fiecare strat.

Pentru API-uri, validează inputul și definește timeout-uri pentru apeluri externe. Monitorizează rata de 4xx și 5xx, latența percentilă și timpul de răspuns al backendurilor; media singură poate ascunde rute defecte. Dacă gateway-ul trimite 429, documentează politica și oferă clienților comportament de retry cu backoff.

Păstrează un release anterior, rulează verificările post-deploy și pregătește procedura de revenire. O revenire de cod nu inversează automat migrarea bazei, fișierele încărcate sau mesajele procesate în fundal; notează aceste limite înainte să fie nevoie de rollback.

Întrebări frecvente

Pot folosi venv-ul de pe calculator pe server?

Nu este considerat portabil; recreează mediul pe server din dependențe și versiunea Python potrivită.

Este sigur Django runserver pentru producție?

Nu. Folosește un server WSGI/ASGI de producție compatibil și verifică setările cu check --deploy.

De ce lipsesc fișierele CSS în Django după deploy?

Verifică dacă ai rulat collectstatic și dacă web serverul servește STATIC_ROOT la calea corectă.

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.