配置动态参数

功能介绍

动态参数是EAS提供的运行时配置能力，允许您在服务运行过程中实时修改参数配置，无需重启服务即可生效。

与环境变量的区别：

• 环境变量：在服务启动时注入，修改后需要重启服务才能生效。

• 动态参数：运行时可修改，修改后立即生效，无需重启服务。

核心优势：

• 配置实时生效，快速同步到所有容器实例。

• 不影响服务运行，避免因重启导致的服务中断。

• 适合频繁调整的配置项，如限流阈值、模型参数等。

使用场景

动态参数适用于以下场景：

• 动态调整限流配置：根据业务流量实时调整rate_limit等限流参数。

• 实时修改模型推理参数：调整temperature、top_p、max_tokens等模型参数。

• 调整日志级别：在排查问题时临时调整日志输出级别。

• 灰度发布开关控制：通过动态参数控制新功能的开关状态。

• A/B测试配置：快速切换不同的配置策略进行效果对比。

前提条件

使用动态参数功能前，需要在服务配置中开启动态配置开关。在服务配置 JSON 的顶层添加 features 字段：

{
  "name": "your-service-name",
  ...其他配置,
  "features": {
    "eas.aliyun.com/enable-properties": "true"
  }
}

操作步骤

使用示例

以下示例展示如何配置限流参数，以及在应用代码中读取动态参数。

配置限流参数：

{
  "properties": {
    "rate_limit": 100,
    "max_concurrent_requests": 50,
    "timeout_seconds": 30
  }
}

在应用中读取动态参数（Python）：

import json

# 读取动态参数
def load_properties():
    try:
        with open('/eas/workspace/properties/service.json', 'r') as f:
            properties = json.load(f)
        return properties
    except Exception as e:
        print(f"Failed to load properties: {e}")
        return {}

# 使用动态参数
properties = load_properties()
rate_limit = properties.get('rate_limit', 100)
max_concurrent = properties.get('max_concurrent_requests', 50)

print(f"Rate limit: {rate_limit}")
print(f"Max concurrent requests: {max_concurrent}")

常见问题