Installation des Django-Web-Frameworks auf Ubuntu 20.04

Hark Labs2022-01-24 · 8 min read

Installation des Django-Web-Frameworks auf Ubuntu 20.04

Django ist ein High-Level-Web-Framework, das die schnelle Entwicklung sicherer und wartbarer Websites ermöglicht. Es ist ein freies und quelloffenes Framework, geschrieben in Python. Django ist auch beliebt für zusätzliche Funktionen wie Leistung, Sicherheit, Skalierbarkeit, Portabilität und Wartbarkeit.

Diese Anleitung wird zeigen, wie man Django installiert und eine einfache Web-App auf Ubuntu 20.04.

Django auf Ubuntu

Es gibt mehrere Möglichkeiten, Django auf dem System zu installieren. Jede Methode eignet sich für ein anderes Ziel.

Globale Installation: Django ist in den offiziellen Ubuntu-Paketquellen leicht verfügbar. Wir können es direkt mit dem APT-Paketmanager installieren. Obwohl diese Installationsmethode einfach ist, bietet sie weniger Flexibilität als andere Methoden. Zudem enthält sie möglicherweise nicht die neueste Version des Frameworks.
Installation mit pip in einer virtuellen Umgebung: Mit Tools wie venv und virtualenv, können wir eine virtuelle Umgebung einrichten und Django dort installieren. Der Vorteil dieses Ansatzes ist, dass er das Gesamtsystem nicht beeinflusst. Er ermöglicht auch projektspezifische Anpassungen und Pakete. Es ist die praktischste und am meisten empfohlene Methode für die Arbeit mit Django.
Installation der Django-Entwicklungsversion: Django ist auch auf GitHub verfügbar. Die neueste Entwicklungsversion enthält die neuesten Funktionen/Fehlerbehebungen. Dies geht jedoch auf Kosten potenzieller Leistungs- und Stabilitätsprobleme.

Diese Anleitung setzt voraus, dass Sie einen ordnungsgemäß konfigurierten Ubuntu-Server haben. Wenn Sie noch keinen Ubuntu-Server haben, können Sie unserer Anleitung folgen, wie Sie Ihren eigenen Ubuntu-Server einrichten.

Django auf Ubuntu installieren

1. Globale Installation mit dem Paketmanager

Django ist in den offiziellen Paketquellen leicht verfügbar. Der Installationsprozess ist recht unkompliziert. Aktualisieren Sie zuerst den APT-Paketindex:

$ sudo apt update

1	$ sudo apt update

Überprüfen Sie als Nächstes die installierte Python-Version. Standardmäßig wird Ubuntu 20.04 mit Python 3.8 ausgeliefert:

$ python3 -V

1	$ python3 -V

Jetzt können wir Django installieren:

$ sudo apt install python3-django

1	$ sudo apt install python3-django

Wir können überprüfen, ob die Installation erfolgreich war. Führen Sie den folgenden Befehl aus, um die Django-Version zu überprüfen:

$ django-admin --version

1	$ django-admin --version

Dies bestätigt, dass Django erfolgreich installiert wurde. Beachten Sie, dass die Django-Version nicht die neueste stabile Version ist. Zum Zeitpunkt der Erstellung dieses Dokuments ist die neueste verfügbare Django-Version v3.2.5 (LTS-Version).

2. Installation von Django mit pip (in einer virtuellen Umgebung)

Dies ist die empfohlene Methode zur Installation von Django, da sie die größte Flexibilität bietet. Wir werden die virtuelle Umgebung mit dem Modul venv erstellen, das Teil der Python 3-Standardbibliothek ist. Es ermöglicht Ihnen, virtuelle Python-Umgebungen zu erstellen und Python-Pakete zu installieren, ohne Änderungen an anderer Stelle im System zu verursachen. Sie können zahlreiche virtuelle Umgebungen mit individuellen Konfigurationen haben.

Fangen wir an. Zuerst benötigen wir die Python- pip und venv-Module:

$ sudo apt update
$ sudo apt install python3-pip python3-venv

1 2	$ sudo apt update $ sudo apt install python3-pip python3-venv

Die Module wurden erfolgreich installiert. Nun erstellen wir ein eigenes Verzeichnis für die virtuelle Umgebung:

$ mkdir -pv ~/sample_project

1	$ mkdir -pv ~/sample_project

Wechseln Sie als Nächstes in das neue Verzeichnis:

$ cd ~/sample_project

1	$ cd ~/sample_project

Jetzt können wir venv anweisen, eine virtuelle Umgebung in dem Verzeichnis einzurichten. Der Name der Umgebung sollte beschreibend sein:

