SDK Go: variáveis de ambiente

As variáveis de ambiente ficam em c.Apps.Envs. Todo método recebe o ctx e o id da aplicação primeiro e retorna as variáveis da aplicação como um squarecloud.EnvVars (um map[string]string). Cada trecho abaixo roda sozinho dentro deste programa: cole um de cada vez em main e execute o goimports (veja Executando os exemplos).

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

Aplicações estáticas não têm variáveis de ambiente: todos os métodos respondem 400 STATIC_APP_ENV_NOT_SUPPORTED. Uma alteração entra em vigor no próximo reinício.

Lendo as variáveis

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

fmt.Println(envs["NODE_ENV"])

Adicionando ou atualizando variáveis

Envs.Set(ctx, appID, envs) adiciona as chaves informadas e sobrescreve as que já existem. As outras variáveis são mantidas. Retorna todas as variáveis após a alteração.

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

Substituindo todas as variáveis

Envs.Replace(ctx, appID, envs) substitui todas as variáveis pelo conjunto informado. As chaves que não estão no map são removidas. Retorna o novo conjunto.

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

Removendo variáveis

Envs.Delete(ctx, appID, keys...) remove as chaves informadas e retorna as variáveis restantes. Ele recebe as chaves como argumentos variádicos: passe um slice com keys....

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

fmt.Println(remaining)

Limites e erros

Status	Código	Quando
400	`STATIC_APP_ENV_NOT_SUPPORTED`	A aplicação é estática
400	`INVALID_ENV_CONTENT`	As variáveis não são um objeto válido (ou, para `Delete`, uma lista vazia)
400	`TOO_MANY_ENV_VARS`	O resultado teria mais de 256 variáveis
400	`ENV_NAME_TOO_LONG`	Uma chave tem mais de 1024 caracteres
400	`ENV_CONTENT_TOO_LONG`	Um valor tem mais de 4096 caracteres
400	`READ_FAILED`	O cluster não conseguiu ler as variáveis

Próximos passos

Deploys

Faça deploy a cada push, com um webhook ou o GitHub App.

Referência da API de variáveis de ambiente

Os endpoints REST por trás destes métodos.

Variáveis pela CLI

As mesmas ações pelo terminal.

Variáveis no seu código

Defina variáveis pelo dashboard, pela CLI ou pela API e leia-as em tempo de execução.

CLI

VS Code

SDKs

SDK Go: variáveis de ambiente

Lendo as variáveis

Adicionando ou atualizando variáveis

Substituindo todas as variáveis

Removendo variáveis

Limites e erros

Próximos passos

Deploys

Referência da API de variáveis de ambiente

Variáveis pela CLI

Variáveis no seu código

​Lendo as variáveis

​Adicionando ou atualizando variáveis

​Substituindo todas as variáveis

​Removendo variáveis

​Limites e erros

​Próximos passos

Deploys

Referência da API de variáveis de ambiente

Variáveis pela CLI

Variáveis no seu código

Lendo as variáveis

Adicionando ou atualizando variáveis

Substituindo todas as variáveis

Removendo variáveis

Limites e erros

Próximos passos