Deploy di un'applicazione Django su un server remoto

LT
Luca Terribili
Autore

Django è un framework web che si distingue per la sua rapidità di sviluppo: con poche righe di codice è possibile creare una nuova applicazione, definire i modelli di dati e generare automaticamente le migrazioni del database. Questa efficienza è accompagnata da una serie di funzionalità di sicurezza avanzate, tra cui la protezione da SQL injection, Cross‑Site Scripting (XSS) e Cross‑Site Request Forgery (CSRF), tutte attivate di default senza configurazioni aggiuntive. Per questo motivo, Django è una scelta affidabile sia per progetti di piccole realtà che per piattaforme enterprise.

Il valore aggiunto di Django va oltre la fase di sviluppo: è fondamentale capire come portare l’applicazione in un ambiente di produzione. Questa guida ti accompagna passo dopo passo nella configurazione dell’ambiente di sviluppo, nella creazione del progetto, nell’impostazione del database, nel deploy su un server remoto e nella verifica del corretto funzionamento. Troverai consigli pratici per mantenere il servizio stabile, sicuro e facilmente scalabile.

Seguendo le indicazioni fornite, potrai trasformare la tua idea in una soluzione web professionale, pronta a gestire traffico reale e a soddisfare le esigenze di utenti finali e stakeholder.

Prerequisiti: configurazione dell'ambiente di sviluppo e strumenti necessari

Per avviare lo sviluppo con Django è sufficiente disporre di Python (≥ 3.8) installato sul proprio computer. Il gestore di pacchetti pip è incluso nella distribuzione ufficiale di Python; se necessario, può essere attivato con il comando python -m ensurepip --upgrade. Verificare la corretta installazione di entrambi gli strumenti è il primo passo per evitare problemi successivi.

Una volta accertata la presenza di Python e pip, il framework può essere installato con un semplice comando:

pip install django

Se hai bisogno di una versione specifica di Django, aggiungi ==x.y al comando (ad esempio pip install django==4.2). È buona pratica creare un virtual environment per isolare le dipendenze del progetto e garantire che le librerie non interferiscano con altri progetti presenti sulla stessa macchina.

Infine, è consigliabile utilizzare Git per il controllo versione. Git permette di tracciare le modifiche al codice, gestire rami di sviluppo e collaborare con altri sviluppatori in modo efficiente. Puoi installare Git dal sito ufficiale o tramite il gestore di pacchetti della tua distribuzione (ad esempio sudo apt install git su Ubuntu). Con Python, pip, un virtual environment e Git configurati, sei pronto a creare il tuo primo progetto Django.

Creazione del progetto Django

Il primo step consiste nel generare un nuovo progetto Django. Apri il terminale e digita:

django-admin startproject myproject

Questo comando crea la struttura di base del progetto, includendo le impostazioni globali, le URL di livello superiore e il file manage.py per gestire le operazioni di sviluppo. Successivamente, all’interno del progetto, crea una nuova applicazione con:

python manage.py startapp myapp

L’applicazione myapp è il luogo dove definirai modelli, viste e template specifici per le funzionalità della tua web app. Per renderla operativa, aggiungi il suo nome alla lista INSTALLED_APPS presente nel file myproject/settings.py:

INSTALLED_APPS = [
    # altre app di default...
    'myapp',
]

Ora è il momento di definire i modelli in myapp/models.py e le viste in myapp/views.py. Per gestire le rotte dell’app, crea il file myapp/urls.py con il seguente contenuto:

# myapp/urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('myview/', views.myview, name='myview'),
]

Infine, includi le URL della tua app nel file di progetto myproject/urls.py:

# myproject/urls.py
from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('myapp.urls')),
]

A questo punto, il progetto è pronto per essere testato in locale con il comando python manage.py runserver. Se il server si avvia correttamente e la tua vista è raggiungibile, sei pronto a procedere verso il deployment su un server remoto.

Configurazione del database

Per ambienti di produzione, PostgreSQL è la scelta più comune grazie alla sua affidabilità, scalabilità e al supporto avanzato per le transazioni. Dopo aver installato il server PostgreSQL sul nodo remoto, apri il file myproject/settings.py e configura la sezione DATABASES in questo modo:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

È importante creare il database e l’utente associato tramite il client psql. Esegui i seguenti comandi:

CREATE DATABASE mydatabase;
CREATE USER mydatabaseuser WITH PASSWORD 'mypassword';
GRANT ALL PRIVILEGES ON DATABASE mydatabase TO mydatabaseuser;

Una volta creati, applica le migrazioni del progetto con:

python manage.py migrate