$ python3 -m venv sample_project_env

1	$ python3 -m venv sample_project_env

Das Modul venv erstellt eine Kopie von Python und pip in einer isolierten Verzeichnisstruktur innerhalb des Projektverzeichnisses. Es enthält ein Verzeichnis mit dem gewählten Namen, das die Dateihierarchie enthält, in der alle Pakete installiert werden.

Um zusätzliche Pakete zu installieren, müssen wir die Umgebung aktivieren:

$ source sample_project_env/bin/activate

1	$ source sample_project_env/bin/activate

Die Eingabeaufforderung der Shell sollte sich in etwa so ändern:

Innerhalb der virtuellen Umgebung können wir nun Django installieren:

$ pip install django

1	$ pip install django

Überprüfen Sie, ob die Installation erfolgreich war:

$ django-admin --version

1	$ django-admin --version

Um die virtuelle Umgebung zu verlassen, führen Sie folgenden Befehl aus:

$ deactivate

1	$ deactivate

3. Installation der Django-Entwicklungsversion

Die Django-Entwicklungsversion ist direkt verfügbar auf GitHub. Wir werden git verwenden, um sie in einer virtuellen Umgebung zu klonen und bereitzustellen.

Stellen Sie zunächst sicher, dass die erforderlichen Tools installiert sind. Der folgende Befehl installiert venv und pip (Python-Module) und git:

$ sudo apt update && sudo apt install python3-pip python3-venv git

1	$ sudo apt update && sudo apt install python3-pip python3-venv git

Klonen Sie als Nächstes das Django-Repository. Es enthält alle neuesten Funktionen und Fehlerbehebungen (auf Kosten der Stabilität). Wir klonen es in ein Verzeichnis ~/django-dev:

$ git clone git://github.com/django/django ~/django-dev

1	$ git clone git://github.com/django/django ~/django-dev

Wechseln Sie in das aktuelle Verzeichnis des geklonten Repositories:

$ cd ~/django-dev

1	$ cd ~/django-dev

Erstellen Sie danach eine virtuelle Umgebung mit dem Python-venv-Modul:

$ python3 -m venv sample_project_env

1	$ python3 -m venv sample_project_env

Aktivieren Sie anschließend die virtuelle Umgebung:

$ source sample_project_env/bin/activate

1	$ source sample_project_env/bin/activate

Jetzt können wir das von GitHub geklonte Django installieren. Hier bezieht sich das Flag -e auf den „editable“-Modus, um die Installation aus der Versionsverwaltung zu ermöglichen:

$ pip install -e ~/django-dev

1	$ pip install -e ~/django-dev

Überprüfen Sie abschließend die Installation:

$ django-admin --version

1	$ django-admin --version

Beispiel-Django-Projekt

Bisher haben wir gezeigt, wie man Django auf dem System installiert. Jetzt ist es an der Zeit, Django in die Praxis umzusetzen. In diesem Abschnitt zeigen wir, wie man ein Beispiel-Django-Projekt erstellt. Das Beispielprojekt wird in einer virtuellen Umgebung erstellt.

Erstellen Sie ein Verzeichnis für das Beispielprojekt:

$ mkdir -pv ~/django-test

1	$ mkdir -pv ~/django-test

Wechseln Sie das aktuelle Verzeichnis in das Projektverzeichnis:

$ cd ~/django-test

1	$ cd ~/django-test

Verwenden Sie dann das venv-Modul, um eine virtuelle Python-Umgebung einzurichten:

$ python3 -m venv dummy_env

1	$ python3 -m venv dummy_env

Die virtuelle Umgebung ist bereit. Aktivieren Sie die Umgebung:

$ source dummy_env/bin/activate

1	$ source dummy_env/bin/activate

Wir können Django innerhalb der Umgebung installieren:

$ pip install django

1	$ pip install django

Wir können django-admin verwenden, um die Projektbasis zu erstellen. Hier wird das Beispielprojekt sampleproject genannt. Das Projekt erhält ein Verzeichnis innerhalb des Umgebungsverzeichnisses, das alle erforderlichen Dateien enthält.

manage.py: Ein Verwaltungsskript, das verschiedene Django-spezifische Aufgaben verwaltet.
Beispielprojekt: Ein Verzeichnis mit dem Projektnamen, das den eigentlichen Projektcode enthält.

Wir möchten jedoch kein Gewirr aus zu vielen verschachtelten Verzeichnissen. Weisen Sie Django daher an, die Dateien und Verzeichnisse im aktuellen Verzeichnis abzulegen:

$ django-admin startproject sampleproject .

1	$ django-admin startproject sampleproject .

