So installieren Sie das Django-Webanwendungs-Framework auf Debian 10

Django ist ein Open-Source-Webanwendungs-Framework, das Ihnen hilft, dynamische Websites und Anwendungen zu entwickeln. Es ist sicher, schnell und stabil, was es Ihnen ermöglicht, eine komplexe Website mit weniger Code zu erstellen. Es gibt mehrere Möglichkeiten, Django auf Ihrem System zu installieren. Sie können es über das Debian-Repository, mit PIP oder aus dem Git-Repository installieren. Sie können jede Methode je nach Ihren Bedürfnissen wählen. Django ermöglicht es Ihnen, ein Projekt in Python-virtuellen Umgebungen zu erstellen. Auf diese Weise können Sie mehrere Django-Umgebungen auf einem einzigen System erstellen.

In diesem Tutorial lernen wir, wie man das Django-Web-Framework mit PIP auf Debian 10 installiert. Wir werden auch lernen, wie man eine Django-Anwendung erstellt und sie mit einer Datenbank verbindet.

Voraussetzungen

• Ein Server, der Debian 10 ausführt.
• Ein Root-Passwort ist auf Ihrem Server konfiguriert.

Erste Schritte

Bevor Sie beginnen, aktualisieren Sie Ihr System auf die neueste Version. Sie können dies tun, indem Sie den folgenden Befehl ausführen:

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

Sobald Ihr System aktualisiert ist, starten Sie es neu, um die Änderungen anzuwenden.

Django installieren

Django ist in der Programmiersprache Python geschrieben. Daher müssen Sie die Python-Abhängigkeiten auf Ihrem System installieren, um Django zu installieren. Sie können alle mit dem folgenden Befehl installieren:

apt-get install python3 python3-pip tree -y

Nachdem Sie alle Pakete installiert haben, können Sie die installierte Version von PIP mit dem folgenden Befehl überprüfen:

pip3 -V

Sie sollten die folgende Ausgabe erhalten:

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

Jetzt können Sie mit dem PIP-Befehl wie unten gezeigt Django installieren:

pip3 install Django

Sobald die Installation abgeschlossen ist, überprüfen Sie die Django-Version mit dem folgenden Befehl:

django-admin --version

Sie sollten die folgende Ausgabe sehen:

3.0.2

An diesem Punkt wurde Django auf Ihrem Server installiert. Sie können nun mit dem nächsten Schritt fortfahren.

Ein Django-Projekt erstellen

Jetzt lassen Sie uns ein Beispiel-Django-Projekt erstellen. Zuerst wechseln Sie das Verzeichnis zu /opt, wo Sie ein Django-Projekt erstellen möchten:

cd /opt

Als Nächstes führen Sie den folgenden Befehl aus, um ein neues Django-Projekt namens Dproject zu erstellen:

django-admin startproject Dproject

Sobald das Projekt erstellt wurde, können Sie die Verzeichnisstruktur dieses Projekts mit dem folgenden Befehl sehen:

tree

Sie sollten die folgende Ausgabe erhalten:

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

Als Nächstes wechseln Sie das Verzeichnis zu Dproject und migrieren die ausstehenden Änderungen mit dem folgenden Befehl:

cd Dproject  
python3 manage.py migrate

Sobald die Migration erfolgreich abgeschlossen wurde, sollten Sie die folgende Ausgabe sehen:

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

An diesem Punkt wurde ein neues Django-Projekt im Verzeichnis /opt erstellt.

Erstellen Sie einen Superbenutzer für Django

Als Nächstes müssen Sie einen Superbenutzer für Django erstellen, um auf die Django-Admin-Oberfläche zuzugreifen. Sie können ihn mit dem folgenden Befehl erstellen:

python3 manage.py createsuperuser

Geben Sie Ihren gewünschten Benutzernamen, Ihre E-Mail-Adresse und Ihr Passwort wie unten gezeigt ein:

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

Django-Server starten

Standardmäßig ist Django von einem Remote-System aus nicht zugänglich. Daher müssen Sie Django konfigurieren und Ihre Server-IP definieren. Sie können dies tun, indem Sie die Datei settings.py bearbeiten.

nano /opt/Dproject/Dproject/settings.py

Ändern Sie die folgende Zeile:

ALLOWED_HOSTS = ['your-server-ip']

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind. Starten Sie als Nächstes den Django-Server mit dem folgenden Befehl:

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