Questo comando sincronizza la struttura del database con i modelli definiti nella tua applicazione. Verifica che non compaiano errori e che le tabelle siano state generate correttamente. A questo punto, Django è collegato al database di produzione e pronto per gestire le operazioni di lettura e scrittura.

Deploy dell'applicazione

Preparazione del server

Per il deployment consigliamo di utilizzare una macchina Ubuntu. Aggiorna i pacchetti e installa le dipendenze necessarie:

sudo apt update
sudo apt install python3-pip python3-venv nginx git

Crea un utente dedicato per isolare l’applicazione e limitarne i privilegi:

sudo adduser --disabled-password --gecos "" django_user
sudo usermod -aG sudo django_user

Questo approccio migliora la sicurezza, riducendo il rischio di compromissione dell’intero sistema in caso di vulnerabilità nella tua web app.

Clonazione del repository e setup dell’ambiente virtuale

Accedi all’account dell’utente appena creato e clona il repository contenente il codice del progetto:

sudo -u django_user git clone <repo-url> /home/django_user/myproject
cd /home/django_user/myproject
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Nel file requirements.txt dovrebbero essere presenti almeno Django, gunicorn e psycopg2-binary, in modo da garantire il corretto funzionamento dell’applicazione con PostgreSQL.

Avvio di Gunicorn

Gunicorn è un server WSGI ad alte prestazioni che servirà la tua applicazione Django. Avvialo in modalità daemon collegandolo alla porta locale 8000:

gunicorn myproject.wsgi:application --bind 127.0.0.1:8000 --daemon

Assicurati che il processo rimanga attivo anche dopo il riavvio del server, configurando un servizio systemd se necessario.

Configurazione di Nginx come reverse proxy

Nginx gestirà le richieste HTTP esterne e le inoltrerà a Gunicorn. Crea il file di configurazione /etc/nginx/sites-available/myproject con il contenuto seguente:

server {
    listen 80;
    server_name example.com;   # sostituisci con il tuo dominio

    location /static/ {
        alias /home/django_user/myproject/static/;
    }

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Attiva la configurazione e riavvia Nginx:

sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled/
sudo systemctl restart nginx

A questo punto l’applicazione è accessibile dal dominio configurato e pronta a gestire traffico reale.

Verifica del funzionamento

Una volta completato il deployment, apri il browser e visita l’indirizzo pubblico del server (ad esempio http://example.com). Controlla che la pagina iniziale venga visualizzata correttamente e che tutte le funzionalità della tua app – link, form, pagine dinamiche – operino senza errori. È buona pratica testare su più browser (Chrome, Firefox, Safari) e su diversi dispositivi (desktop, tablet, smartphone) per assicurare una resa uniforme a tutti gli utenti.

Per monitorare lo stato dell’applicazione in produzione, considera l’uso di strumenti di monitoraggio come Prometheus, Grafana, New Relic o Datadog. Queste soluzioni offrono metriche in tempo reale su tempi di risposta, tassi di errore e utilizzo delle risorse di CPU/memoria. Configura alert automatici per essere avvisato in caso di anomalie e implementa una strategia di backup regolare sia per il database che per il codice sorgente.

Infine, verifica i log di Gunicorn e Nginx (/var/log/nginx/error.log, gunicorn.log) per identificare eventuali problemi nascosti. Un monitoraggio continuo e una corretta gestione dei log ti consentiranno di intervenire prontamente, mantenendo l’applicazione stabile e performante.

Vantaggi dell'utilizzo di Django e considerazioni finali

Django combina la rapidità di sviluppo, la sicurezza integrata e un alto grado di personalizzabilità. Grazie a un’architettura modulare, è possibile aggiungere o rimuovere componenti (come middleware o app) con facilità, facilitando la manutenzione e la scalabilità del progetto nel tempo. Inoltre, la vasta comunità e la documentazione completa riducono i tempi di risoluzione dei problemi e favoriscono l’adozione delle best practice del settore.

Il processo di deployment richiede competenze di amministrazione server, come la gestione degli utenti, la creazione di ambienti virtuali, la configurazione di un reverse proxy e l’implementazione di strategie di backup e monitoraggio. Investire tempo nella corretta configurazione di questi aspetti ti garantirà un’applicazione stabile, sicura e pronta a gestire carichi di lavoro crescenti.

In sintesi, Django rappresenta una soluzione robusta per lo sviluppo e il deployment di applicazioni web, capace di accompagnare un progetto dalla fase di prototipo fino a quella di produzione su larga scala. Con le linee guida fornite in questa guida, potrai sfruttare appieno i punti di forza del framework e garantire un’esperienza utente di alta qualità.

← Precedente
Successivo →