Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- projekt:python_fastapi [2026/02/21 07:48] – torsten.roehl
+++ projekt:python_fastapi [2026/02/23 07:26] (aktuell) – [Systemd] torsten.roehl
@@ Zeile 3: / Zeile 3: @@
 [[raspberry_pi:einstiegskurs_raspberry_pi|☚ zurück - Einstiegskurs Raspberry Pi]]
+//In diesem Projekt wird auf dem Raspberry Pi eine Weboberfläche mit FastAPI erstellt, über die eine LED-Ampel geschaltet und die Temperatur eines DS18B20 angezeigt werden kann. Die Anwendung ist im lokalen Netzwerk erreichbar, sodass LEDs und Temperatursensor bequem über einen Webbrowser im LAN gesteuert und überwacht werden können.//
+|{{ :raspberry_pi:web_1.png?300 |}}|
+|Die LED-Ampel kann nun über den Webbrowser gesteuert und die Temperatur ausgelesen werden.|
 ====== Überblick ======
   * Voraussetzungen
@@ Zeile 13: / Zeile 18: @@
 ==== ENV ====
-<code bash>
+<note important>
+**Aktivierung der Python-Environment: ''course_env''**
+Alle weiteren Schritte erfolgen mit der aktivierten Python-Umgebung.
+<code>
 source ~/devel/projects/course_env/bin/activate
-pip install fastapi uvicorn RPi.GPIO
 </code>
+</note>
+Anschließend werden FastAPI und Uvicorn installiert:
+<code bash>
+pip install fastapi uvicorn
+</code>
+<note>
+**FastAPI / Uvicorn**
+  * **FastAPI**
+    * stellt das Web-Framework bereit, mit dem die Webseiten und Routen programmiert werden.
+  * **Uvicorn**
+    * startet die Anwendung und sorgt dafür, dass sie im Browser erreichbar ist.
+</note>
 ==== Projektstruktur ====
@@ Zeile 26: / Zeile 51: @@
     ├── app.py
     ├── core/
+    │   |── __init__.py    # kann leer sein!
     │   └── hardware.py
     └── html/
@@ Zeile 33: / Zeile 59: @@
 </code>
 ==== Apache2 Startseite ====
+Im Verzeichnis des Apache2-Webservers (''/var/www/html'') wird eine ''index.html'' bereitgestellt.
+Beim Aufruf der **IP-Adresse des Raspberry Pi im Browser** wird diese Startseite geladen, über die anschließend das gewünschte Projekt ausgewählt werden kann.
+<note tip> **Tip**
+Bevor die neue ''index.html'' im Verzeichnis ''/var/www/html'' erstellt wird, sollte die vorhandene Apache-Standardseite ''index.html'' gesichert werden.
+<code bash>
+sudo mv /var/www/html/index.html /var/www/html/index_course_backup.html
+</code>
+</note>
 <code html /var/www/html/index.html>
@@ Zeile 58: / Zeile 93: @@
 ===== Software =====
+Im folgenden Abschnitt werden die für die Webanwendung benötigten Python- und HTML-Dateien vorgestellt. Dazu gehören die Hardware-Anbindung über GPIO und den Temperatursensor, die HTML-Seiten zur Darstellung im Browser sowie die FastAPI-Anwendung, welche die Routen bereitstellt und die einzelnen Komponenten miteinander verbindet.
 ==== API ====
@@ Zeile 168: / Zeile 203: @@
 <h1>LED Ampel</h1>
-<h2>Rot (Status: {{R}})</h2>
+<h2>Rot</h2>
+<p>Status: {{R}}</p>
 <a href="/led/r/1">ON</a>
 <a href="/led/r/0">OFF</a>
-<h2>Gelb (Status: {{Y}})</h2>
+<h2>Gelb</h2>
+<p>Status: {{Y}}</p>
 <a href="/led/y/1">ON</a>
 <a href="/led/y/0">OFF</a>
-<h2>Grün (Status: {{G}})</h2>
+<h2>Grün</h2>
+<p>Status: {{G}}</p>
 <a href="/led/g/1">ON</a>
 <a href="/led/g/0">OFF</a>
@@ Zeile 240: / Zeile 278: @@
     return html
 @app.get("/led", response_class=HTMLResponse)
 def led_page():
     r, y, g = hardware.status()
     return HTMLResponse(
         load_template("led.html", {
             "{{R}}": r,
             "{{Y}}": y,
-            "{{G}}": g
+            "{{G}}": g,
+            "{{R_ON}}": "on" if r == 1 else "",
+            "{{Y_ON}}": "on" if y == 1 else "",
+            "{{G_ON}}": "on" if g == 1 else "",
         })
     )
 @app.get("/led/{color}/{value}")
@@ Zeile 292: / Zeile 332: @@
 ===== Konfiguration =====
+In diesem Abschnitt wird die Einbindung der **FastAPI-Anwendung** in den Apache-Webserver sowie die Einrichtung als ''systemd-Service'' beschrieben, damit die Anwendung automatisch startet und im lokalen Netzwerk erreichbar ist.
 ==== Apache Proxy ====
 === Konfiguration ===
-In der Datei '' /etc/apache2/sites-available/000-default.conf'', innerhalb von ''<VirtualHost *:80>'' folgendes einfügen:
+In der Datei '' /etc/apache2/sites-available/000-default.conf'',
+innerhalb von ''<VirtualHost *:80>'' folgendes einfügen:
+<note tip> **Tip**
+Bevor die Datei ''/etc/apache2/sites-available/000-default.conf'' geändert wird,
+sollte die vorhandene Konfiguration gesichert werden.
+<code bash>
+cd  /etc/apache2/sites-available/
+sudo  cp 000-default.conf 000-default.conf.course_backup
+</code>
+</note>
 <code bash /etc/apache2/sites-available/000-default.conf>
@@ Zeile 310: / Zeile 365: @@
 === Aktivieren ===
+Damit die Weiterleitung an die FastAPI-Anwendung funktioniert, müssen die benötigten Apache-Module aktiviert und der Webserver neu gestartet werden.
 <code bash>
 sudo a2enmod proxy
@@ Zeile 318: / Zeile 375: @@
 ==== Systemd ====
+Die Service-Datei muss unter ''/etc/systemd/system/course_web.service'' neu erstellt und anschließend bei ''systemd'' registriert werden.
 === Service ===
-<code /etc/systemd/system/python_web.service>
+<code bash /etc/systemd/system/course_web.service>
 [Unit]
 Description=Python Web FastAPI
@@ Zeile 337: / Zeile 395: @@
 </code>
-=== Aktivieren ===
+=== Registrierung ===
+Damit die neu erstellte Service-Datei von ''systemd'' erkannt wird und die Anwendung automatisch beim Systemstart gestartet wird, muss der Dienst neu geladen, aktiviert und gestartet werden.
 <code bash>
 sudo systemctl daemon-reload
-sudo systemctl enable python_web
+sudo systemctl enable course_web
-sudo systemctl start python_web
+sudo systemctl start course_web       # starten
+</code>
+Nützlich:
+<code bash>
+sudo systemctl restart course_web     # neu starten
+sudo systemctl status course_web      # prüfen!!!
 </code>