Deployment-Übersicht

docmd erzeugt eine vollständig statische Website. Die Ausgabe ist ein in sich geschlossener Ordner (Standard: site/), der überall gehostet werden kann — ohne serverseitige Laufzeitumgebung.

npx @docmd/core build

Eine Bereitstellungsmethode wählen

Es gibt drei Hauptwege, je nach Ausgangslage:

Starter-Template

Der schnellste Weg zum Einstieg. Klonen Sie das offizielle Template-Repository — es enthält eine docmd.config.json, eine Beispielseite und einen vorkonfigurierten GitHub-Actions-Workflow, der bei jedem Push zu GitHub Pages bereitstellt.

→ Starter-Template

GitHub Action

Die Action docmd-io/deploy baut Ihre Website und gibt den kompilierten Pfad aus, bereit zum Hochladen auf GitHub Pages oder ein beliebiges anderes Ziel. Verwenden Sie dies, um die docmd-Bereitstellung zu einem bestehenden Repository hinzuzufügen, ohne Ihre Projektstruktur zu ändern.

→ GitHub Action

Deployer

Der Befehl deploy liest Ihre docmd.config.json und erzeugt anbieterspezifische Konfigurationsdateien, die auf Ihr Projekt zugeschnitten sind. Keine generischen Vorlagen — jede Datei spiegelt Ihr tatsächliches Ausgabeverzeichnis, Ihre Site-URL und Ihre SPA-Einstellungen wider.

# Selbstgehostet
npx @docmd/core deploy --docker          # Dockerfile + .dockerignore
npx @docmd/core deploy --nginx           # Produktionsfähige nginx.conf
npx @docmd/core deploy --caddy           # Produktionsfähige Caddyfile

# Cloud / CI
npx @docmd/core deploy --github-pages    # GitHub-Actions-Workflow
npx @docmd/core deploy --vercel          # vercel.json
npx @docmd/core deploy --netlify         # netlify.toml

→ Deployer-Referenz

Cloud-Plattformen

Für verwaltetes Hosting ohne eigenen Server:

• Docker-Image — Offizielles Multi-Arch-Image für containerisierte Bereitstellungen
• NGINX — Selbstgehostet mit generierter Konfiguration
• Caddy — Selbstgehostet mit automatisch aktiviertem HTTPS
• Vercel — Zero-Config-Bereitstellung in der Cloud
• Netlify — Git-verbundene Continuous Deployment
• Cloudflare Pages — Edge-natives Hosting mit eingebauter CI/CD
• Firebase Hosting — Google-CDN mit GitHub-Actions-Integration

Checkliste für die Produktion

1. Site-URL — Setzen Sie url in der docmd.config.json. Diese steuert kanonische Tags, Sitemaps, Social-Previews und generierte Bereitstellungsdateien.
2. Weiterleitungen — Migrieren Sie von einem anderen Tool? Verwenden Sie die redirects-Konfiguration, um SEO-Rankings zu erhalten.
3. Analyse — Aktivieren Sie das analytics-Plugin, um Engagement und Suchanfragen zu verfolgen.
4. KI-Kontext — Aktivieren Sie das llms-Plugin, um eine llms.txt für die Aufnahme durch KI-Agenten zu erzeugen.