Refactor: Move app to src/, update Dockerfile and detailed README
All checks were successful
Docker Build & Push / build-and-push (push) Successful in 31s
@@ -18,7 +18,7 @@ RUN apt-get clean && rm -rf /var/lib/apt/lists/*
|
||||
WORKDIR /var/www/html
|
||||
|
||||
# Copy application source
|
||||
COPY . /var/www/html/
|
||||
COPY src/ /var/www/html/
|
||||
|
||||
# Set permissions for the web server
|
||||
RUN chown -R www-data:www-data /var/www/html \
|
||||
|
||||
65
README.md
@@ -2,55 +2,72 @@
|
||||
|
||||
Cazubu ist eine Webanwendung zur Verwaltung von Pflanzen, Inventar, Samen und Sensoren.
|
||||
|
||||
## Funktionen
|
||||
- Pflanzenübersicht und Details
|
||||
- Inventarverwaltung
|
||||
- Samen-Datenbank
|
||||
- Sensor-Integration
|
||||
- Benutzerverwaltung (Login/Register)
|
||||
## Projektstruktur
|
||||
Das Projekt ist so aufgebaut, dass der Quellcode vom Deployment-Setup getrennt ist:
|
||||
- **`src/`**: Enthält den gesamten PHP-Quellcode, Assets und Frontend-Ressourcen.
|
||||
- **`Dockerfile`**: Definition des Docker-Images.
|
||||
- **`.gitea/workflows`**: CI/CD-Konfiguration.
|
||||
|
||||
## Installation & Betrieb
|
||||
|
||||
### Voraussetzungen
|
||||
- Docker
|
||||
- Externe MySQL-Datenbank
|
||||
- Docker Engine
|
||||
- Eine laufende MySQL/MariaDB Datenbank
|
||||
|
||||
### Docker Build & Run
|
||||
|
||||
Das Projekt ist für den Betrieb im Docker-Container vorbereitet.
|
||||
|
||||
1. **Image bauen:**
|
||||
```bash
|
||||
docker build -t cazubu .
|
||||
```
|
||||
|
||||
2. **Container starten:**
|
||||
Es müssen die Datenbank-Verbindungsdaten als Umgebungsvariablen übergeben werden.
|
||||
|
||||
2. **Container starten (Produktiv):**
|
||||
Für den produktiven Einsatz sollten Uploads (Bilder) persistent gespeichert werden. Dafür binden wir ein Volume an `/var/www/html/uploads`.
|
||||
|
||||
```bash
|
||||
docker run -d -p 8080:80 \
|
||||
docker run -d \
|
||||
-p 8080:80 \
|
||||
-e DB_SERVER="deine-db-ip" \
|
||||
-e DB_USERNAME="dein-db-user" \
|
||||
-e DB_PASSWORD="dein-db-passwort" \
|
||||
-e DB_USERNAME="cazubu" \
|
||||
-e DB_PASSWORD="dein-sicheres-passwort" \
|
||||
-e DB_NAME="cazubu" \
|
||||
-v cazubu_uploads:/var/www/html/uploads \
|
||||
--name cazubu-app \
|
||||
--restart unless-stopped \
|
||||
cazubu
|
||||
```
|
||||
|
||||
### Umgebungsvariablen
|
||||
|
||||
| Variable | Beschreibung | Standard |
|
||||
|----------|--------------|----------|
|
||||
Die Anwendung wird über Umgebungsvariablen konfiguriert. Wenn diese nicht gesetzt sind, werden interne Fallbacks (für Entwicklung) genutzt.
|
||||
|
||||
| Variable | Beschreibung | Standard (Dev) |
|
||||
|----------|--------------|----------------|
|
||||
| `DB_SERVER` | IP oder Hostname des Datenbankservers | `172.30.242.130` |
|
||||
| `DB_USERNAME` | Datenbank-Benutzer | `cazubu` |
|
||||
| `DB_PASSWORD` | Datenbank-Passwort | (interner Standard) |
|
||||
| `DB_NAME` | Name der Datenbank | `cazubu` |
|
||||
|
||||
### Persistente Daten
|
||||
User-Uploads (Pflanzenbilder) werden im Container unter `/var/www/html/uploads` gespeichert.
|
||||
Um Datenverlust beim Neustart/Update des Containers zu vermeiden, **muss** dieses Verzeichnis als Volume gemountet werden (siehe oben).
|
||||
|
||||
## Entwicklung
|
||||
|
||||
Um lokal zu entwickeln, ohne jedes Mal das Image neu zu bauen, kann der `src`-Ordner direkt in den Container gemountet werden:
|
||||
|
||||
```bash
|
||||
docker run -d \
|
||||
-p 8080:80 \
|
||||
-v $(pwd)/src:/var/www/html \
|
||||
--name cazubu-dev \
|
||||
cazubu
|
||||
```
|
||||
|
||||
## Changelog
|
||||
|
||||
### 2025-12-07 - Dockerisierung
|
||||
- `Dockerfile` erstellt (PHP 8.2 + Apache + MySQLi/GD).
|
||||
- `.dockerignore` hinzugefügt.
|
||||
- CI/CD Pipeline Konfiguration `.gitea/workflows/build-push.yaml` hinzugefügt.
|
||||
- `includes/db_connect.php` angepasst: Unterstützung für Umgebungsvariablen hinzugefügt.
|
||||
- `README.md` erstellt.
|
||||
### 2025-12-07 - Refactoring & Dockerisierung
|
||||
- **Struktur:** Quellcode nach `src/` verschoben für saubereres Root-Verzeichnis.
|
||||
- **Docker:** `Dockerfile` angepasst (kopiert nun `src/`).
|
||||
- **Doku:** `README.md` erweitert um detaillierte Deployment-Infos und Volume-Handling.
|
||||
- **CI/CD:** Pipeline für automatischen Build & Push eingerichtet.
|
||||
|
Before Width: | Height: | Size: 1.0 MiB After Width: | Height: | Size: 1.0 MiB |
|
Before Width: | Height: | Size: 435 KiB After Width: | Height: | Size: 435 KiB |
|
Before Width: | Height: | Size: 768 KiB After Width: | Height: | Size: 768 KiB |
|
Before Width: | Height: | Size: 6.1 MiB After Width: | Height: | Size: 6.1 MiB |