Sobald der Server erfolgreich gestartet wurde, sollten Sie die folgende Ausgabe erhalten:

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.

Django-Anwendung aufrufen

An diesem Punkt ist die Django-Anwendung gestartet und hört auf Port 8000. Um darauf zuzugreifen, öffnen Sie Ihren Webbrowser und geben Sie die URL http://your-server-ip:8000 ein. Sie sollten die Django-Anwendung auf dem folgenden Bildschirm sehen:

Um auf die Django-Admin-Oberfläche zuzugreifen, öffnen Sie Ihren Webbrowser und geben Sie die URL http://your-server-ip:8000/admin ein. Sie werden zur Django-Anmeldeseite weitergeleitet:

Geben Sie Ihren Django-Admin-Benutzernamen, Ihr Passwort ein und klicken Sie auf die Schaltfläche Anmelden. Sie sollten die Django-Admin-Oberfläche auf dem folgenden Bildschirm sehen:

MariaDB-Datenbank-Connector installieren

Als Nächstes müssen Sie den MariaDB-Datenbank-Connector und andere Entwicklungs-Pakete installieren, um Django mit der MariaDB-Datenbank zu verbinden. Sie können alle mit dem folgenden Befehl installieren:

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

Sobald alle Pakete installiert sind, können Sie die mysqlclient-Bibliothek mit dem PIP-Befehl wie unten gezeigt installieren:

pip3 install mysqlclient

Sobald die Installation abgeschlossen ist, melden Sie sich mit dem folgenden Befehl an der MariaDB-Shell an:

mysql

Als Nächstes setzen Sie das Root-Passwort für MariaDB mit dem folgenden Befehl.

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

Als Nächstes erstellen Sie eine Datenbank für Django mit dem folgenden Befehl:

MariaDB [(none)]> create database testdb;

Sie können die oben erstellte Datenbank mit dem folgenden Befehl anzeigen:

MariaDB [(none)]> show databases;

Sie sollten die folgende Ausgabe erhalten:

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

Als Nächstes flushen Sie die Berechtigungen und verlassen die MariaDB-Shell mit dem folgenden Befehl:

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

Django für die MariaDB-Verbindung konfigurieren

Als Nächstes müssen Sie die MariaDB-Datenbankanmeldeinformationen in Django definieren. Sie können dies tun, indem Sie die Datei settings.py bearbeiten:

nano /opt/Dproject/Dproject/settings.py

Suchen Sie die folgenden Zeilen:

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

Und ersetzen Sie sie durch die folgenden Zeilen:

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

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind. Bearbeiten Sie dann die MariaDB-Client-Anmeldeinformationsdatei wie unten gezeigt:

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

Definieren Sie Ihre MariaDB-Datenbankanmeldeinformationen wie unten gezeigt:

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

Speichern Sie die Datei und schließen Sie sie, und starten Sie dann den MariaDB-Dienst neu, um die Änderungen zu implementieren:

systemctl restart mariadb

Als Nächstes wechseln Sie das Verzeichnis zum Django-Projekt und migrieren die neuen Änderungen mit dem folgenden Befehl:

cd /opt/Dproject  
python3 manage.py migrate

Sobald die Migration erfolgreich abgeschlossen wurde, können Sie mit dem nächsten Schritt fortfahren.

MariaDB-Verbindung testen

An diesem Punkt ist Django so konfiguriert, dass es mit der MariaDB-Datenbank verbunden ist. Es ist Zeit, dies zu testen.

Um dies zu tun, starten Sie den Django-Server mit dem folgenden Befehl:

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

Sobald der Django-Server erfolgreich gestartet wurde, sollten Sie die folgende Ausgabe erhalten:

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.

Sie können jetzt auf Ihre Django-Anwendung über die URL http://your-server-ip:8000 zugreifen. Sie sollten Ihre Django-Anwendung auf dem folgenden Bildschirm sehen:

Nach dem Testen können Sie den Django-Server jederzeit stoppen, indem Sie CTRL + C in Ihrem Terminal drücken.

Fazit

Herzlichen Glückwunsch! Sie haben Django erfolgreich installiert und mit der MariaDB-Datenbank auf dem Debian 10-Server verbunden. Sie können jetzt mit der Entwicklung Ihrer Webanwendung beginnen und Migrationen in Ihrer Django-Anwendung anwenden. Zögern Sie nicht, mich zu fragen, wenn Sie Fragen haben.