readme.md geschrieben und Container auf Docker-Hub

This commit is contained in:
2023-11-14 22:46:47 +01:00
parent d7c581c9ba
commit d6083a10dd
2 changed files with 56 additions and 10 deletions

View File

@@ -1,9 +1,21 @@
# Flask QR-Code-Generator
Sorry folks, because this project startet as experiment for Flask and Docker only german description and manual.
Dieses Programm benötigt Python und das Flask-Framework um einen kleinen Server auf Port 8002 aufzumachen.
HTTP-Server auf Port 8002 mit QR-Code-Generator zur Generierung verschiedener Arten von QR-Codes (Text, URL, Mail, Tel., WIFI, Kalender-Event, vCard, MeCard).
Eigentlich ist das Projekt für mich ein Experimentierfeld gewesen um mal Flask ein bisschen auszuprobieren
## ohne Docker
Um lokal das ganze zu testen werden nur die Dateien aus dem app-Verzeichnis benötigt.
Voraussetzung ist eine funktionierende Python Installation (ich habe nur mit Python 3.11 und 3.12 getestet) und das Flask-Framework inclusive Flask-QRcode welches sich recht einfach über die Konsole mit ...
pip install Flask-QRcode
... installiert alles Notwendige
... installieren lässt.
Zum Starten dann eine der beiden .py Dateien benutzen, je nachdem welcher
HTTP-Modus gewollt ist. Im Zweifelsfall POST... nehmen und wenn ein Doppelklick nicht geht dann halt über die Konsole: `python POST-Flask-QR.py`
Der Server ist dann via http://localhost:8002 zu erreichen
## Docker
Es gibt 2 unterschiedliche Dockerfile's, da obwohl bei beiden python:slim als Basis genutzt wird,
@@ -11,4 +23,32 @@ noch die Installation von ein paar packages zusätzlich notwendig ist, damit fla
dem RaspberryPi 3 via pip install integriert werden kann
## Enviroment-Variablen
- `HTTP_METHOD` GET oder POST (default: POST)
- `HTTP_METHOD` GET oder POST (default: POST)
## Docker
In der Standardeinstellung werden die Formulare mit HTTP-POST-Anfragen gesendet/verarbeitet.
Sollte es Gründe geben, warum gewünscht wird, dass dies der HTTP-GET-Variante zu machen, lässt sich das über die Enviroment Variable HTTP_METHOD ändern.
## Enviroment-Variablen
- `HTTP_METHOD` GET oder POST (default: POST)
## Docker Installation/Start
https://hub.docker.com/r/tebarius/flask-qrcode-generator
### Linux/AMD64
- einfacher Start:
`docker run -d -p 8002:8002 tebarius/flask-qrcode-generator`
erreichbar dann z.B. via http://localhost:8002
- mit HTTP-Methode GET auf Port 80:
`docker run -d -p 80:8002 -e HTTP_METHOD=GET tebarius/flask-qrcode-generator`
erreichbar dann z.B. via http://localhost
### Linux/ARMv7 (getestet mit RaspberryPi 3)
- einfacher Start:
`docker run -d -p 8002:8002 tebarius/flask-qrcode-generator:armv7-latest`
erreichbar dann z.B. via http://localhost:8002
- mit HTTP-Methode GET auf Port80:
`docker run -d -p 80:8002 -e HTTP_METHOD=GET tebarius/flask-qrcode-generator:armv7-latest`
erreichbar dann z.B. via http://localhost