Statische AI-Launch-Site per Hosting-API bereitstellen und zurückrollen
Diese Anleitung beschreibt den v1-Ablauf für eine statische AI-Launch-Site. Er gilt nicht für WordPress-Themes, Plugins oder WordPress-Core. Der Ablauf mit Upload, Preview, Veröffentlichung und Rollback wurde auf einer AI-Launch-Site geprüft. Teste ihn für deine Site zuerst mit einer Preview, bevor du veröffentlichst.
Voraussetzungen
Du brauchst ein Token mit static:deploy für die konkrete AI-Launch-Site und die site_id aus GET /sites. CI baut das statische Ergebnis vorher selbst. Der API-Request lädt einzelne Dateien mit Pfad, Inhalt und utf8 oder base64 hoch; vorhandene Datei- und Bytegrenzen gelten. Geheimnisse, Datenbanken oder beliebige Serverbefehle gehören nicht in den Upload.
Ablauf
- Lege mit
POST /sites/{site_id}/deploymentsein Deployment an. Sende einen Idempotency-Key und merke die zurückgegebene Deployment-ID. - Übertrage erlaubte Dateien einzeln mit
PUT /sites/{site_id}/deployments/{id}/files. Jeder schreibende Request benötigt einen eigenen, zur Nutzlast stabilen Idempotency-Key. - Rufe
POST /sites/{site_id}/deployments/{id}/previewauf. Prüfevalid,issuesund gegebenenfallspreview_url. Ein nicht valider Bericht stoppt die Veröffentlichung. - Veröffentliche mit
POST /sites/{site_id}/deployments/{id}/publish.202ist nur die Annahme. FrageGET /operations/{id}gemäßRetry-Afterab und fahre erst beisucceededfort. - Prüfe die öffentliche Seite mit einem HTTP-Smoke-Test. Bei Fehlschlag stoppe die Pipeline und bewerte einen Code-Rollback.
Rollback
POST /sites/{site_id}/deployments/{id}/rollback beauftragt den Rückwechsel auf eine bestehende Version und liefert ebenfalls einen Job. Warte auf succeeded, bevor du den Rückwechsel als abgeschlossen meldest. Bei failed oder unknown keine weitere Mutation blind starten. Ein Code-Rollback stellt keine Datenbank oder dynamischen Inhalte wieder her.
Die vollständigen Parameter und Antwortschemas stehen in der OpenAPI-Referenz. Für WordPress-CI siehe die gesonderten GitHub- und GitLab-Anleitungen.