如何在VSCode Cloud Run模拟器运行/调试构建设置中添加SQL连接

在VSCode Cloud Code插件的Cloud Run模拟器配置项中，Cloud SQL连接不需要编写复杂的YAML或JSON结构，直接填写标准键值对即可：

• 配置键名固定为 cloudsql_instances
• 配置值为目标Cloud SQL实例的标准连接名，格式为 你的GCP项目ID:实例所在区域:实例名称
• 若需要同时连接多个Cloud SQL实例，多个实例连接名之间用英文半角逗号分隔即可
  配置生效后，Cloud Run模拟器会自动在本地容器环境拉起Cloud SQL Auth Proxy，和正式部署到Cloud Run的运行逻辑完全一致，不需要手动启动代理或修改连接逻辑。

配置示例 #

假设你的GCP项目ID为 demo-python-387209，Cloud SQL实例位于 asia-southeast1 区域，实例名为 user-db，在Advanced Service Settings中添加如下键值对即可：

Key: cloudsql_instances
Value: demo-python-387209:asia-southeast1:user-db

如果需要同时连接测试、生产两个实例，Value字段填写为：
demo-python-387209:asia-southeast1:user-db,demo-python-387209:us-west1:user-db-prod

注意事项 #

• 配置前请确保本地gcloud CLI已完成账号认证，当前使用的账号已被授予目标Cloud SQL实例的 Cloud SQL Client 角色，否则模拟器启动代理时会抛出权限错误
• 应用侧的数据库连接配置和正式Cloud Run部署完全一致，Python 3.10环境下使用PyMySQL、SQLAlchemy等库连接时，host参数填写 /cloudsql/对应实例连接名 即可，不需要额外配置公网IP、白名单
• 如果需要连接使用私有IP的Cloud SQL实例，将配置键名替换为 cloudsql_instances_private_ip，值的格式和公网实例完全一致

Advanced Service Settings配置界面截图

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