8 besten TYPO3 Docker Entwicklungsansätze

Docker ist zu einem unverzichtbaren Werkzeug für die moderne Webentwicklung geworden, da es eine konsistente, isolierte und effiziente Umgebung für den Aufbau und das Testen von Anwendungen bietet. Für TYPO3-Entwickler bietet Docker eine leistungsstarke Möglichkeit, lokale Entwicklungsumgebungen schnell einzurichten, Abhängigkeiten einfach zu verwalten und sicherzustellen, dass Projekte zuverlässig auf verschiedenen Systemen laufen. 

In der TYPO3 Community sind mehrere Docker-basierte Ansätze entstanden, die jeweils darauf abzielen, die Entwicklung zu vereinfachen, Arbeitsabläufe zu optimieren und sowohl Anfänger als auch erfahrene Entwickler zu unterstützen. 

In diesem Leitfaden erkunden wir die 8 besten TYPO3 Docker-Entwicklungsansätze sowie Tipps, bewährte Verfahren und zusätzliche Ressourcen, die Ihnen helfen, hochwertige TYPO3-Projekte effizient zu erstellen.

Die Installation von Docker ist unkompliziert und sorgt für konsistente TYPO3-Entwicklungsumgebungen.

Schritt 1: Docker installieren

• Laden Sie Docker Desktop von docker.com herunter.
• Befolgen Sie die Anweisungen für Windows, macOS oder Linux.
• Installation überprüfen:

docker --version
docker-compose --version

Schritt 2: Docker konfigurieren

• Weisen Sie ausreichend CPU, RAM und Speicherplatz zu.
• Aktivieren Sie den automatischen Start, falls gewünscht.

Schritt 3: TYPO3-spezifische Tutorials

• Anfängerfreundliche Anleitung: T3Planet Docker Tutorial

DDEV ist die beliebteste TYPO3 Docker-Lösung für die lokale Entwicklung.

Systemanforderungen:

• Docker >= v18.6
• Docker-Compose >= v1.2
• macOS, Linux, Windows 10

DDEV installieren:

curl -L raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh | bash

TYPO3-Projekt starten:

mkdir my-typo3-site
cd my-typo3-site

ddev config --project-type=typo3 --docroot=public --create-docroot=true
ddev start

ddev composer create "typo3/cms-base-distribution:^10" --prefer-dist
ddev exec touch public/FIRST_INSTALL
ddev launch

martinhelmich/typo3

Schnellstart TYPO3 Docker-Image (nicht produktionsbereit).

Schritte:

webdevops/TYPO3-docker-boilerplate

Voll ausgestattetes Boilerplate mit mehreren Diensten.

Schritte:

git clone github.com/webdevops/TYPO3-docker-boilerplate.git projectname
cd projectname

cp docker-compose.development.yml docker-compose.yml

docker-compose up -d

rm -f app/.gitkeep
composer create-project typo3/cms-base-distribution app/
touch app/public/FIRST_INSTALL app/.gitkeep

t3easy/docker-typo3

Bootcamp-Umgebung für TYPO3-Entwicklung:

• Befolgen Sie die Installationsanleitung: t3easy/docker-typo3

fnagel/docker-typo3

Minimale PHP + Apache Docker-Umgebung für Entwicklung und Produktion:

• Installation über Anleitung: fnagel/docker-typo3

crinis/typo3-docker

Unterstützt die meisten TYPO3 LTS-Versionen.

Schritte:

docker network create typo3-db

docker run -d --volume typo3-mysql:/var/lib/mysql/ --network typo3-db \
 --env MYSQL_DATABASE=typo3 --env MYSQL_USER=typo3 \
 --env MYSQL_PASSWORD=StrongPassword --env MYSQL_ROOT_PASSWORD=StrongPassword \
 --name typo3-mysql mysql:5.7 --character-set-server=utf8mb4 \
 --collation-server=utf8mb4_unicode_ci

