Baza de cunoștințe
Întrebări despre Python și aplicații ASGI/WSGI
Răspunsuri documentate despre Python și aplicații ASGI/WSGI. Consultă explicațiile, pașii de verificare și sursele pentru fiecare întrebare.
Răspunsuri documentate
Pot copia un virtualenv Python construit pe laptop direct pe server?
Mediile `venv` nu sunt considerate portabile sau copiable între locații și interpretere, deoarece căile și binarele pot fi legate de sistemul sursă. Recreează mediul pe server din dependențele declarate și verifică versiunea de Python și bibliotecile native.
Surse: venv — Python documentation · Installing Packages — Python Packaging User Guide
De ce nu instalez dependențele aplicației cu sudo pip pe Ubuntu?
Instalarea globală poate intra în conflict cu pachetele gestionate de sistem și poate afecta alte aplicații. Creează un mediu virtual dedicat proiectului și rulează `pip` prin interpreterul acelui mediu.
Surse: Installing Packages — Python Packaging User Guide · venv — Python documentation
Trebuie să fixez exact versiunile în requirements.txt?
Pentru reproducerea unei instalări de aplicație se folosește adesea o listă rezolvată cu versiuni exacte, în timp ce metadatele unui pachet pot exprima intervale suportate. Alege formatul în funcție de rol și regenerează-l controlat când actualizezi dependențele.
Surse: install_requires vs requirements files — Python Packaging User Guide
De ce pip instalează pachetul într-un Python diferit de cel al aplicației?
Comanda `pip` poate aparține altui interpreter sau altui mediu virtual decât cel pornit de server. Folosește `python -m pip` cu calea interpreterului aplicației și verifică `sys.executable` la pornire.
Surse: Installing Packages — Python Packaging User Guide · venv — Python documentation
Cum aleg între WSGI și ASGI pentru o aplicație Python?
WSGI este interfața tradițională pentru aplicații web Python sincronizate, în timp ce ASGI suportă și modele asincrone precum conexiuni de durată. Alege interfața cerută de framework și funcțiile aplicației, apoi folosește un server de producție compatibil, nu serverul de dezvoltare.
Surse: Deployment checklist — Django documentation · Server Workers — FastAPI documentation
De ce Django runserver nu trebuie folosit pe site-ul public?
Documentația Django spune că `runserver` este destinat dezvoltării, nu unui mediu de producție. Folosește un server WSGI sau ASGI pregătit pentru producție și verifică setările prin `manage.py check --deploy`.
Cum investighez o eroare Django fără DEBUG=True în producție?
Păstrează `DEBUG=False` pentru a evita expunerea tracebackurilor și a variabilelor interne vizitatorilor. Configurează logging și raportarea erorilor, apoi reprodu problema într-un mediu protejat cu aceeași configurație relevantă.
De ce Django răspunde cu DisallowedHost în spatele proxy-ului?
Verifică `ALLOWED_HOSTS` pentru hostname-urile reale și validarea headerului Host în proxy. Nu folosi wildcard fără validare suplimentară și confirmă ce valoare Host transmite reverse proxy-ul către aplicație.
Surse: Deployment checklist — Django documentation · Module ngx_http_proxy_module — nginx documentation
De ce fișierele CSS lipsesc după publicarea unei aplicații Django?
În producție, Django colectează fișierele statice în `STATIC_ROOT` prin `collectstatic`, iar un web server sau CDN trebuie să le servească din acel loc. Verifică valorile `STATIC_URL` și `STATIC_ROOT`, permisiunile și rezultatul colectării după deploy.
Surse: Managing static files — Django documentation · Deployment checklist — Django documentation
Cum împiedic serverul web să execute fișiere încărcate de utilizatori?
Fișierele media încărcate sunt input neîncredere și trebuie servite ca fișiere, fără interpretare de cod de către web server. Separă locația media de codul aplicației și testează că fișiere cu extensii executabile nu pot rula.
Cum aleg numărul de worker-e pentru un API FastAPI?
Numărul worker-elor depinde de CPU, memorie, durata operațiilor și felul în care este pornit serverul. Măsoară throughput și latență în mediul real și nu seta automat un worker per nucleu dacă sarcinile sunt limitate de memorie sau backenduri.
De ce o migrare Django blochează aplicația în timpul deploy-ului?
Migrarea poate executa operații de schemă sau poate aștepta blocaje în baza de date, iar impactul depinde de backend și de volumul tabelelor. Testează durata pe o copie reprezentativă, citește SQL-ul generat când este cazul și planifică ordinea compatibilă cu versiunea de cod activă.
De ce Python importă modulul în shell, dar nu din serviciul web?
Procesul serviciului poate folosi alt virtualenv, alt director curent sau alt `PYTHONPATH`. Loghează calea interpreterului și a pachetului fără secrete, apoi corectează comanda de pornire pentru a folosi mediul proiectului.
Surse: venv — Python documentation · Installing Packages — Python Packaging User Guide
De ce pip încearcă să compileze un pachet și eșuează pe server?
Dacă nu există un wheel compatibil, pip poate încerca să construiască pachetul din sursă, ceea ce cere compilator și biblioteci de dezvoltare. Verifică versiunea Python, platforma și dependențele native; build-ul poate fi realizat într-un mediu compatibil înainte de deploy.
Trebuie să las documentația OpenAPI a FastAPI publică?
Documentația API poate dezvălui rute, modele și detalii de implementare, deci decizia depinde de scopul produsului. Dacă este destinată doar echipei, protejează endpointurile de documentație sau dezactivează-le în mediul potrivit fără să afectezi rutele publice ale API-ului.
Cum schimb SECRET_KEY Django fără să invalidez brusc toate sesiunile?
Rotirea cheii poate invalida semnături și tokenuri, iar Django oferă `SECRET_KEY_FALLBACKS` pentru o perioadă de compatibilitate. Păstrează vechile chei doar cât este necesar, apoi elimină-le și verifică toate procesele web și worker-ele.