Docker: Umgebungsvariablen und Secrets konfigurieren

Diese Dokumentation ist Teil des Mit GitHub Actions bereitstellen-Leitfadens. Den vollständigen Leitfaden finden Sie hier: Erfahren Sie, wie Sie Ihre Docker-Container mit GitHub Actions bereitstellen.

👋 Willkommen in der Stackhero-Dokumentation!

Stackhero bietet eine einsatzbereite Docker Cloud CaaS (Containers as a Service) Lösung, die zahlreiche Vorteile bietet, darunter:

• Einfache Bereitstellung Ihrer Container in der Produktion mit nur einem docker-compose up.
• Anpassbarer Domainname gesichert mit HTTPS (zum Beispiel, https://api.ihre-firma.com, https://www.ihre-firma.com, https://backoffice.ihre-firma.com).
• Optimale Leistung und robuste Sicherheit durch eine private und dedizierte VM.
• Mühelose Updates mit nur einem Klick.

Sparen Sie Zeit und vereinfachen Sie Ihr Leben: Es dauert nur 5 Minuten, um die Docker CaaS Cloud Hosting Lösung von Stackhero auszuprobieren und Ihre Container in der Produktion bereitzustellen!

Domainnamen und Zertifikatspasswort abrufen

Damit GitHub Actions sich mit Ihrem Stackhero Docker-Service verbinden kann, benötigen Sie zwei Informationen: den Domainnamen Ihres Services und das Passwort für die Zertifikate.

1. Wählen Sie im Stackhero-Dashboard Ihren "production" Docker-Service aus und klicken Sie auf die Schaltfläche "Configure".

   Service-Einstellungen abrufen

2. Kopieren Sie sowohl den "Domain name" als auch das "Docker certificates password" für die nächsten Schritte.

   Service-Einstellungen abrufen

Domainnamen und Zertifikatspasswort in GitHub hinterlegen

1. Öffnen Sie Ihr Projekt in GitHub.

2. Gehen Sie zu Settings > Environments und klicken Sie auf New environment.

   GitHub-Umgebungen konfigurieren

3. Geben Sie im Feld Name "production" ein und bestätigen Sie.

   Umgebung festlegen

4. Klicken Sie auf die Schaltfläche No restriction und wählen Sie Selected branches and tags.

   Umgebungsrestriktionen festlegen

5. Klicken Sie auf Add deployment branch or tag rule, geben Sie "production" im Feld Name pattern ein und klicken Sie dann auf Add rule.

   Umgebungs-Branch festlegen Umgebungs-Branch festlegen

6. Unter Environment secrets klicken Sie auf Add secret.

   Secret hinzufügen

7. Verwenden Sie für das Secret den Namen STACKHERO_CERTIFICATES_PASSWORD und fügen Sie Ihr Zertifikatspasswort in das Feld Value ein.

   Zertifikatspasswort-Secret festlegen

8. Unter Environment variables klicken Sie auf Add variable.

   Variablen festlegen

9. Verwenden Sie als Namen STACKHERO_ENDPOINT und fügen Sie den Endpoint Ihres Docker-Services in das Feld Value ein. Sie finden diesen Endpoint in Ihrem Stackhero-Dashboard.

   Endpoint-Variable festlegen

Wenn Sie den Domainnamen Ihres Services angepasst haben, denken Sie daran, Ihre eigene Domain anstelle von <XXXXXX>.stackhero-network.com zu verwenden.

Docker Compose-Konfigurationsdatei anpassen

Wenn sich die Datei docker-compose.yml bereits im Root-Verzeichnis Ihres Projekts befindet und Sie keine Anpassungen benötigen, können Sie diesen Abschnitt überspringen.

Standardmäßig sucht GitHub Actions nach der Datei docker-compose.yml im Root-Verzeichnis Ihres Projekts. Falls Sie eine andere Datei oder ein anderes Setup verwenden möchten, können Sie den Deployment-Befehl anpassen. Wenn Sie beispielsweise unser Node.js und Docker Getting Started Boilerplate nutzen, können Sie eine neue Umgebungsvariable namens STACKHERO_DEPLOY_COMMAND anlegen und wie folgt setzen:

docker compose --env-file env.list --file docker/docker-compose.yml --file docker/docker-compose.production.yml up --build --remove-orphans -d