docker run -d -p 80:80 --volume typo3:/var/www/html/ --network typo3-db \
 --env TYPO3_DB_HOST=typo3-mysql --env TYPO3_DB_NAME=typo3 \
 --env TYPO3_DB_USERNAME=typo3 --env TYPO3_DB_PASSWORD=StrongPassword \
 --env TYPO3_ADMIN_PASSWORD=StrongPassword \
 --name typo3 crinis/typo3:9.5-php7.2-apache

raaimund/typo3-docker

Leichtgewichtiger Kern für schnelle TYPO3-Installation:

• Verwenden Sie build.bat und run.bat, um TYPO3 schnell zu installieren.

kronova/typo3-docker

Multi-Container-Setup, das mehrere TYPO3 LTS-Versionen unterstützt, skalierbar für Kubernetes oder Cloud-Bereitstellung.

Die Befolgung von Best Practices gewährleistet eine reibungslose, sichere und wartbare TYPO3-Entwicklung mit Docker.

• Verwenden Sie versionsspezifische Docker-Images
  • Wählen Sie immer Docker-Images, die Ihrer TYPO3 LTS-Version entsprechen.
  • Dies gewährleistet die Kompatibilität mit Erweiterungen, Vorlagen und PHP-Anforderungen.
  • Beispiel: crinis/typo3:9.5-php7.2-apache für TYPO3 v9 LTS.
• Speichern Sie persistente Daten in Docker-Volumes
  • Bewahren Sie Datenbankdateien, Uploads und Website-Inhalte in Docker-Volumes auf.
  • Dies verhindert Datenverlust, wenn Container neu erstellt oder aktualisiert werden.

Beispiel:

docker volume create typo3-mysql
docker run -d --volume typo3-mysql:/var/lib/mysql mysql:5.7

• Halten Sie Container leichtgewichtig
  • Vermeiden Sie die Installation unnötiger Tools oder Dienste im TYPO3-Container.
  • Verwenden Sie separate Container für Dienste wie MySQL, Redis oder Elasticsearch.
  • Dies verbessert die Leistung, reduziert die Image-Größe und vereinfacht Updates.
• Planen Sie das Networking für Multi-Container-Setups
  • Verwenden Sie Docker-Netzwerke, um TYPO3-Webcontainer mit Datenbanken und Caching-Diensten kommunizieren zu lassen.

Beispiel:

docker network create typo3-network
docker run -d --network typo3-network --name typo3-db mysql:5.7
docker run -d --network typo3-network --name typo3-web crinis/typo3:9.5-php7.2-apache

• Aktualisieren Sie regelmäßig Images und Abhängigkeiten
  • Halten Sie Docker-Images und TYPO3-Versionen für Sicherheit und Stabilität auf dem neuesten Stand.
  • Testen Sie Updates in einem separaten Entwicklungscontainer, bevor Sie sie in der Produktion anwenden.
• Verwenden Sie Compose-Dateien für Reproduzierbarkeit
  • Docker Compose ermöglicht es Ihnen, Multi-Container-Setups in einer einzigen YAML-Datei zu definieren.
  • Dies stellt sicher, dass jedes Teammitglied die gleiche Umgebung hat.

Die Verwendung von Docker in der TYPO3 Entwicklung kann die Workflows für Continuous Integration (CI) und Continuous Deployment (CD) erheblich vereinfachen.

• Vereinfachte Pipelines

  • Docker stellt sicher, dass dieselbe TYPO3-Umgebung auf lokalen, Staging- und Produktionsservern verwendet wird.
  • Dies beseitigt das Problem „funktioniert auf meinem Rechner“ bei Bereitstellungen.

• Integration mit CI/CD-Tools

  • TYPO3-Projekte, die Docker verwenden, können problemlos in GitHub Actions, GitLab CI, Jenkins oder andere CI/CD-Plattformen integriert werden.

