b4758b4f26
- Removed area/ directory with 816MB of media files - Removed sensitive FTP credentials from Git history - Implemented .env.upload system for secure deployments - Added comprehensive .gitignore for future protection This commit represents a clean slate with all sensitive data removed.
108 lines
2.9 KiB
Markdown
108 lines
2.9 KiB
Markdown
# Deployment Scripts
|
||
|
||
Diese Verzeichnis enthält alle Scripts für das Deployment der AdsPreview React Anwendung.
|
||
|
||
## 📁 Scripts Übersicht
|
||
|
||
### `setup.sh` - Initiales Setup
|
||
```bash
|
||
./setup.sh
|
||
```
|
||
- Installiert Frontend Dependencies
|
||
- Erstellt Development Build zum Testen
|
||
- Bereitet Backend-Verzeichnisse vor
|
||
- Erstellt Standard-Konfigurationsdateien
|
||
|
||
### `deploy.sh` - Production Deployment
|
||
```bash
|
||
./deploy.sh
|
||
```
|
||
- Erstellt optimierten Production Build
|
||
- Kopiert alle notwendigen Dateien nach `deployment/build/`
|
||
- Setzt korrekte Dateiberechtigungen
|
||
- Bereitet Upload-ready Struktur vor
|
||
|
||
### `upload.sh` - Webspace Upload
|
||
```bash
|
||
# WICHTIG: Erst .env.upload konfigurieren!
|
||
cp .env.upload.example .env.upload
|
||
# Bearbeite .env.upload mit deinen FTP-Zugangsdaten
|
||
./upload.sh
|
||
```
|
||
- Uploaded `deployment/build/` Inhalt via SFTP/FTP
|
||
- **🔒 SICHER:** Verwendet .env.upload für Zugangsdaten (nicht in Git!)
|
||
- Benötigt `lftp` Tool (`brew install lftp`)
|
||
|
||
## 🚀 Deployment Workflow
|
||
|
||
1. **Einmalig:** Setup ausführen
|
||
```bash
|
||
cd deployment/scripts
|
||
./setup.sh
|
||
```
|
||
|
||
2. **FTP-Zugangsdaten konfigurieren (einmalig):**
|
||
```bash
|
||
cp .env.upload.example .env.upload
|
||
# Bearbeite .env.upload mit deinen echten Zugangsdaten
|
||
```
|
||
|
||
3. **Production Build erstellen:**
|
||
```bash
|
||
./deploy.sh
|
||
```
|
||
|
||
4. **Auf Webspace hochladen:**
|
||
```bash
|
||
./upload.sh
|
||
```
|
||
|
||
## 📦 Deployment-Struktur
|
||
|
||
Nach `deploy.sh` wird folgende Struktur erstellt:
|
||
|
||
```
|
||
deployment/build/
|
||
├── public/ # React App + PHP Entry Points
|
||
│ ├── index.html # React SPA
|
||
│ ├── index.php # PHP Backend Entry
|
||
│ ├── files.php # File Service
|
||
│ └── static/ # React Assets (CSS, JS)
|
||
├── src/ # PHP Backend Code
|
||
│ ├── Api/ # API Controllers
|
||
│ ├── Core/ # Application Core
|
||
│ ├── Helper/ # Utility Functions
|
||
│ └── Services/ # Business Logic
|
||
├── storage/ # Application Data
|
||
│ └── data/ # JSON Storage Files
|
||
└── vendor/ # PHP Dependencies (GetID3)
|
||
```
|
||
|
||
## <20> Sicherheitshinweise
|
||
|
||
### FTP-Zugangsdaten (.env.upload)
|
||
- **NIEMALS** Zugangsdaten direkt ins Script schreiben
|
||
- **IMMER** .env.upload für sensible Daten verwenden
|
||
- .env.upload ist automatisch von Git ausgeschlossen
|
||
- Template: .env.upload.example zeigt die Struktur
|
||
|
||
```bash
|
||
# .env.upload Beispiel:
|
||
FTP_HOST="dein-server.de"
|
||
FTP_USER="dein-username"
|
||
FTP_PASS="dein-passwort"
|
||
FTP_PATH="/htdocs"
|
||
```
|
||
|
||
## 🔧 Anpassungen
|
||
|
||
### nginx Konfiguration
|
||
Siehe `../nginx/` Verzeichnis für Server-Konfiguration.
|
||
|
||
## 💡 Tipps
|
||
|
||
- **Scripts laufen von überall:** Die Scripts erkennen automatisch ihren Standort
|
||
- **Backup:** Sichere vor Upload immer deine Live-Daten
|
||
- **Testing:** Teste zuerst mit `setup.sh` bevor du `deploy.sh` verwendest
|
||
- **Logs:** Scripts geben detaillierte Status-Informationen aus
|