SDK Go: gestire le applicazioni

Ogni metodo di questa pagina si trova su c.Apps e accetta prima ctx, poi l’id dell’app. Un appID può anche essere l’id composto <appId>-<workspaceId> di un’app condivisa tramite un workspace. Ogni snippet qui sotto funziona da solo all’interno di questo programma: incollane uno alla volta in main ed esegui goimports (vedi Eseguire gli esempi).

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.
}

Per elencare le tue app, usa c.Account.Me: il suo slice Applications contiene ogni app che la chiave può vedere.

Recuperare un’applicazione

app, err := c.Apps.Get(ctx, appID)
if err != nil {
	log.Fatal(err)
}

fmt.Println(app.ID, app.Name, app.Language, app.RAM, app.Cluster, app.CreatedAt)

Campo	Tipo	Descrizione
`ID` (`id`)	`string`	Id dell’app
`Name` (`name`)	`string`	Nome visualizzato
`Description` (`desc`)	`string`	Descrizione, `""` se non impostata
`Owner` (`owner`)	`string`	Id utente del proprietario
`Cluster` (`cluster`)	`string`	Cluster su cui gira l’app
`RAM` (`ram`)	`int`	RAM allocata in MB
`Language` (`language`)	`string`	Linguaggio del runtime
`Domain` (`domain`)	`*string`	Host predefinito `<subdomain>.squareweb.app`; `nil` per le app non web
`Custom` (`custom`)	`*string`	Dominio personalizzato; `nil` se non impostato
`CreatedAt` (`created_at`)	`time.Time`	Data di creazione

Stato

Status(ctx, appID) restituisce lo stato in tempo reale con valori formattati:

status, err := c.Apps.Status(ctx, appID)
if err != nil {
	log.Fatal(err)
}

fmt.Println(status.Status)  // e.g. "running", "exited"
fmt.Println(status.Running) // true
fmt.Println(status.CPU)     // "0.5%"
fmt.Println(status.RAM)     // "120.4MB" (RAM in use)
fmt.Println(status.Storage, status.Network.Total, status.Network.Now)
if status.Uptime != nil {
	fmt.Println(*status.Uptime) // Unix ms of the last start; nil when stopped
}

StatusRaw(ctx, appID) restituisce invece numeri (CPU in %, RAM in MB, Storage in byte, Network.Total e Network.Now come coppie di byte [in, out]):

raw, err := c.Apps.StatusRaw(ctx, appID)
if err != nil {
	log.Fatal(err)
}

fmt.Println(raw.CPU, raw.RAM, raw.Network.Total) // 0.5 120.4 [1024 2048]

Uptime è un timestamp (il momento in cui l’app è stata avviata), non una durata. Usa time.Since(time.UnixMilli(*status.Uptime)) per sapere da quanto tempo è attiva.

Stato di tutte le applicazioni

StatusAll(ctx, workspaceID) restituisce un riepilogo per ogni app che la chiave può vedere, in una sola richiesta. Passa "" per tutte le app, oppure l’id di un workspace per le sole app di quel workspace. CPU e RAM sono valorizzati (non "") solo mentre l’app è in esecuzione.

items, err := c.Apps.StatusAll(ctx, "")
if err != nil {
	log.Fatal(err)
}
for _, it := range items {
	if it.Running {
		fmt.Println(it.ID, it.CPU, it.RAM)
	} else {
		fmt.Println(it.ID, "stopped")
	}
}

Avvio, arresto e riavvio

if err := c.Apps.Start(ctx, appID); err != nil {
	log.Fatal(err)
}
if err := c.Apps.Stop(ctx, appID); err != nil {
	log.Fatal(err)
}
if err := c.Apps.Restart(ctx, appID); err != nil {
	log.Fatal(err)
}

Il server tiene aperte queste chiamate finché il container non agisce, quindi senza una scadenza su ctx attendono almeno 2 minuti prima di andare in timeout. Quando la piattaforma rifiuta l’azione, la chiamata restituisce un *APIError con status 409, un Code e un Message vuoto:

