Variabili d'ambiente - Square Cloud

Le variabili d’ambiente si trovano su client.apps.envs. Ogni metodo accetta come primo argomento l’id dell’app e restituisce le variabili dell’app come un semplice dict[str, str].

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 = client.apps.envs.get(app_id)

print(envs.get("NODE_ENV"))

Aggiungere o aggiornare variabili

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

envs = client.apps.envs.set(app_id, {
    "NODE_ENV": "production",
    "LOG_LEVEL": "info",
})

Sostituire tutte le variabili

envs.replace(app_id, envs) sostituisce tutte le variabili con l’insieme indicato. Le chiavi non presenti nel dict vengono rimosse. {} le cancella tutte.

client.apps.envs.replace(app_id, {"NODE_ENV": "production"})

Rimuovere variabili

envs.delete(app_id, keys) rimuove le chiavi indicate e restituisce le variabili rimanenti. keys è una lista (qualsiasi iterabile di stringhe) o una singola chiave.

remaining = client.apps.envs.delete(app_id, ["LOG_LEVEL"])

# A single key also works
remaining = client.apps.envs.delete(app_id, "LOG_LEVEL")

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`, una lista vuota)
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