如何在GCP Cloud Build中正确生成含自定义配置的.env文件

• touch .env逻辑完全无法将环境变量写入文件：touch仅会创建空文件，配置里的env字段只是给步骤容器注入运行时环境参数，不会自动落盘到文件
• 执行逻辑错误：给python3设置了entrypoint后传入args: ['touch', '.env']，python解释器本身没有touch命令参数，这步执行会直接抛出未找到参数的错误
• 变量引用规则误用：Cloud Build中你在触发器里配置的自定义替换变量，直接用单$引用即可；双$是转义语法，用来避免内置变量被Cloud Build提前替换、交给shell运行时解析，这里用双$反而会导致拿不到你配置的变量值

方案1：无需额外脚本，用Shell步骤直接生成.env文件 #

直接替换原配置中错误的创建.env步骤，利用Cloud Build内置的bash镜像完成文件写入，完整可运行的cloudbuild.yaml示例：

steps:
- name: 'python:3.8'
  entrypoint: python3
  args: ['-m', 'pip', 'install', '-t', '.', '-r', 'requirements.txt']
# 替换原错误的touch步骤
- name: 'gcr.io/cloud-builders/bash'
  args:
    - '-c'
    - |
      cat > .env << EOF
      DATABASE_HOST="$DB_HOST"
      DATABASE_USER="$DB_USER"
      DATABASE_PASSWORD="$DB_PASS"
      DATABASE_NAME="$DB_NAME"
      FIREBASE_CREDENTIALS="$FIRE_CRED"
      EOF
- name: 'python:3.8'
  entrypoint: python3
  args: ['./manage.py', 'collectstatic', '--noinput']
- name: "gcr.io/cloud-builders/gcloud"
  args: ["app", "deploy"]
timeout: "1600s"

关键注意：给每个变量值加双引号，可以避免变量值包含特殊字符（比如斜杠、空格、引号）时被Shell错误解析。

方案2：适配脚本逻辑，用create-env.py生成.env文件 #

如果你希望保留脚本生成的实现逻辑，可按以下方式调整：

1. 在代码仓库根目录新增create-env.py脚本，从运行时环境读取参数写入文件：

   import os
   env_pairs = [
       "DATABASE_HOST",
       "DATABASE_USER",
       "DATABASE_PASSWORD",
       "DATABASE_NAME",
       "FIREBASE_CREDENTIALS"
   ]
   with open('.env', 'w') as f:
       for key in env_pairs:
           f.write(f"{key}={os.getenv(key, '')}\n")
   

2. 调整cloudbuild.yaml中对应步骤的配置，正确传入替换变量：

   - name: 'python:3.8'
     entrypoint: python3
     args: ['create-env.py']
     env:
       - 'DATABASE_HOST=$DB_HOST'
       - 'DATABASE_USER=$DB_USER'
       - 'DATABASE_PASSWORD=$DB_PASS'
       - 'DATABASE_NAME=$DB_NAME'
       - 'FIREBASE_CREDENTIALS=$FIRE_CRED'
   

关键注意：Cloud Build的所有步骤共享同一个工作区目录，生成的.env文件会自动对后续所有deploy、collectstatic步骤可见，不需要额外做路径迁移。

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