Skip to main content

Den Deploy-Verlauf auflisten

api.GetApplicationDeployments(appID) gibt [][]squarecloud.Deployment zurück — eine innere Slice pro Deploy. Jedes Event einer Gruppe teilt dieselbe ID (den Commit-SHA-1, 40 Hex-Zeichen) und durchläuft die Lebenszykluszustände: pending → clone → commit → restarting → success | error.
Branch ist nur beim Event "clone" befüllt und Files (Added, Removed, Modified) nur beim Event "commit".

Die aktuelle Konfiguration inspizieren

api.GetApplicationCurrentDeployment(appID) gibt einen squarecloud.DeploymentCurrent mit der aktuell konfigurierten GitHub-App-Verknüpfung zurück.

Verknüpfen über die Square Cloud GitHub App (empfohlen)

api.LinkApplicationGithubApp(appID, repoName, branch) verknüpft ein GitHub-Repository über die offizielle GitHub App mit der Anwendung.
Um die Verknüpfung zu entfernen:
LinkApplicationGithubApp und UnlinkApplicationGithubApp erfordern ein Session-Token (JWT) als Zugangsdaten — einfache API-Schlüssel werden von diesen Endpoints nicht akzeptiert. Übergib es mit rest.WithToken(sessionToken) oder baue den Client damit.

Verknüpfen über den Legacy-Webhook-Flow

api.PostApplicationDeployWebhook(appID, accessToken) registriert ein GitHub Personal Access Token (ghp_* oder github_pat_*) und gibt die Webhook-URL zurück, die auf GitHub zu konfigurieren ist.
Übergib das Token "@", um den konfigurierten Webhook zu entfernen.