Come installare il framework per applicazioni web Django su Debian 10

Django è un framework per applicazioni web open-source che ti aiuta a sviluppare siti web e applicazioni dinamiche. È sicuro, veloce e stabile, il che ti consente di creare un sito web complesso con meno codice. Ci sono diversi modi per installare Django sul tuo sistema. Puoi installarlo utilizzando il repository Debian, usando PIP o dal repository Git. Puoi scegliere qualsiasi metodo a seconda delle tue esigenze. Django ti consente di creare un progetto in ambienti virtuali Python. In questo modo puoi creare più ambienti Django in un singolo sistema.

In questo tutorial, impareremo come installare il framework web Django con PIP su Debian 10. Impareremo anche come creare un’applicazione Django e collegarla a un database.

Prerequisiti

• Un server che esegue Debian 10.
• Una password di root configurata sul tuo server.

Iniziare

Prima di iniziare, aggiorna il tuo sistema con l’ultima versione. Puoi farlo eseguendo il seguente comando:

apt-get update -y  
apt-get upgrade -y

Una volta aggiornato il sistema, riavvialo per applicare le modifiche.

Installa Django

Django è scritto nel linguaggio Python. Quindi dovrai installare le dipendenze di Python sul tuo sistema per poter installare Django. Puoi installarle tutte con il seguente comando:

apt-get install python3 python3-pip tree -y

Dopo aver installato tutti i pacchetti, puoi verificare la versione di PIP installata con il seguente comando:

pip3 -V

Dovresti ottenere il seguente output:

pip 18.1 from /usr/lib/python3/dist-packages/pip (python 3.7)

Ora puoi procedere a installare Django utilizzando il comando PIP come mostrato di seguito:

pip3 install Django

Una volta completata l’installazione, controlla la versione di Django utilizzando il seguente comando:

django-admin --version

Dovresti vedere il seguente output:

3.0.2

A questo punto, Django è stato installato sul tuo server. Puoi ora procedere al passaggio successivo.

Crea un progetto Django

Ora iniziamo a creare un progetto Django di esempio. Prima, cambia la directory in /opt dove vuoi creare un progetto Django:

cd /opt

Successivamente, esegui il seguente comando per creare un nuovo progetto Django chiamato Dproject:

django-admin startproject Dproject

Una volta creato il progetto, puoi vedere la struttura della directory di questo progetto con il seguente comando:

tree

Dovresti ottenere il seguente output:

.
??? Dproject
    ??? Dproject
    ?   ??? asgi.py
    ?   ??? __init__.py
    ?   ??? settings.py
    ?   ??? urls.py
    ?   ??? wsgi.py
    ??? manage.py

Successivamente, cambia la directory in Dproject e migra le modifiche in sospeso con il seguente comando:

cd Dproject  
python3 manage.py migrate

Una volta completata con successo la migrazione, dovresti vedere il seguente output:

Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying sessions.0001_initial... OK

A questo punto, un nuovo progetto Django è stato creato all’interno della directory /opt.

Crea un superutente per Django

Successivamente, dovrai creare un superutente per Django per accedere all’interfaccia di amministrazione di Django. Puoi crearlo con il seguente comando:

python3 manage.py createsuperuser

Fornisci il tuo nome utente desiderato, indirizzo email e password come mostrato di seguito:

Username (leave blank to use 'root'): admin
Email address: [email protected]
Password: 
Password (again): 
Superuser created successfully.

Avvia il server Django

Per impostazione predefinita, Django non è accessibile dal sistema remoto. Quindi dovrai configurare Django e definire l’IP del tuo server. Puoi farlo modificando il file settings.py.

nano /opt/Dproject/Dproject/settings.py

Cambia la seguente riga:

ALLOWED_HOSTS = ['your-server-ip']

Salva e chiudi il file quando hai finito. Successivamente, avvia il server Django con il seguente comando:

cd /opt/Django  
python3 manage.py runserver 0.0.0.0:8000

