Visual Studio 2022本地调试：AWS AppConfig Agent安装启动与文件名问题

1. 本地调试时安装并启动AWS AppConfig Agent #

AWS AppConfig Agent本质是AWS Lambda扩展，本地调试需手动下载并启动：

• 获取对应Windows平台（amd64架构）的Agent二进制安装包
• 将压缩包解压到本地任意目录，比如C:\aws-appconfig-agent
• 打开命令提示符进入解压目录，执行启动命令：

  appconfig-agent.exe
  

  默认情况下Agent会监听http://localhost:2772端口，若需自定义缓存目录等配置，可添加启动参数：

  appconfig-agent.exe --cache-dir C:\appconfig-local-cache
  

• 在Visual Studio调试Lambda项目时，需配置两个关键环境变量：
  • AWS_APPCONFIG_AGENT_ENDPOINT=http://localhost:2772：让应用指向本地运行的Agent
  • 确保本地已配置AWS凭证（可通过AWS CLI的aws configure完成，或在项目调试环境变量中设置AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY），Agent需通过凭证拉取AWS AppConfig中的配置内容

2. Windows系统下合法的缓存文件名格式 #

Windows禁止文件名包含冒号，可通过以下方式处理：

• 替换分隔符：将原格式中的冒号:替换为双下划线__，例如把my-app:dev:my-config改为my-app__dev__my-config
• 告知Agent自定义分隔符：启动Agent时添加参数指定缓存键分隔符：

  appconfig-agent.exe --cache-key-separator "__"
  

  或设置环境变量APPCONFIG_AGENT_CACHE_KEY_SEPARATOR=__，Agent会自动使用该分隔符查找本地缓存文件

内容的提问来源于stack exchange，提问作者cchampion