Git-Deployment einrichten

Mit Git rollst du deinen Code aus einem Repository direkt ins Hosting aus, statt Dateien per FTP hochzuladen. Das Panel klont das Repository und aktualisiert bei jedem Deployment den Ziel-Ordner. Anlegen kannst du das in Plesk unter Git, in cPanel unter Git Version Control.

Voraussetzungen

• Zugang zum Hosting-Panel — siehe Anmeldung am Hosting-Panel.
• Die Repository-URL (z. B. von GitHub oder GitLab). Für private Repositories brauchst du Zugriff, um den Deploy-Schlüssel des Panels dort zu hinterlegen.

Schritt für Schritt

Plesk

1. Melde dich am Plesk-Panel an.
2. Öffne Websites & Domains und wähl die Domain.
3. Klick auf Git.
4. Trage unter Remote-Git-Repository die Repository-URL ein.
5. Leg den Deploy-Pfad fest — meist httpdocs oder ein Unterordner davon.
6. Wähl den Deployment-Modus: automatisch bei jedem Push oder manuell per Klick.
7. Klick auf OK. Bei privaten Repositories hinterlege den angezeigten öffentlichen Schlüssel als Deploy-Key beim Git-Anbieter.

cPanel

1. Melde dich am cPanel an.
2. Öffne im Bereich Files die Git Version Control.
3. Klick auf Create.
4. Aktiviere Clone a Repository und trage die Clone URL ein.
5. Leg unter Repository Path das Zielverzeichnis fest.
6. Klick auf Create. Für das Ausrollen öffne danach Manage und nutze Pull or Deploy.

Deployment vom Document Root trennen

Klone nicht direkt in den öffentlichen Ordner. Besser: ins Repository-Verzeichnis klonen und nur den Build-/Public-Ordner als Document Root setzen. So liegen .git und Quelldateien nicht im Web. Siehe Document Root ändern.

Wenn etwas schiefläuft

Permission denied (publickey) beim Klonen

Das Repository ist privat und der Deploy-Schlüssel des Panels ist beim Git-Anbieter nicht hinterlegt.

Lösung: Den vom Panel erzeugten öffentlichen SSH-Schlüssel als Deploy-Key in den Repository-Einstellungen bei GitHub oder GitLab eintragen. Danach das Klonen erneut auslösen.

Die Dateien landen im falschen Verzeichnis

Der Deploy-Pfad zeigt nicht auf das Verzeichnis, das der Webserver ausliefert.

Lösung: Deploy-Pfad und Document Root abgleichen. Entweder den Deploy-Pfad korrigieren oder das Document Root anpassen.

In cPanel passiert beim Push nichts automatisch

cPanel klont zwar, deployt aber nur, wenn eine .cpanel.yml im Repository die Deployment-Schritte beschreibt.

Lösung: Eine .cpanel.yml mit den Kopier-/Build-Tasks ins Repository legen. Ohne sie bleibt das Ausrollen ein manueller Klick auf Deploy.

Verwandte Artikel

• Node.js-Anwendung einrichten — der typische nächste Schritt nach dem Deployment einer Node-App.
• Document Root ändern — damit der Webserver den richtigen Ordner aus deinem Repository ausliefert.
• SSH-Zugang einrichten — für Deploy-Schlüssel und manuelle Git-Befehle auf dem Server.

Du kommst nicht weiter?

Bleibt das Deployment hängen oder scheitert die Authentifizierung? Ticket im Kundencenter öffnen — nenn die Domain und den Git-Anbieter, wir prüfen den Deploy-Key und den Pfad mit dir.