Bereitstellen mit Docker Compose

Mit dem Apps-Dienst können Sie eine Anwendung mithilfe einer docker-compose.yml-Datei bereitstellen, die sich im Repository befindet. Damit können alle Arten von Anwendungen betrieben werden – einschließlich solcher, die mit Frontend- oder Backend-Frameworks erstellt wurden, die nicht direkt unterstützt werden.

Anforderungen

• Legen Sie die Datei docker-compose.yml im Stammverzeichnis des Repositories ab.

• Verwenden Sie in der Manifest-Datei nicht die Ports 80 und 443 als Host-Ports. Diese Ports sind für Nginx reserviert.

• Das Proxying wird für den ersten Dienst in docker-compose.yml konfiguriert. Weitere Dienste mit definierten Host-Ports sind nur über diese Ports erreichbar. Zum Beispiel:

 

services:
  my-app:
    ports:
      - "9000:80"
  adminer:
    ports:
      - "8080:8080"

 

In diesem Fall:

• • my-app ist über die Hauptdomain erreichbar.
  • adminer ist unter http://<domain>:8080 erreichbar.

In docker-compose.yml definierte Volumes bleiben zwischen Deployments nicht bestehen.

Schritt 1. Anwendungstyp Auswählen

1. Gehen Sie zum Abschnitt App-Plattform und klicken Sie auf „Erstellen“.
2. Wählen Sie den Tab „Docker Compose“.

Schritt 2. Repository Verbinden

Wählen Sie das Repository mit der Anwendung aus. Die docker-compose.yml muss im Stammverzeichnis des Repositories liegen.

Sie können ein Repository verbinden:

• Über Ihr GitHub-, GitLab- oder Bitbucket-Konto. Klicken Sie auf den Plattformnamen, melden Sie sich an und wählen Sie das gewünschte Repository. Wenn Sie bereits angemeldet sind, zeigt Hostman automatisch die verfügbaren Repositories an.

• Per URL, indem Sie einen Link zu einem Repository auf einer beliebigen Plattform angeben. Klicken Sie auf „Repository über URL verbinden“ und geben Sie die Git-URL ein. Ist das Repository privat, geben Sie auch die Zugangsdaten ein.

Weitere Informationen zum Verbinden von Repositories finden Sie hier.

Schritt 3. Branch und Commit Auswählen

Wählen Sie einen Branch für das Deployment aus.

Standardmäßig ist die Option „Build mit dem letzten ausgeführten Commit“ aktiviert. In diesem Fall wird der neueste Commit deployed, und die Anwendung wird bei jedem neuen Commit im Repository automatisch neu erstellt. Wenn nötig, können Sie die automatische Bereitstellung deaktivieren.

Wenn Sie einen bestimmten Commit manuell auswählen möchten, deaktivieren Sie diese Option.

Schritt 4. Serverstandort und Konfiguration Auswählen

Die Anwendung wird auf einem separaten Cloud-Server ausgeführt. Wählen Sie die gewünschte Region und Serverkonfiguration aus.

Ein Upgrade des Servers ist später jederzeit möglich, ein Downgrade jedoch nicht.

Schritt 5. Privates Netzwerk Konfigurieren

Sie können die App jetzt einem privaten Netzwerk hinzufügen und die IP-Adresse angeben, die sie verwenden soll.

Beachten Sie, dass das private Netzwerk nach dem Deployment nicht mehr geändert werden kann.

Schritt 6. Build-Einstellungen Konfigurieren

Die App-Plattform liest die Anweisungen aus docker-compose.yml und baut die Anwendung entsprechend.

Sie können an dieser Stelle Variablen definieren, falls erforderlich. Falls diese bereits in docker-compose.yml oder im Dockerfile definiert sind, müssen sie nicht erneut angegeben werden. Die Variablen werden während des Build-Schritts im Dockerfile verwendet, können aber derzeit nicht in docker-compose.yml übernommen werden.

Später können Sie diese Einstellungen ändern, einen anderen Branch oder Commit auswählen und das Deployment mit den neuen Werten neu starten.

Schritt 7. App-Informationen Eingeben

Hier können Sie einen Namen und einen Kommentar für Ihre Anwendung festlegen, die im Hostman-Dashboard angezeigt werden. Sie können die App auch einem Projekt zuordnen.

Diese Einstellungen können auch nachträglich geändert werden.

Schritt 8. Deployment

Klicken Sie auf „Deploy starten“. Sobald der Prozess beginnt, sehen Sie die Deployment-Logs im Tab „Deploy“.

Das Deploy-Log enthält alle notwendigen Informationen zur Fehlerbehebung. Wenn ein Fehler auftritt – z. B. durch einen Codefehler – wird eine Benachrichtigung mit der Ursache angezeigt.

Beim ersten Deployment eines Projekts kann die Serverinstallation etwas Zeit in Anspruch nehmen. Sobald der Vorgang abgeschlossen ist, wird der Anwendungsstatus aktualisiert und eine entsprechende Nachricht im Log angezeigt.

Fertig!

Sie finden die IP-Adresse der Anwendung sowie die technische Domain im Dashboard-Tab. Um Ihre eigene Domain zu verknüpfen, folgen Sie dieser Anleitung.

Die Anwendung läuft auf den Ports 80 und 443.

In Zukunft überwacht die App-Plattform das Repository. Wenn Autodeploy aktiviert ist, wird die Anwendung bei Änderungen automatisch neu deployed.