Render 部署差异检查（Render Deploy Diff）

在部署前使用此技能，用于比对当前 Render 服务上已配置的环境变量键与所需环境变量键之间的差异。

该技能的功能

• 通过 RENDER_SERVICE_ID 或 RENDER_SERVICE_NAME 解析目标 Render 服务
• 从 REQUIRED_ENV_KEYS 或本地环境模板文件中读取所需的环境变量键
• 通过 Render API 获取当前服务已配置的环境变量键
• 输出两类偏差（drift）集合：
  • 本地声明为必需、但在 Render 上缺失的键
  • 在 Render 上存在、但本地未声明为必需的键
• 当 Render 上缺失任一必需键时，以非零退出码退出

输入参数

• RENDER_API_KEY（必需，除非使用模拟 JSON 进行测试）
• 以下二者之一：
  • RENDER_SERVICE_ID
  • RENDER_SERVICE_NAME
• 可选参数：
  • RENDER_API_BASE_URL（默认值：https://api.render.com/v1）
  • REQUIRED_ENV_KEYS（以逗号分隔的显式必需环境变量键列表）
  • REQUIRED_ENV_FILES（以逗号分隔的待解析文件列表，默认为 .env.example,.env.production）
  • RENDER_ENV_VARS_JSON_PATH（保存的 Render 环境变量 API 响应 JSON 文件路径，用于离线测试）

执行方式

bash scripts/render-deploy-diff.sh

指定显式必需键：

RENDER_SERVICE_NAME=my-service 
REQUIRED_ENV_KEYS="DATABASE_URL,DIRECT_URL,SHADOW_DATABASE_URL,NEXT_PUBLIC_APP_URL" 
bash scripts/render-deploy-diff.sh

使用已保存的 API 响应进行离线测试：

REQUIRED_ENV_KEYS="DATABASE_URL,NEXT_PUBLIC_APP_URL" 
RENDER_ENV_VARS_JSON_PATH=./fixtures/render-env-vars.json 
bash scripts/render-deploy-diff.sh

输出规范

• 输出服务标识信息、必需键数量、远程已配置键数量及偏差摘要
• 当所有必需键均已在 Render 上配置时，返回退出码 0
• 当 Render 上缺失必需键，或输入参数无效时，返回退出码 1