Go SDK: environment variables

Environment variables live on c.Apps.Envs. Every method takes ctx and the app id first and returns the app’s variables as a squarecloud.EnvVars (a map[string]string). Each snippet below runs on its own inside this program: paste one at a time into main and run goimports (see Running the examples).

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

Static apps have no environment variables: every method answers 400 STATIC_APP_ENV_NOT_SUPPORTED. A change takes effect on the next restart.

Reading the variables

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

fmt.Println(envs["NODE_ENV"])

Adding or updating variables

Envs.Set(ctx, appID, envs) adds the given keys and overwrites the ones that already exist. Other variables are kept. It returns every variable after the change.

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

Replacing every variable

Envs.Replace(ctx, appID, envs) replaces all variables with the given set. Keys not in the map are removed. It returns the new set.

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

Removing variables

Envs.Delete(ctx, appID, keys...) removes the given keys and returns the remaining variables. It takes the keys as variadic arguments: pass a slice with keys....

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

fmt.Println(remaining)

Limits and errors

Status	Code	When
400	`STATIC_APP_ENV_NOT_SUPPORTED`	The app is static
400	`INVALID_ENV_CONTENT`	The variables are not a valid object (or, for `Delete`, an empty list)
400	`TOO_MANY_ENV_VARS`	The result would have more than 256 variables
400	`ENV_NAME_TOO_LONG`	A key is over 1024 characters
400	`ENV_CONTENT_TOO_LONG`	A value is over 4096 characters
400	`READ_FAILED`	The cluster could not read the variables

Next steps

Deploys

Deploy on every push, with a webhook or the GitHub App.

Environment variables API reference

The REST endpoints behind these methods.

Variables from the CLI

The same actions from the terminal.

Read variables in your code

Set variables from the dashboard, CLI or API and read them at runtime.

CLI

VS Code

SDKs

Go SDK: environment variables

Reading the variables

Adding or updating variables

Replacing every variable

Removing variables

Limits and errors

Next steps

Deploys

Environment variables API reference

Variables from the CLI

Read variables in your code

​Reading the variables

​Adding or updating variables

​Replacing every variable

​Removing variables

​Limits and errors

​Next steps

Deploys

Environment variables API reference

Variables from the CLI

Read variables in your code

Reading the variables

Adding or updating variables

Replacing every variable

Removing variables

Limits and errors

Next steps