Der nächste Schritt ist die Migration der Datenbank. Standardmäßig verwendet Django SQLite. Migrationen wenden alle an den Django-Modellen vorgenommenen Änderungen auf das Datenbankschema an. Führen Sie den folgenden Befehl aus, um die Datenbank zu migrieren:

$ python manage.py migrate

1	$ python manage.py migrate

Schließlich erstellen wir einen Admin-Benutzer, um die Django-Admin-Oberfläche zu nutzen. Führen Sie den folgenden Befehl aus:

$ python manage.py createsuperuser

1	$ python manage.py createsuperuser

Es wird nach einem Benutzernamen, einer E-Mail-Adresse und einem Passwort für den Benutzer gefragt.

ALLOWED_HOSTS in den Django-Einstellungen

Um die Anwendung zu testen, müssen wir eine bestimmte Direktive in den Django-Einstellungen ändern. Öffnen Sie die Datei settings.py in einem Texteditor:

$ nano ~/django-test/sampleproject/settings.py

1	$ nano ~/django-test/sampleproject/settings.py

Wir sind an der Direktive ALLOWED_HOSTS interessiert. Sie beschreibt eine Liste von Adressen oder Domainnamen, die eine Verbindung zur Django-Instanz herstellen können. Jede eingehende Host-Anfrage von einem Host, der nicht auf der Liste steht, löst eine Ausnahme aus. Dies wird von Django benötigt, um bestimmte Klassen von Sicherheitslücken zu verhindern.

Tragen Sie in der eckigen Klammer die IP-Adressen oder Domainnamen ein, die dem Django-Server zugeordnet sind. Jeder Eintrag wird in Anführungszeichen gesetzt und durch ein Komma (,) getrennt. So würde die Struktur der Direktive aussehen:

$ ALLOWED_HOSTS = ['<server_ip_or_domain>', '<server2_ip_or_doman>']

1	$ ALLOWED_HOSTS = ['<server_ip_or_domain>', '<server2_ip_or_doman>']

Speichern Sie die Liste und schließen Sie den Editor.

Testen des Servers

Wir können nun den Django-Deployment-Server starten. Er wird ein neues Django-Projekt anzeigen. Beachten Sie, dass er nur für Entwicklungszwecke verwendet werden sollte. Für ein vollwertiges Deployment folgen Sie dem offiziellen Django-Leitfaden für das Deployment.

Stellen Sie vor dem Zugriff auf den Entwicklungsserver sicher, dass die Firewall den Zugriff auf Port 8000. Wenn Sie der Anleitung zur Ubuntu-Server-Einrichtung folgen, weisen Sie UFW an, den Port 8000 für die Kommunikation zu öffnen:

$ sudo ufw allow 8000

1	$ sudo ufw allow 8000

UFW ist eine gängige Firewall, die auf allen gängigen Linux-Distributionen verfügbar ist. Hier ist eine Anleitung, die verschiedene Grundlagen von UFW erklärt. Der Entwicklungsserver ist nun betriebsbereit. Starten Sie den Server:

$ python manage.py runserver <server_ip>:8000

1	$ python manage.py runserver <server_ip>:8000

Rufen Sie als Nächstes die IP-Adresse des Servers auf Port 8000 in einem Webbrowser auf. Sie gelangen auf die Django-Willkommensseite:

$ http://<server_ip>:8000

1	$ http://<server_ip>:8000

Um auf den Django-Adminbereich zuzugreifen, hängen Sie /admin/ am Ende der URL an:

$ http://<server_ip>:8000/admin/

1	$ http://<server_ip>:8000/admin/

Geben Sie den Admin-Benutzernamen und das Passwort ein, um auf den Admin-Bereich zuzugreifen:

Sie können den Server stoppen, indem Sie STRG-C im Terminal drücken.

Schlussgedanken

Das Django-Projekt bietet eine strukturelle Basis für die Gestaltung einer vollständigeren Website. Es stellt die wichtigsten Werkzeuge bereit, die für den Betrieb einer Webanwendung erforderlich sind. Die Nutzung eines Web-Frameworks wie Django ermöglicht Ihnen eine schnellere Projektentwicklung, sodass Sie mehr Zeit für die einzigartigen Aspekte Ihrer Anwendung aufwenden können.

Viel Spaß beim Programmieren!

Hark Labs

Autor · CloudSigma

Preslav Dobrev ist ein kreativer Designer bei CloudSigma und konzentriert sich auf eine konsistente Unternehmensidentität durch traditionelle und innovative Marketingkanäle. Er versteht es meisterhaft, künstlerische Vision mit strategischem Marketing zu verbinden, um wirkungsvolle Markengeschichten zu schaffen.