SDK de Go: variables de entorno

Las variables de entorno están en c.Apps.Envs. Todos los métodos reciben primero ctx y el id de la aplicación, y devuelven las variables de la aplicación como un squarecloud.EnvVars (un map[string]string). 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.
}

Las aplicaciones estáticas no tienen variables de entorno: todos los métodos responden 400 STATIC_APP_ENV_NOT_SUPPORTED. Un cambio surte efecto en el siguiente reinicio.

Leer las variables

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

fmt.Println(envs["NODE_ENV"])

Añadir o actualizar variables

Envs.Set(ctx, appID, envs) añade las claves indicadas y sobrescribe las que ya existen. Las demás variables se mantienen. Devuelve todas las variables después del cambio.

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

Reemplazar todas las variables

Envs.Replace(ctx, appID, envs) reemplaza todas las variables por el conjunto indicado. Las claves que no están en el map se eliminan. Devuelve el nuevo conjunto.

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

Eliminar variables

Envs.Delete(ctx, appID, keys...) elimina las claves indicadas y devuelve las variables restantes. Recibe las claves como argumentos variádicos: pasa un slice con keys....

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

fmt.Println(remaining)

Límites y errores

Estado	Código	Cuándo
400	`STATIC_APP_ENV_NOT_SUPPORTED`	La aplicación es estática
400	`INVALID_ENV_CONTENT`	Las variables no son un objeto válido (o, en `Delete`, una lista vacía)
400	`TOO_MANY_ENV_VARS`	El resultado tendría más de 256 variables
400	`ENV_NAME_TOO_LONG`	Una clave supera los 1024 caracteres
400	`ENV_CONTENT_TOO_LONG`	Un valor supera los 4096 caracteres
400	`READ_FAILED`	El clúster no pudo leer las variables

Próximos pasos

Deploys

Deploy en cada push, con un webhook o la GitHub App.

Referencia de la API de variables de entorno

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

Variables desde la CLI

Las mismas acciones desde la terminal.

Leer variables en tu código

Define variables desde el dashboard, la CLI o la API y léelas en tiempo de ejecución.

CLI

VS Code

SDKs

SDK de Go: variables de entorno

Leer las variables

Añadir o actualizar variables

Reemplazar todas las variables

Eliminar variables

Límites y errores

Próximos pasos

Deploys

Referencia de la API de variables de entorno

Variables desde la CLI

Leer variables en tu código

​Leer las variables

​Añadir o actualizar variables

​Reemplazar todas las variables

​Eliminar variables

​Límites y errores

​Próximos pasos

Deploys

Referencia de la API de variables de entorno

Variables desde la CLI

Leer variables en tu código

Leer las variables

Añadir o actualizar variables

Reemplazar todas las variables

Eliminar variables

Límites y errores

Próximos pasos