Codice	Significato
`CONTAINER_ALREADY_STARTED`	`start` su un’app in esecuzione
`CONTAINER_ALREADY_STOPPED`	`stop` su un’app ferma
`CONTAINER_TEMPORARILY_SUSPENDED`	L’app è sospesa
`CONTAINER_NOT_FOUND`	Il container non esiste sul cluster
`CONTAINER_INSUFFICIENT_DISK_SPACE`	Spazio su disco insufficiente per l’avvio
`CONTAINER_NETWORK_CONFLICT`	Conflitto di rete sul cluster
`ACTION_FAILED`	Il cluster non è riuscito a eseguire l’azione

Anche “già avviata” e “già fermata” sono errori. Se per te significano successo, gestiscili:

err := c.Apps.Start(ctx, appID)

var apiErr *squarecloud.APIError
if err != nil && !(errors.As(err, &apiErr) && apiErr.Code == squarecloud.CodeContainerAlreadyStarted) {
	log.Fatal(err)
}

Log

Logs(ctx, appID) restituisce l’output più recente della console come un’unica stringa ("" quando non ce n’è).

logs, err := c.Apps.Logs(ctx, appID)
if err != nil {
	log.Fatal(err)
}
fmt.Println(logs)

Per un flusso di log in tempo reale, usa Realtime.

Metriche

Metrics(ctx, appID) restituisce le ultime 24 ore, un punto ogni 5 minuti, dal più recente.

points, err := c.Apps.Metrics(ctx, appID)
if err != nil {
	log.Fatal(err)
}
if len(points) > 0 {
	latest := points[0]
	fmt.Println(latest.Date, latest.CPU, latest.RAM, latest.Net)
}

Domini e load balancer

Domains(ctx) elenca gli hostname predefiniti e personalizzati di ogni app. LoadBalancers(ctx) elenca i domini condivisi da più app, con il limite del tuo piano.

domains, err := c.Apps.Domains(ctx)
if err != nil {
	log.Fatal(err)
}
for _, d := range domains {
	fmt.Println(d.AppID, d.Hostname, d.Type) // Type: "subdomain" | "custom"
}

lb, err := c.Apps.LoadBalancers(ctx)
if err != nil {
	log.Fatal(err)
}
fmt.Println(lb.Limit)
for _, balancer := range lb.Balancers {
	ids := make([]string, 0, len(balancer.Apps))
	for _, app := range balancer.Apps {
		ids = append(ids, app.ID)
	}
	fmt.Println(balancer.Hostname, ids)
}

Per impostare un dominio personalizzato, vedi Rete.

Eliminare un’applicazione

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

L’eliminazione è permanente. Crea prima uno snapshot se potresti aver ancora bisogno dei file.

Prossimi passi

Commit e upload

Crea un’app da uno zip o inviale dei file.

Riferimento API delle applicazioni

Gli endpoint REST dietro questi metodi.

Gestire le app dalla CLI

Le stesse azioni dal terminale.

CLI

VS Code

SDKs

SDK Go: gestire le applicazioni

Recuperare un’applicazione

Stato

Stato di tutte le applicazioni

Avvio, arresto e riavvio

Log

Metriche

Domini e load balancer

Eliminare un’applicazione

Prossimi passi

Commit e upload

Riferimento API delle applicazioni

Gestire le app dalla CLI

​Recuperare un’applicazione

​Stato

​Stato di tutte le applicazioni

​Avvio, arresto e riavvio

​Log

​Metriche

​Domini e load balancer

​Eliminare un’applicazione

​Prossimi passi

Commit e upload

Riferimento API delle applicazioni

Gestire le app dalla CLI

Recuperare un’applicazione

Stato

Stato di tutte le applicazioni

Avvio, arresto e riavvio

Log

Metriche

Domini e load balancer

Eliminare un’applicazione

Prossimi passi