app.deploys espone il modulo DeploysModule, che copre sia la cronologia dei deploy sia i due percorsi di integrazione con GitHub.
Elencare la cronologia dei deploy
app.deploys.list() restituisce Deployment[][], un array interno per ogni deploy, ognuno dei quali attraversa gli stati del ciclo di vita: pending → clone → commit → restarting → success | error.
Appiattisci il risultato se vuoi un unico elenco cronologico:
Nella v3 questo metodo restituiva un Deployment[] piatto. La v4 restituisce Deployment[][] in modo da poter raggruppare gli eventi per deploy. Usa .flat() per mantenere la forma precedente.
Deployment.id è ora un semplice SHA-1 del commit (40 caratteri esadecimali). Nella v3 era formattato come `git-${string}`.
Collegamento tramite la GitHub App di Square Cloud (consigliato)
app.deploys.linkGithubApp({ repositoryName, repositoryBranch }) collega un repository GitHub all’applicazione tramite la GitHub App ufficiale.
Per rimuovere il collegamento:
linkGithubApp e unlinkGithubApp richiedono un token di sessione (JWT) come chiave API: le semplici chiavi API non sono accettate da questi endpoint.
Collegamento tramite il flusso webhook legacy
app.deploys.integrateGithubWebhook(accessToken) configura l’integrazione legacy basata su webhook usando un Personal Access Token di GitHub.
Passa "@" per rimuovere il webhook:
Ispezionare la configurazione corrente
app.deploys.current() restituisce il collegamento alla GitHub App e l’URL del webhook attualmente configurati, se presenti.
È disponibile anche una scorciatoia app.deploys.webhookURL() che restituisce solo l’URL del webhook (o undefined).