Clawtronics: Betriebsseite für projektbezogene Plesk-Container angelegt

2026-08-05T10:59:37Z

Betriebsseite für projektbezogene Plesk-Container angelegt

Neue Seite

= Megbes-external unter Plesk =

== Zweck ==

`megbes-external` bildet die öffentlich erreichbare Ebene von MegBes. Auf dem zentralen IONOS-Server wird für jedes Kundenprojekt ein eigener Docker-Container über Plesk betrieben. Die Trennung verhindert, dass projektspezifische Domains, Ports, Konfigurationen und Releases unkontrolliert vermischt werden.

== Voraussetzungen ==

* Projekt ist nach [[Neukunde]] angelegt.
* Passende Konfiguration liegt im privaten Repository `tinetronics/megbes-config` vor.
* Freier externer Port und vorgesehene Domain beziehungsweise Subdomain sind festgelegt.
* Das freigegebene MegBes-Release ist bekannt.
* Adresse und Erreichbarkeit von `megbes-internal` sind geklärt.
* Benötigte Zertifikate sind vorhanden; siehe [[Zertifikate]].

== Grundaufbau je Projekt ==

Für jedes Projekt werden getrennt dokumentiert:

{| class="wikitable"
! Angabe
! Dokumentationsort
|-
| Projekt- und Containername || Projektseite
| Domain oder Subdomain || Projektseite
| externe Portzuordnung || Projektseite
| verwendete Konfigurationsdatei || Projektseite, ohne Geheimwerte
| installierter Release || Projektseite
| Betriebsart und Authentifizierungsvariante || Projektseite
| Adresse des internen Servers || Projektseite
|}

== Ablauf in Plesk ==

# Vorhandene Container prüfen und einen eindeutigen Projektnamen wählen.
# Den für das Projekt freigegebenen Image- beziehungsweise Release-Stand auswählen.
# Projektspezifische Umgebungsvariablen und benötigte Dateimounts eintragen.
# Portzuordnung so wählen, dass sie nicht mit einem bestehenden Container kollidiert.
# Domain oder Subdomain auf den vorgesehenen Container beziehungsweise Port routen.
# Falls erforderlich, Zertifikatsdateien ausschließlich aus der geschützten Ablage einbinden.
# Container starten und Startprotokoll auf Konfigurations-, Port- und Zertifikatsfehler prüfen.
# Erreichbarkeit der öffentlichen Anwendung testen.
# Einen kontrollierten Aufruf bis `megbes-internal` durchführen; siehe [[Routing und Signalweg]].
# Alle nicht geheimen Istwerte auf der Projektseite dokumentieren.

== Erfolgskriterien ==

* Der Container läuft ohne Neustartschleife.
* Die projektbezogene Domain liefert die vorgesehene Anwendung.
* Das Log enthält keine ungelösten Konfigurations- oder Zertifikatsfehler.
* `megbes-external` erreicht den korrekten internen Server.
* Ein Testbefehl erreicht ausschließlich das vorgesehene Projekt.

== Sichere Änderungen und Updates ==

Vor einer Änderung sind Containername, Portbelegung, eingebundene Dateien, Konfiguration und aktueller Release zu erfassen. Updates werden zunächst gegen die projektspezifische Konfiguration geprüft. Ein bestehender Container darf erst ersetzt werden, wenn Rückkehrweg und bisheriger Release bekannt sind.

== Typische Fehler ==

{| class="wikitable"
! Fehlerbild
! Prüfung
|-
| Container startet wiederholt neu || Startlog, Konfigurationsdatei, Mounts und Umgebungsvariablen prüfen.
| Domain ist nicht erreichbar || DNS, Plesk-Routing, Portzuordnung und Containerstatus prüfen.
| Anwendung ist erreichbar, interner Server nicht || Zieladresse, DynDNS, Routerfreigabe und Zertifikate prüfen.
| Falsches Projekt reagiert || Domain-, Port- und Containerzuordnung sofort prüfen; keinen weiteren Funktionstest senden.
| Zertifikatsfehler || Dateipfad, Gültigkeit und Zuordnung nach [[Zertifikate]] prüfen.
|}

== Sicherheitsregeln ==

Passwörter, Tokens, private Schlüssel, geheime Headerwerte und vollständige Zugangsdaten dürfen weder auf der Wiki-Seite noch in Befehlsbeispielen stehen. Das Wiki dokumentiert Bezeichnungen, Ablageorte und Zuständigkeiten, nicht die Geheimwerte selbst.

[[Kategorie:MegBes]]
[[Kategorie:Betrieb]]
[[Kategorie:Plesk]]

Megbes-external unter Plesk - Versionsgeschichte

Clawtronics: Betriebsseite für projektbezogene Plesk-Container angelegt