环境变量 - Square Cloud

app.envs 暴露了 EnvsModule，它让你管理应用在运行时看到的 KEY=value 键值对。

const app = await api.applications.fetch("abc123def456abc123def456");
app.envs; // EnvsModule

每个方法在操作完成后都会解析为完整的环境变量集 —— 所以你总能拿回一个最新的 { key: value } 映射。

列出环境变量

const envs = await app.envs.list();

console.log(envs);
// { DATABASE_URL: "postgres://...", FEATURE_FLAG: "true" }

app.envs.set(envs) 将新变量合并到现有集合中。调用中未出现的现有键会被保留。

await app.envs.set({
    DATABASE_URL: "postgres://...",
    FEATURE_FLAG: "true",
});

app.envs.replace(envs) 会覆盖每一个变量。任何未列出的变量都会被移除。

await app.envs.replace({
    DATABASE_URL: "postgres://new-host...",
});
// FEATURE_FLAG is now gone

传入一个空对象以清除所有变量：

await app.envs.replace({});

app.envs.delete(keys) 移除列出的键。未知的键会被静默忽略。

await app.envs.delete(["FEATURE_FLAG"]);