在Cloud Run部署NestJS时如何读取.env格式的环境变量文件

Cloud Run的gcloud run deploy --env-vars-file参数确实只支持YAML或JSON格式的配置文件，无法直接读取传统key=value结构的.env文件。不过可以通过以下两种方案绕开这个限制，直接基于现有的.env.stg/.env.prod文件完成部署：

方案1：临时将.env文件转换为YAML格式部署 #

通过简单的脚本将.env文件转换成Cloud Run要求的YAML格式，部署完成后自动清理临时文件，无需手动修改原文件。

用Shell命令快速转换（适合无特殊字符的场景） #

针对预发布环境：

# 转换.env.stg为临时YAML文件，部署后删除
cat .env.stg | grep -v "^#" | sed 's/^\(.*\)=\(.*\)/\1: "\2"/' > env.tmp.yaml && \
gcloud run deploy YOUR_SERVICE_NAME --env-vars-file env.tmp.yaml --region YOUR_REGION && \
rm env.tmp.yaml

针对生产环境，只需把.env.stg替换为.env.prod即可。

用专用工具转换（适合含特殊字符的场景） #

如果.env文件里有引号、空格等特殊字符，建议用dotenv-to-yaml工具处理：

# 全局安装转换工具
npm install -g dotenv-to-yaml

# 转换预发布环境文件并部署
dotenv-to-yaml -i .env.stg -o env.tmp.yaml && \
gcloud run deploy YOUR_SERVICE_NAME --env-vars-file env.tmp.yaml --region YOUR_REGION && \
rm env.tmp.yaml

方案2：直接在部署命令中注入.env变量 #

读取.env文件的内容，将其转换成gcloud run deploy支持的--set-env-vars参数格式，直接注入变量。

基础版（变量无特殊字符） #

# 预发布环境部署
gcloud run deploy YOUR_SERVICE_NAME --region YOUR_REGION \
--set-env-vars $(cat .env.stg | grep -v "^#" | xargs | sed 's/ /,/g')

增强版（支持含空格/特殊字符的变量） #

如果变量值包含空格或特殊符号，用逐行读取的方式逐个添加参数：

# 生产环境部署
gcloud run deploy YOUR_SERVICE_NAME --region YOUR_REGION \
$(cat .env.prod | grep -v "^#" | while read line; do echo -n "--set-env-vars '$line' "; done)

额外注意事项 #

• 上述命令中的grep -v "^#"用于过滤.env文件中的注释行，避免无效变量被注入。
• 敏感变量（如数据库密码、API密钥）不建议存放在.env文件中，优先使用Google Cloud Secret Manager管理，部署时通过--set-secrets参数引用，安全性更高。

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