SDK Go: variabili d'ambiente

Le variabili d’ambiente si trovano su c.Apps.Envs. Ogni metodo accetta prima ctx e l’id dell’app e restituisce le variabili dell’app come squarecloud.EnvVars (una map[string]string). 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.
}

Le app statiche non hanno variabili d’ambiente: ogni metodo risponde 400 STATIC_APP_ENV_NOT_SUPPORTED. Una modifica ha effetto al riavvio successivo.

Leggere le variabili

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

fmt.Println(envs["NODE_ENV"])

Aggiungere o aggiornare variabili

Envs.Set(ctx, appID, envs) aggiunge le chiavi indicate e sovrascrive quelle già esistenti. Le altre variabili vengono mantenute. Restituisce tutte le variabili dopo la modifica.

envs, err := c.Apps.Envs.Set(ctx, appID, squarecloud.EnvVars{
	"NODE_ENV":  "production",
	"LOG_LEVEL": "info",
})
if err != nil {
	log.Fatal(err)
}

fmt.Println(envs) // every variable of the app

Sostituire tutte le variabili

Envs.Replace(ctx, appID, envs) sostituisce tutte le variabili con l’insieme indicato. Le chiavi assenti dalla mappa vengono rimosse. Restituisce il nuovo insieme.

if _, err := c.Apps.Envs.Replace(ctx, appID, squarecloud.EnvVars{"NODE_ENV": "production"}); err != nil {
	log.Fatal(err)
}

Rimuovere variabili

Envs.Delete(ctx, appID, keys...) rimuove le chiavi indicate e restituisce le variabili rimanenti. Accetta le chiavi come argomenti variadici: passa uno slice con keys....

remaining, err := c.Apps.Envs.Delete(ctx, appID, "LOG_LEVEL")
if err != nil {
	log.Fatal(err)
}

fmt.Println(remaining)

Limiti ed errori

Status	Codice	Quando
400	`STATIC_APP_ENV_NOT_SUPPORTED`	L’app è statica
400	`INVALID_ENV_CONTENT`	Le variabili non sono un oggetto valido (o, per `Delete`, un elenco vuoto)
400	`TOO_MANY_ENV_VARS`	Il risultato avrebbe più di 256 variabili
400	`ENV_NAME_TOO_LONG`	Una chiave supera i 1024 caratteri
400	`ENV_CONTENT_TOO_LONG`	Un valore supera i 4096 caratteri
400	`READ_FAILED`	Il cluster non è riuscito a leggere le variabili

Prossimi passi

Deploy

Deploy a ogni push, con un webhook o la GitHub App.

Riferimento API delle variabili d'ambiente

Gli endpoint REST dietro questi metodi.

Variabili dalla CLI

Le stesse azioni dal terminale.

Leggere le variabili nel codice

Imposta le variabili dalla dashboard, dalla CLI o dall’API e leggile a runtime.

CLI

VS Code

SDKs

SDK Go: variabili d'ambiente

Leggere le variabili

Aggiungere o aggiornare variabili

Sostituire tutte le variabili

Rimuovere variabili

Limiti ed errori

Prossimi passi

Deploy

Riferimento API delle variabili d'ambiente

Variabili dalla CLI

Leggere le variabili nel codice

​Leggere le variabili

​Aggiungere o aggiornare variabili

​Sostituire tutte le variabili

​Rimuovere variabili

​Limiti ed errori

​Prossimi passi

Deploy

Riferimento API delle variabili d'ambiente

Variabili dalla CLI

Leggere le variabili nel codice

Leggere le variabili

Aggiungere o aggiornare variabili

Sostituire tutte le variabili

Rimuovere variabili

Limiti ed errori

Prossimi passi