Skip to content

README.md

Latest commit

 

History

History
executable file
·
90 lines (63 loc) · 2.88 KB

README.md

File metadata and controls

executable file
·
90 lines (63 loc) · 2.88 KB
Raw

Entwicklungsumgebung

Das Ziel dieser Entwicklungsumgebung ist eine Docker-basierte Lösung auf einem Linux Server analog Devilbox mit den folgenden Vorteilen:

  • One-Click-Installation
  • alle Projekte sind automatisch lokal über projekt.local.example.de erreichbar
  • alle Projekte können nach außen "freigeschaltet" werden inkl. SSL, z.B. projekt.dev.example.de
  • jedes Projekt ist gleichzeitig über mehrere PHP Versionen aufrufbar, z.B. projekt.dev.example.de:8074 (PHP 7.4)
  • VS Code Remote inkl. Xdebug
  • VS Code im Browser
  • Mailhog

Installation (ohne Proxmox)

bash <(curl -sL https://contao4you.de/webdev-setup)

Weitere Schritte

  • Einrichten eines DynDNS Dienstes (falls nicht vorhanden). Z.B. bei ipv64.net.
  • Anlegen eines DNS Eintrages *.local.example.de A 192.168.1.x (IP-Adresse des Web-Containers)
  • Anlegen eines DNS Eintrages *.dev.example.de CNAME example.ipv64.net
  • im Router die DNS Server 1.1.1.1/8.8.8.8 eintragen (zumindest in der Fritzbox)
  • im Router eine Port-Weiterleitung vom Port 80+443 auf den proxy-Container einrichten

Installation in Proxmox

  1. Container "Web"
  • Einen Ubuntu 24.04 Container erstellen
  • Docker installieren
  • Benutzer web erstellen
  • ssh für web freischalten
  • Rechte für web anpassen
  • cd /var
  • git clone https://github.com/c4y/webdev.git
  • sudo docker compose up -d
  1. Container "proxy"
  • Einen Ubuntu 24.04 Container erstellen
  • Docker installieren
  • docker-compose.yml downloaden
  • sudo docker compose up -d

weitere Schritte siehe Installation ohne Proxmox.

Einrichten eines Projektes

In /var/www befinden sich alles, was zur Entwicklungsumgebung gehört. In /var/www/html befinden sich alle Projekte.

Um ein neues Projekt zu starten (z.B. Contao) geht man nun wie folgt vor:

  • cd /var/www/html
  • composer create-project contao/managed-edition contao-test 5.4

Das war's!

Das Projekt ist nun mit allen Endgeräten im lokalen Netzwerk unter http://contao-test.local.example.de erreichbar. Möchte man nun das Projekt öffentlich verfügbar machen, startet man den nginx Proxy Manager. Dieser ist unter der bei der Installation angegebenen IP-Adresse aufrufbar, z.B. http://192.168.1.x/81. Hier richtet man nun einen Proxy Host ein (per GUI). Nun ist die Webseite öffentlich inkl. SSL (Lets Encrypt) erreichbar.

Im Fall von Contao/Symfony muss für den Proxy noch ein Eintrag in der .env erfolgen:

.env.local
TRUSTED_PROXIES=IP-ADRESSE-DES-NGINX-PROXY

Zum Testen der E-Mails/Formulare kann der lokale Mailhog Service genutzt werden:

# .env.local
MAILER_DSN=smtp://egal:egal@IP-ADRESSE-DES-WEB-CONTAINERS:1025

Mailhog ist über http://IP-ADRESSE-DES-WEB-CONTAINERS:8025 erreichbar.

Backup

crontab -e
0 0 * * * /var/www/bin/backup.sh

nginx Proxy Manager

Benutzername: admin@example.com Passwort: changeme

SSH Public Key