SDK de Go: deploys desde GitHub

c.Apps.Deploys conecta una aplicación a GitHub para que un push la despliegue. Hay dos formas de hacerlo: un webhook que añades al repositorio, o la GitHub App de Square Cloud. Cada fragmento de abajo se ejecuta por sí solo dentro de este programa: pega uno a la vez en main y ejecuta goimports (consulta Ejecutar los ejemplos).

package main

import (
	"context"
	"os"

	"github.com/squarecloudofc/sdk-api-go/v3"
)

var (
	ctx   = context.Background()
	c     = squarecloud.New(os.Getenv("SQUARECLOUD_API_KEY"))
	appID = "abc123def456abc123def456"
)

func main() {
	// Paste one snippet here, then run goimports.
}

Webhook

Deploys.SetWebhook(ctx, appID, accessToken) configura los deploys por webhook de GitHub con un token de acceso de GitHub (ghp_... o github_pat_...) y devuelve la URL del webhook que debes añadir a tu repositorio.

url, err := c.Apps.Deploys.SetWebhook(ctx, appID, os.Getenv("GITHUB_TOKEN"))
if err != nil {
	log.Fatal(err)
}

fmt.Println(url) // add it as a webhook in the repository settings

Pasa "@" como token para eliminar el webhook. En ese caso, el método devuelve "".

if _, err := c.Apps.Deploys.SetWebhook(ctx, appID, "@"); err != nil {
	log.Fatal(err)
}

Un token no válido da 400 INVALID_ACCESS_TOKEN.

GitHub App

Deploys.LinkGithubApp(ctx, appID, repository, branch) vincula un repositorio instalado a través de la GitHub App de Square Cloud. Necesita el scope apps:deploy.

repo, err := c.Apps.Deploys.LinkGithubApp(ctx, appID, "octocat/hello-world", "main")
if err != nil {
	log.Fatal(err)
}

fmt.Println(repo.ID, repo.FullName, repo.Branch)

Deploys.UnlinkGithubApp(ctx, appID) elimina la vinculación. Para vincular otro repositorio o rama, desvincula primero.

if err := c.Apps.Deploys.UnlinkGithubApp(ctx, appID); err != nil {
	log.Fatal(err)
}

Vincular y desvincular comparten un límite de 3 llamadas cada 60 segundos.

Estado	Código	Cuándo
400	`GIT_ALREADY_CONFIGURED`	La aplicación ya tiene un repositorio vinculado: desvincúlalo primero
400	`GIT_NOT_CONFIGURED`	`UnlinkGithubApp` sin nada vinculado
400	`BRANCH_NOT_FOUND`, `INVALID_BRANCH_LENGTH`	La rama no existe, o su nombre supera los 256 caracteres
403	`GITHUB_NOT_CONNECTED`	Tu cuenta no tiene ninguna instalación de la GitHub App
403	`REPOSITORY_NOT_AVAILABLE`	La GitHub App no está instalada en el repositorio a través de tu cuenta de GitHub
403	`REPOSITORY_PERMISSION_REQUIRED`	Tu cuenta de GitHub no tiene acceso de escritura al repositorio
404	`REPOSITORY_NOT_FOUND`	El repositorio no existe o no es visible
409	`REPOSITORY_BRANCH_ALREADY_CONFIGURED`	Otra aplicación, de cualquier cuenta, ya vincula este repositorio y esta rama. Su id aparece en `Message` solo cuando esa aplicación es tuya
502	`FAILED_TO_FETCH`	GitHub no confirmó la rama: se puede reintentar sin riesgo

Configuración actual

Deploys.Current(ctx, appID) devuelve lo que está configurado: App para la vinculación con la GitHub App, Webhook para la URL del webhook. Cuando no hay nada configurado, devuelve el valor cero (App es nil y Webhook es ""). Los campos de App son punteros, ya que la API puede enviarlos como null.

current, err := c.Apps.Deploys.Current(ctx, appID)
if err != nil {
	log.Fatal(err)
}

if app := current.App; app != nil && app.Name != nil && app.Branch != nil {
	fmt.Println(*app.Name, *app.Branch) // e.g. "octocat/hello-world" "main"
}
if current.Webhook != "" {
	fmt.Println(current.Webhook)
}

Historial de deploys

Deploys.List(ctx, appID) devuelve una línea de tiempo por deploy (un [][]DeployEvent), cada una un slice de eventos, del evento más antiguo al más reciente. Solo se registran los deploys de Git (pushes por webhook y por GitHub App).

timelines, err := c.Apps.Deploys.List(ctx, appID)
if err != nil {
	log.Fatal(err)
}
for _, timeline := range timelines {
	if len(timeline) == 0 {
		continue
	}
	last := timeline[len(timeline)-1]
	fmt.Println(last.ID, last.State, last.Date)

	if last.State == squarecloud.DeployError {
		fmt.Println(last.Code, last.Message)
	}
}

Campo	Descripción
`ID` (`id`)	El SHA del commit
`State` (`state`)	`pending`, `clone`, `commit`, `restarting`, `success` o `error` (constantes `DeployPending`, `DeployClone`, `DeployCommit`, `DeployRestarting`, `DeploySuccess`, `DeployError`)
`Date` (`date`)	Cuándo ocurrió el evento (`time.Time`)
`Source` (`source`)	Siempre `"git"`
`Branch` (`branch`)	En los eventos `clone`
`Files` (`files`)	En los eventos `commit`: un `*DeployFiles` con `Added`, `Removed` y `Modified`; `nil` en los demás
`Code` / `Message` (`code` / `message`)	En los eventos `error`: por qué falló el deploy (por ejemplo `CLONE_FAILED`)

Próximos pasos

Red

Analíticas, DNS, dominios personalizados y caché.

Referencia de la API de deploys

Los endpoints REST detrás de estos métodos.

Deploys de GitHub desde la CLI

Las mismas acciones desde la terminal.

CLI

VS Code

SDKs

SDK de Go: deploys desde GitHub

Webhook

GitHub App

Configuración actual

Historial de deploys

Próximos pasos

Red

Referencia de la API de deploys

Deploys de GitHub desde la CLI

​Webhook

​GitHub App

​Configuración actual

​Historial de deploys

​Próximos pasos

Red

Referencia de la API de deploys

Deploys de GitHub desde la CLI

Webhook

GitHub App

Configuración actual

Historial de deploys

Próximos pasos