AutoGen生产环境检查清单

AutoGen生产环境检查清单

基础环境

• [ ] Python版本 >= 3.11 或 .NET 8.0+
• [ ] 系统内存 >= 16GB
• [ ] 磁盘空间 >= 20GB
• [ ] 网络连接稳定且带宽充足

安全配置

• [ ] API密钥通过环境变量或密钥管理服务存储
• [ ] 所有依赖包均通过安全扫描
• [ ] 应用以非root用户运行
• [ ] 网络访问限制在必要端口和IP范围内

性能优化

• [ ] 启用响应缓存
• [ ] 配置适当的并发限制
• [ ] 日志级别设置为INFO或WARNING
• [ ] 已配置资源使用限制

监控与维护

• [ ] 健康检查端点已实现
• [ ] 日志收集系统已配置
• [ ] 自动重启机制已设置
• [ ] 备份策略已制定并测试

### 生产部署架构示意图

```mermaid
flowchart TD
    A[负载均衡器] --> B[AutoGen应用服务器集群]
    B --> C[API服务节点]
    B --> D[智能体协调节点]
    B --> E[任务执行节点]
    C --> F[缓存服务]
    D --> F
    E --> F
    C --> G[数据库服务]
    D --> G
    E --> G
    H[监控系统] --> C
    H --> D
    H --> E
    H --> F
    H --> G

环境配置迁移工具

为确保开发环境到生产环境的配置一致性，推荐使用以下迁移工具：

1. Python环境迁移

# 在开发环境导出依赖
uv pip freeze > requirements.txt

# 在生产环境安装依赖
uv pip install -r requirements.txt --no-cache-dir

2. .NET环境迁移

# 锁定依赖版本
dotnet list package --include-transitive > dependencies.txt

# 在生产环境还原完全相同的依赖版本
dotnet restore --locked-mode

为什么这样做？依赖版本不一致是生产环境常见问题的根源。锁定依赖版本可以确保生产环境使用与开发环境完全相同的库版本，避免兼容性问题。

生产环境安全配置示例

创建生产环境安全配置文件 security.config.json：

{
  "apiSecurity": {
    "enableSsl": true,
    "sslCertPath": "/etc/ssl/autogen/cert.pem",
    "sslKeyPath": "/etc/ssl/autogen/key.pem"
  },
  "authentication": {
    "enabled": true,
    "jwtSecret": "${JWT_SECRET}",
    "tokenExpiryHours": 24
  },
  "rateLimiting": {
    "enabled": true,
    "requestsPerMinute": 60,
    "blockDurationMinutes": 5
  },
  "dataProtection": {
    "encryptionEnabled": true,
    "keyVaultUri": "${KEY_VAULT_URI}"
  }
}

⚠️ 重要安全注意事项：生产环境中永远不要将敏感信息（如API密钥、密码）硬编码到配置文件或代码中。应使用环境变量或专门的密钥管理服务，并限制应用程序对这些密钥的访问权限。

环境验证自动化脚本

创建生产环境验证脚本 validate-production-env.py：

#!/usr/bin/env python3
"""AutoGen生产环境验证脚本"""

import os
import sys
import importlib
import platform
import subprocess

def check_python_environment():
    """检查Python环境"""
    print("=== Python环境检查 ===")
    min_version = (3, 10)
    current_version = sys.version_info
    
    if current_version < min_version:
        print(f"❌ Python版本不足 (当前: {platform.python_version()}, 要求: {'.'.join(map(str, min_version))}+)")
        return False
    
    print(f"✅ Python版本: {platform.python_version()}")
    return True

def check_dependencies():
    """检查依赖包"""
    print("\n=== 依赖包检查 ===")
    required_packages = [
        ("autogen_core", "0.2.0"),
        ("autogen_agentchat", "0.2.0"),
        ("autogen_ext", "0.2.0")
    ]
    
    all_ok = True
    for package, min_version in required_packages:
        try:
            module = importlib.import_module(package)
            # 简单版本检查（实际项目中可能需要更复杂的版本比较逻辑）
            print(f"✅ {package} 已安装 (版本: {getattr(module, '__version__', '未知')})")
        except ImportError:
            print(f"❌ {package} 未安装 (要求版本: {min_version}+)")
            all_ok = False
    
    return all_ok

def check_environment_variables():
    """检查必要环境变量"""
    print("\n=== 环境变量检查 ===")
    required_vars = [
        "OPENAI_API_KEY",
        "AUTOGEN_LOG_LEVEL",
        "AUTOGEN_CACHE_DIR"
    ]
    
    all_ok = True
    for var in required_vars:
        if var not in os.environ:
            print(f"❌ 缺少必要环境变量: {var}")
            all_ok = False
        else:
            print(f"✅ 环境变量 {var} 已设置")
    
    return all_ok

def check_system_resources():
    """检查系统资源"""
    print("\n=== 系统资源检查 ===")
    try:
        # 检查内存
        if sys.platform.startswith('linux'):
            with open('/proc/meminfo') as f:
                mem_total = f.readline()
                print(f"内存总量: {mem_total.strip()}")
                if int(mem_total.split()[1]) < 16 * 1024 * 1024:  # 16GB
                    print("⚠️ 警告: 内存可能不足，建议至少16GB")
        
        # 检查磁盘空间
        if sys.platform.startswith(('linux', 'darwin')):
            df_output = subprocess.check_output(['df', '-h', '.']).decode()
            print(f"磁盘空间: {df_output.splitlines()[1]}")
            
    except Exception as e:
        print(f"⚠️ 资源检查出错: {str(e)}")
    
    return True

def main():
    """主函数"""
    print("=== AutoGen生产环境验证 ===")
    
    checks = [
        check_python_environment,
        check_dependencies,
        check_environment_variables,
        check_system_resources
    ]
    
    all_checks_passed = True
    for check in checks:
        if not check():
            all_checks_passed = False
    
    if all_checks_passed:
        print("\n🎉 所有生产环境检查通过！")
        print("AutoGen应用已准备好部署到生产环境。")
        sys.exit(0)
    else:
        print("\n❌ 部分检查未通过，请修复上述问题后再部署。")
        sys.exit(1)

if __name__ == "__main__":
    main()