Cloud Noce
Una guida pratica a Python

Come distribuire un progetto Python su Cloud Noce?

Guida pratica al deploy di Django, FastAPI e Flask su PaaS Cloud Noce da Git o Gerdoo CLI, con comandi di build e avvio, variabili, add-on e domini.

risposta breve

Per eseguire il deploy di un progetto Python senza gestire il server, collega il repository Git aCloud Noce PaaS oppure, dalla cartella del progetto, eseguigerdoo deploy . Cloud Noce installa le dipendenze, avvia l'applicazione in un container isolato e fornisce un dominio temporaneo e SSL.

Ultima revisione:6 settembre 2026

Prerequisiti del progetto

Aggiungi le dipendenze inrequirements.txt opyproject.toml . L'applicazione deve essere in ascolto sulla variabilePORT e sull'indirizzo0.0.0.0 e leggere i dati sensibili dalle variabili d'ambiente.

# FastAPI
uvicorn main:app --host 0.0.0.0 --port $PORT

# Django
gunicorn config.wsgi:application --bind 0.0.0.0:$PORT

Metodo 1: deploy da Git

  1. Crea un progetto e un ambiente nel pannello Cloud Noce.
  2. Crea un servizio e seleziona il repository GitHub o GitLab e il branch desiderato.
  3. Imposta il campo «Comando di avvio» e, se necessario, «Comando di build».
  4. Imposta i valoriSECRET_KEY eDATABASE_URL nella sezione «Variabili».
  5. Esegui il deploy e, dopo che l'health check ha avuto esito positivo, collega un dominio personalizzato nella sezione «Domini».

Metodo 2: deploy diretto con Gerdoo CLI

La CLI è adatta a un progetto non ancora collegato a Git o a un deploy da una pipeline CI/CD.

curl -fsSL https://get.gerdoo.cloud/install.sh | sh
gerdoo login
cd my-python-project
gerdoo deploy

La prima esecuzione digerdoo deploy crea il servizio e vi collega la cartella. Le volte successive, lo stesso comando pubblica una nuova versione. Controlla lo stato e i log congerdoo status egerdoo logs .

Database, file e ambiente di produzione

  • Per PostgreSQL, MySQL o Redis, crea un servizio collegato al progetto dalla sezione «Add-on».
  • Per i file multimediali di Django, aggiungi uno storage persistente dalla sezione «Storage» o usa MinIO.
  • Prima di pubblicare in produzione, verifica la migrazione ecollectstatic nel campo «Comando di build».
  • Se il servizio non si avvia, controlla prima i log di build nella sezione «Deploy», poi l'output live nella sezione «Log». Verifica anche il «Comando di avvio» e il valore diPORT .
  • Per questi dettagli, consulta laDocumentazione PaaS .

Domande frequenti

Serve un Dockerfile per eseguire un progetto Python su Cloud Noce?

No. Cloud Noce rileva i progetti Python più comuni dai file requirements.txt e pyproject.toml. Se ti serve un ambiente completamente personalizzato, puoi fornire anche un Dockerfile.

Django, FastAPI e Flask sono supportati?

Sì. Specifica nel repository le dipendenze e il comando per avviare il server web. Per Django si usa di solito Gunicorn, per FastAPI Uvicorn.

È possibile pubblicare un progetto senza una connessione Git?

Sì. Gerdoo CLI comprime la cartella locale ed esegue direttamente il deploy. È una soluzione adatta allo sviluppo locale e alle pipeline CI/CD.

Dove vengono conservati il database e i file caricati?

Collega il database come add-on e conserva i file su un disco persistente o su uno storage compatibile con S3, come MinIO. Il filesystem della versione in esecuzione non è adatto alla conservazione permanente dei dati.