Una volta avviato correttamente il server, dovresti ottenere il seguente output:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
January 07, 2020 - 13:01:23
Django version 3.0.2, using settings 'Dproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

Accedi all’applicazione Django

A questo punto, l’applicazione Django è avviata e in ascolto sulla porta 8000. Per accedervi, apri il tuo browser web e digita l’URL http://your-server-ip:8000. Dovresti vedere l’applicazione Django nella seguente schermata:

Per accedere all’interfaccia di amministrazione di Django, apri il tuo browser web e digita l’URL http://your-server-ip:8000/admin. Sarai reindirizzato alla pagina di accesso di Django:

Fornisci il tuo nome utente di amministrazione Django, password e fai clic sul pulsante Accedi. Dovresti vedere l’interfaccia di amministrazione di Django nella seguente schermata:

Installa il connettore del database MariaDB

Successivamente, dovrai installare il connettore del database MariaDB e altri pacchetti di sviluppo per collegare Django con il database MariaDB. Puoi installarli tutti utilizzando il seguente comando:

apt-get install mariadb-server python3-dev libmariadb-dev libmariadbclient-dev -y

Una volta installati tutti i pacchetti, puoi installare la libreria mysqlclient utilizzando il comando PIP come mostrato di seguito:

pip3 install mysqlclient

Una volta installato, accedi alla shell di MariaDB con il seguente comando:

mysql

Successivamente, imposta la password di root per MariaDB con il seguente comando.

MariaDB [(none)]> SET PASSWORD FOR 'root'@'localhost' = PASSWORD("newpassword");

Successivamente, crea un database per Django con il seguente comando:

MariaDB [(none)]> create database testdb;

Puoi vedere il database creato sopra utilizzando il seguente comando:

MariaDB [(none)]> show databases;

Dovresti ottenere il seguente output:

+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| testdb             |
+--------------------+

Successivamente, svuota i privilegi e esci dalla shell di MariaDB con il seguente comando:

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

Configura Django per la connessione a MariaDB

Successivamente, dovrai definire le credenziali del database MariaDB in Django. Puoi definirle modificando il file settings.py:

nano /opt/Dproject/Dproject/settings.py

Trova le seguenti righe:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

E sostituiscile con le seguenti righe:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'OPTIONS': {
        'read_default_file': '/etc/mysql/mariadb.conf.d/50-client.cnf',
        },
    }
}

Salva e chiudi il file quando hai finito. Poi, modifica il file delle credenziali del client MariaDB come mostrato di seguito:

nano /etc/mysql/mariadb.conf.d/50-client.cnf

Definisci le tue credenziali del database MariaDB come mostrato di seguito:

[client]
database = testdb 
user = root   
password = newpassword
default-character-set = utf8

Salva e chiudi il file, quindi riavvia il servizio MariaDB per implementare le modifiche:

systemctl restart mariadb

Successivamente, cambia la directory nel progetto Django e migra le nuove modifiche con il seguente comando:

cd /opt/Dproject  
python3 manage.py migrate

Una volta completata con successo la migrazione, puoi procedere al passaggio successivo.

Testa la connessione a MariaDB

A questo punto, Django è configurato per connettersi al database MariaDB. È tempo di testarlo.

Per farlo, avvia il server Django con il seguente comando:

cd /opt/Django  
python3 manage.py runserver 0.0.0.0:8000

Una volta avviato correttamente il server Django, dovresti ottenere il seguente output:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
January 07, 2020 - 13:30:49
Django version 3.0.2, using settings 'Dproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

Puoi ora accedere alla tua applicazione Django utilizzando l’URL http://your-server-ip:8000. Dovresti vedere la tua applicazione Django nella seguente schermata:

Dopo il test, puoi fermare il server Django in qualsiasi momento premendo CTRL + C nel tuo terminale.

Conclusione

Congratulazioni! hai installato con successo Django e lo hai collegato al database MariaDB sul server Debian 10. Puoi ora iniziare a sviluppare la tua applicazione web e applicare le migrazioni nella tua applicazione Django. Sentiti libero di chiedermi se hai domande.