Beispiel mit GitHub Actions:

 jobs:
 build:
   runs-on: ubuntu-latest
   services:
     db:
       image: mysql:5.7
       env:
         MYSQL_ROOT_PASSWORD: root
         MYSQL_DATABASE: typo3
       ports: ['3306:3306']
   steps:
     - uses: actions/checkout@v2
     - name: Set up Docker
       uses: docker/setup-buildx-action@v1
     - name: Build TYPO3 container
       run: docker-compose up -d
     - name: Run tests
       run: ddev exec vendor/bin/phpunit

• Vorteile von CI/CD mit Docker

  • Automatisiertes Testen von TYPO3-Code und -Erweiterungen vor der Bereitstellung.
  • Versionskontrolle von Docker-Images und Umgebungskonfiguration.
  • Schnellere und zuverlässigere Bereitstellungszyklen.

Die Optimierung der Leistung stellt sicher, dass Ihr TYPO3-Projekt sowohl in der Entwicklung als auch in der Produktion reibungslos läuft.

• Verwenden Sie PHP-FPM und NGINX

  • Bevorzugen Sie PHP-FPM mit NGINX-Containern gegenüber Apache für bessere Geschwindigkeit und Skalierbarkeit.

• Aktivieren Sie Caching-Erweiterungen

  • Verwenden Sie TYPO3-Caching-Erweiterungen wie ext:cache oder Redis-Integration während der Entwicklung.
  • Verbessert die Antwortzeiten und reduziert die Containerbelastung.

• Optimieren Sie Container-Ressourcen

  • Weisen Sie ausreichend CPU, RAM und Speicher für TYPO3- und Datenbank-Container zu.
  • Überwachen Sie die Ressourcennutzung, um Verlangsamungen während der Entwicklung oder CI/CD-Läufe zu verhindern.

• Leichte Container

  • Halten Sie Container minimal und trennen Sie Dienste wie Datenbank, Suche (Solr/Elasticsearch) und Caching in dedizierte Container.

Obwohl Docker die TYPO3-Entwicklung vereinfacht, können Anfänger auf einige häufige Probleme stoßen.

• Portkonflikte
  • Fehler: „Port 80 bereits in Gebrauch.“

Lösung: TYPO3-Webcontainer auf einen anderen Port abbilden:

docker run -d -p 8080:80 your-typo3-image

• Datenbankverbindungsfehler
  • Fehler: TYPO3 kann keine Verbindung zu MySQL herstellen.

Lösung: Stellen Sie sicher, dass die Container dasselbe Docker-Netzwerk nutzen und die richtigen Umgebungsvariablen gesetzt sind:

docker network create typo3-net
docker run --network typo3-net --name typo3-db -e MYSQL_ROOT_PASSWORD=root mysql:5.7
docker run --network typo3-net --name typo3-web -e TYPO3_DB_HOST=typo3-db your-typo3-image

• Berechtigungsprobleme
  • TYPO3 kann nicht in fileadmin oder uploads schreiben.

Lösung: Berechtigungen im Container anpassen:

docker exec -it typo3-web bash
chown -R www-data:www-data /var/www/html/fileadmin
chmod -R 755 /var/www/html/fileadmin

• Container startet nicht / stürzt ab

  Protokolle überprüfen:

  docker logs typo3-web

  • Überprüfen Sie die Docker-Version und die Ressourcenzuweisung (CPU/RAM) für umfangreiche TYPO3-Projekte.

Die Containerisierung entwickelt sich im TYPO3-Ökosystem rasant weiter und ermöglicht skalierbarere, flexiblere und modernere Entwicklungs-Workflows.

• Integration mit Kubernetes

  • TYPO3-Projekte werden zunehmend auf Kubernetes-Clustern bereitgestellt, was automatisches Skalieren, selbstheilende Container und Lastverteilung in der Produktion ermöglicht.
  • Agenturen und Unternehmen profitieren von reduzierten Ausfallzeiten und vereinfachtem Infrastrukturmanagement.

