在函数内使用环境变量

在 Hyac 中，您可以通过稳定门面 ctx.cloud.env() 动态读取和设置当前应用的环境变量。这对于管理配置、密钥或其他运行时需要的数据非常有用。旧入口 ctx.env / context.env 仍保持兼容。

控制台“设置 / 环境变量”页用于管理应用级环境变量。运行时会监听环境变量变更并动态更新进程环境，不需要重启应用运行时。

通过代码调用 await ctx.cloud.env().set(...) 会更新持久化配置，并立即更新当前运行时进程的 os.environ。通过控制台修改环境变量后，运行时的环境变量监听器会接收 MongoDB Change Stream 事件并动态刷新 os.environ。

1. 获取环境变量

您可以使用 ctx.cloud.env().get("VARIABLE_NAME") 方法来获取一个环境变量的值。

async def handler(ctx):
    """
    一个演示如何获取环境变量的函数。
    """
    env = ctx.cloud.env()
    # 获取名为 'API_KEY' 的环境变量
    api_key = env.get("API_KEY")

    if not api_key:
        return {"error": "API_KEY not configured."}

    return {"message": f"Successfully retrieved API_KEY: {api_key[:4]}****"}

2. 设置环境变量

您可以使用 await ctx.cloud.env().set("VARIABLE_NAME", "VALUE") 方法来设置或更新一个环境变量。这是一个异步操作。

重要提示: 通过此方法设置的环境变量是持久化的，它会覆盖在管理后台设置的同名变量，并在当前运行时中立即可读。

async def handler(ctx):
    """
    一个演示如何设置环境变量的函数。
    """
    new_api_key = "a-new-secret-key-generated-at-runtime"
    env = ctx.cloud.env()

    # 设置或更新名为 'API_KEY' 的环境变量
    await env.set("API_KEY", new_api_key)

    return {"message": "API_KEY has been updated successfully."}

通过结合使用 get 和 set 方法，您可以实现动态配置管理、状态持久化等高级功能，而无需担心因配置变更而中断服务。