Docker
docmd generiert statisches HTML — perfekt für leichtgewichtige, reproduzierbare Docker-Container.
Dockerfile generieren
docmd deploy --docker
Dies erstellt ein Dockerfile und .dockerignore in Ihrem Projektstammverzeichnis, zugeschnitten auf Ihre Konfiguration:
- Ihr Ausgabeverzeichnis wird im
COPY-Pfad verwendet (nicht hartcodiertsite/) - Ihre exakte
@docmd/core-Version wird im Installationsschritt für reproduzierbare Builds fixiert - Ihre Konfigurationsdatei wird an
docmd buildübergeben, wenn Sie einen nicht-standardmäßigen Namen verwenden
Was generiert wird
Das Dockerfile verwendet einen optimierten Multi-Stage-Build:
- Stage 1 — Build: Installiert Abhängigkeiten mit Layer-Caching (
package.jsonwird zuerst kopiert), installiert die fixierte@docmd/core-Version und führtdocmd buildaus. - Stage 2 — Serve: Kopiert die gebaute Ausgabe in einen minimalen
nginx:alpine-Container.
Benutzerdefiniertes Nginx mit Docker
Wenn Sie eine nginx.conf (via docmd deploy --nginx) vor dem Dockerfile generieren, wird sie automatisch erkannt und im Container konfiguriert.
Bauen und Ausführen
docker build -t my-docs .
docker run -p 8080:80 my-docs
Ihre Dokumentation ist jetzt unter http://localhost:8080 erreichbar.
Neu generieren
Konfiguration geändert? Führen Sie einfach docmd deploy --docker erneut aus — die Dateien werden immer neu generiert, um Ihre aktuelle docmd.config.js widerzuspiegeln.