• Headless TYPO3 Setups

  • Docker unterstützt headless TYPO3-Architekturen, bei denen TYPO3 als Backend-CMS fungiert und Inhalte über APIs an moderne Frontends (React, Vue, Angular) oder mobile Apps geliefert werden.
  • Dieser Trend ermöglicht es Teams, flexible, reaktionsschnelle und leistungsstarke Websites oder Apps zu entwickeln, während TYPO3 als Content-Hub beibehalten wird.

• Optimierte Entwicklungs-Pipelines

  • Docker in Kombination mit CI/CD verbessert weiterhin die Automatisierung, das Testen und die Bereitstellung.
  • TYPO3-Entwickler können mehrere Versionen und Erweiterungen ohne Umgebungs-Konflikte verwalten, was groß angelegte Updates reibungsloser macht.

• Wachstum des Ökosystems

  • Open-Source-Projekte wie DDEV, t3easy/docker-typo3 und webdevops/typo3-docker-boilerplate entwickeln sich mit Beiträgen der Community weiter und stellen sicher, dass TYPO3-Docker-Setups modern und effizient bleiben.

Um Ihnen zu helfen, die TYPO3 Docker-Entwicklung weiter zu erkunden, finden Sie hier einige wichtige Ressourcen:

• Offizielle Docker-Dokumentation: https:// docs.docker.com
• DDEV TYPO3-Dokumentation: https:// ddev.readthedocs.io
• Martin Helmich TYPO3 Docker Image: https://github.com/martinhelmich/typo3-docker
• webdevops/typo3-docker-boilerplate: https://github.com/webdevops/TYPO3-docker-boilerplate
• t3easy/docker-typo3: https://github.com/t3easy/docker-typo3
• fnagel/docker-typo3: https://github.com/fnagel/docker-typo3
• Offizielle TYPO3-Tutorials & Anleitungen: https:// docs.typo3.org

Diese Ressourcen sind ideal für Entwickler, die lokale Umgebungen einrichten, verschiedene Docker-Ansätze erkunden oder TYPO3 in moderne Entwicklungs-Workflows integrieren möchten.

Docker hat die Arbeitsweise von TYPO3-Entwicklern revolutioniert, indem es eine konsistente, skalierbare und flexible Umgebung sowohl für die lokale Entwicklung als auch für den Produktionseinsatz bietet. Durch die Nutzung von Docker können Teams die Projekteinrichtung beschleunigen, Konflikte in der Umgebung reduzieren und mehrere TYPO3-Projekte effizient verwalten.

Von Unternehmensagenturen wie T3Planet und Netlogix bis hin zu Bildungseinrichtungen wie der RWTH Aachen University zeigen reale Fallstudien, dass Docker die Zusammenarbeit, die Bereitstellungsgeschwindigkeit und die Gesamtqualität der Projekte verbessert.

Die Zukunft der TYPO3-Entwicklung ist zunehmend containerisiert, mit Trends zu Kubernetes-Bereitstellungen, Headless-Setups und vollständig automatisierten CI/CD-Pipelines. Für Entwickler und Agenturen gleichermaßen stellt die Einführung von Docker einen modernen, effizienten und skalierbaren Arbeitsablauf sicher.

Egal, ob Sie ein TYPO3-Anfänger oder ein erfahrener Entwickler sind, Docker erleichtert es, sich auf den Bau großartiger Websites und Anwendungen zu konzentrieren, während die Infrastruktur und Umgebungsverwaltung nahtlos gehandhabt wird.

Erkunden Sie die Docker-basierte TYPO3-Entwicklung, experimentieren Sie mit verschiedenen Setups und nutzen Sie das reichhaltige Ökosystem von Tools, Vorlagen und Community-Unterstützung, um Ihre TYPO3-Projekte zu verbessern.