Docker Compose-Bereitstellung

In dieser Anleitung wird die Bereitstellung von HagiCode mit Docker Compose behandelt. Für die meisten Benutzer ist dies der Standardbereitstellungspfad in Entwicklungs-, Test- und Produktionsumgebungen.

Video-Tutorial

Wenn Sie zunächst den gesamten Ablauf sehen möchten, beginnen Sie mit dem Video-Tutorial:

Sehen Sie sich das Video-Tutorial zu Bilibili an

Videoinhalt beinhaltet:

Vollständige Demonstration des Docker Compose-Bereitstellungsprozesses
Anweisungen zum Generieren und Ändern von Konfigurationsdateien
Schritte zum Starten und Verifizieren des Dienstes
Häufige Probleme und Lösungen

Videodauer: ca. 15 Minuten

Über die Standarddatenspeicherung

Die derzeit unterstützten Docker Compose-Vorlagen speichern Daten über den standardmäßigen lokalen SQLite-Pfad. In den meisten Fällen müssen Sie keinen separaten Datenbankdienst auf dem Hostcomputer bereitstellen.

Voraussetzungen

Stellen Sie vor dem Start sicher, dass auf Ihrem System Docker und Docker Compose installiert sind.

Installieren Sie Docker

Windows

Herunterladen und installieren Docker Desktop für Windows

Stellen Sie nach der Installation sicher, dass Docker Desktop ausgeführt wird.

macOS

Herunterladen und installieren Docker Desktop für Mac

Stellen Sie nach der Installation sicher, dass Docker Desktop ausgeführt wird.

Linux

Installieren Sie Docker mit Ihrem Paketmanager:

sudo apt-get update
sudo apt-get install docker.io docker-compose-plugin

Starten Sie nach der Installation den Docker-Dienst:

sudo systemctl start docker
sudo systemctl enable docker

Überprüfen Sie die Installation

Führen Sie nach der Installation die folgenden Befehle aus, um zu überprüfen, ob Docker und Docker Compose korrekt installiert sind:

docker --version
docker compose version

Schnellstart

1. Generieren Sie die Docker Compose-Konfigurationsdatei

Offen Docker Compose Builder (eigenständige Site)
Füllen Sie die Konfiguration entsprechend Ihren Anforderungen aus:
- Wählen Sie einen API-Anbieter (Zhipu AI, Anthropic Official oder Custom API)
- Konfigurieren Sie Ports, Datenbank, Arbeitsverzeichnis und andere Optionen
- Bildquelle auswählen: Wählen Sie die geeignete Bildquelle basierend auf Ihrer Netzwerkumgebung
Klicken Sie auf die Schaltfläche „Generieren“, um das zu erhalten docker-compose.yml Konfiguration
Speichern Sie die generierte Konfiguration als docker-compose.yml Datei
Erstellen Sie bei Bedarf eine .env Datei zum Konfigurieren vertraulicher Informationen

Auswahl der Bildquelle

Der Generator unterstützt drei Bildquellenoptionen:

Docker-Hub

Bildadresse: newbe36524/hagicode:{tag}
Anwendbare Szenarien: Geeignet für Benutzer mit Docker Hub-Spiegelbeschleunigung
Vorteile: Offizielle Bildquelle, zeitnahe Updates, stabiler Zugriff
Hinweise: In einigen Regionen muss möglicherweise die Spiegelbeschleunigung konfiguriert werden

Azure Container Registry (ACR)

Bildadresse: hagicode.azurecr.io/hagicode:{tag}
Anwendbare Szenarien: Geeignet für Benutzer, die nicht lokal auf Docker Hub zugreifen können
Vorteile: Bietet eine alternative Bildquelle und behebt Netzwerkzugriffsprobleme
Hinweise: Bilder bleiben mit Docker Hub synchronisiert, es kann jedoch zu kurzen Verzögerungen kommen

Alibaba Cloud Container Registry (ACR)

Bildadresse: registry.cn-hangzhou.aliyuncs.com/hagicode/hagicode:{tag}
Anwendbare Szenarien: Geeignet für Privatanwender, stabiler und schneller Netzwerkzugriff
Vorteile: Inländische Alibaba Cloud-Knoten, schnelle Zugriffsgeschwindigkeit, hohe Stabilität
Hinweise: Alibaba ACR-Bilder bleiben mit Docker Hub synchronisiert, normalerweise innerhalb von 30 Minuten

2. Starten Sie Dienste

Führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich Ihr docker-compose.yml befindet sich:

docker compose up -d

Dieser Befehl wird:

Laden Sie die durch die generierte Vorlage definierten HagiCode-Container herunter und starten Sie sie
Erstellen und konfigurieren Sie das Netzwerk
Initialisieren Sie das Standarddatenverzeichnis und die Laufzeitabhängigkeiten

3. Überprüfen Sie den Servicestatus

Überprüfen Sie, ob Container ausgeführt werden:

docker compose ps

Die in Ihrer generierten Vorlage definierten Dienste sollten im Status „Wird ausgeführt“ angezeigt werden.

Serviceprotokolle anzeigen

So zeigen Sie alle Serviceprotokolle an:

# View all service logs
docker compose logs

# View HagiCode service logs
docker compose logs hagicode

# Real-time log following
docker compose logs -f hagicode

Konfigurationsanweisungen

Wenn Sie die Konfiguration ändern müssen (z. B. Ports ändern, API-Anbieter wechseln usw.), können Sie Folgendes tun:

Neue Konfiguration mit neu generieren Docker Compose Builder (eigenständige Site)
Manuell bearbeiten docker-compose.yml und .env Dateien
Starten Sie die Dienste neu, damit die Konfiguration wirksam wird:

docker compose restart

Zugriffsanwendung

Webinterface

Nach erfolgreichem Start des Dienstes können Sie über Ihren Browser darauf zugreifen:

http://localhost:45000

Datenpersistenz

Der unterstützte Docker Compose-Pfad verwendet standardmäßig SQLite-Datendateien mit persistenten Volumes. Wenn Sie Bereitstellungspunkte überprüfen oder Sicherungen planen müssen, überprüfen Sie die Volume- und Datenverzeichniszuordnungen im generierten Verzeichnis docker-compose.yml.

Nächste Schritte

Jetzt haben Sie HagiCode erfolgreich bereitgestellt. Verbinden Sie als Nächstes ein reales Projekt im Webinterface und fahren Sie dann mit fort Assistent zum Einrichten oder Erstellen Sie eine Angebotssitzung.

Wenn Sie die Bereitstellungsmethode für Desktop-Anwendungen bevorzugen, lesen Sie bitte Desktop-Installationshandbuch.