client := rest.NewClient(os.Getenv("SQUARECLOUD_API_KEY"))
defer client.Close()
api := rest.New(client)
环境变量被建模为 squarecloud.EnvVars,一个普通的 map[string]string。每个方法在操作完成后都会解析为完整的环境变量集 —— 所以你总能拿回一个最新的映射。
限制:每个应用最多 256 个变量,key 最长 1024 个字符,value 最长 4096 个字符。
列出环境变量
envs, err := api.GetApplicationEnvs("abc123def456abc123def456")
if err != nil {
panic(err)
}
for key, value := range envs {
fmt.Printf("%s=%s\n", key, value)
}
添加或更新变量
api.SetApplicationEnvs(appID, envs) 将新变量合并到现有集合中。调用中未出现的现有键会被保留。
envs, err := api.SetApplicationEnvs("abc123def456abc123def456", squarecloud.EnvVars{
"DATABASE_URL": "postgres://...",
"FEATURE_FLAG": "true",
})
if err != nil {
panic(err)
}
替换整个环境变量集
api.ReplaceApplicationEnvs(appID, envs) 会覆盖每一个变量。
任何未在调用中列出的变量都会被移除。当你只想添加或更新时请使用 SetApplicationEnvs —— ReplaceApplicationEnvs 会删除所有你遗漏的变量。
envs, err := api.ReplaceApplicationEnvs("abc123def456abc123def456", squarecloud.EnvVars{
"DATABASE_URL": "postgres://new-host...",
})
if err != nil {
panic(err)
}
// FEATURE_FLAG is now gone
传入一个空 map 以清除所有变量:
_, err := api.ReplaceApplicationEnvs("abc123def456abc123def456", squarecloud.EnvVars{})
删除变量
api.DeleteApplicationEnvs(appID, keys) 移除列出的键。未知的键会被静默忽略。
envs, err := api.DeleteApplicationEnvs("abc123def456abc123def456", []string{"FEATURE_FLAG"})
if err != nil {
panic(err)
}