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 a[Cloud Noce PaaS](/products/paas)  oppure, dalla cartella del progetto, esegui`gerdoo 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 in`requirements.txt` o`pyproject.toml` . L'applicazione deve essere in ascolto sulla variabile`PORT` e sull'indirizzo`0.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

- Crea un progetto e un ambiente nel pannello Cloud Noce.

- Crea un servizio e seleziona il repository GitHub o GitLab e il branch desiderato.

- Imposta il campo «Comando di avvio» e, se necessario, «Comando di build».

- Imposta i valori`SECRET_KEY` e`DATABASE_URL` nella sezione «Variabili».

- 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 di`gerdoo 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 con`gerdoo status` e`gerdoo 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 e`collectstatic` 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 di`PORT` .

- Per questi dettagli, consulta la[Documentazione PaaS](/support/docs/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.