Flask项目部署GCP App Engine时环境变量处理及Cloud Build报错求助

一、解决FileNotFoundError错误 #

错误原因 #

Cloud Build使用的cloud-sdk镜像中，不存在你项目本地虚拟环境的路径/workspace/myproject/bin/python3，gcloud app deploy部署时误尝试调用该路径的Python解释器，导致报错。

修复后的cloudbuild.yaml #

steps:
# 部署App Engine应用
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'bash'
  args:
    - '-c'
    - |
      gcloud app deploy --project=myprojectid --quiet
# 创建Datastore索引
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'bash'
  args: ['-c', 'gcloud datastore indexes create index.yaml --project=myprojectid']
  timeout: '1600s'

关键修正点 #

1. 移除了不必要的gcloud config set命令，gcloud app deploy可直接通过--project参数指定项目
2. 无需在Cloud Build步骤中传递环境变量（后续会给出更安全的处理方案）
3. 确保项目根目录的app.yaml正确指定Python运行时，示例：

runtime: python39
entrypoint: gunicorn -b :$PORT main:app

二、更安全的环境变量与密钥处理方案 #

1. 敏感密钥用Secret Manager存储（推荐） #

• 在GCP控制台创建Secret，例如命名为captcha-private-key，存入私钥值
• 给Cloud Build服务账号、App Engine服务账号添加roles/secretmanager.secretAccessor权限，允许它们读取Secret

2. App Engine标准环境第二世代运行时直接引用Secret #

修改app.yaml，直接从Secret Manager拉取敏感密钥：

runtime: python39
entrypoint: gunicorn -b :$PORT main:app

env_variables:
  CAPTCHA_PUBLIC_KEY: '你的公钥'  # 非敏感值可直接配置
  CAPTCHA_PRIVATE_KEY: 'projects/myprojectid/secrets/captcha-private-key/versions/latest'

# 指定有权限读取Secret的服务账号
service_account: your-service-account@myprojectid.iam.gserviceaccount.com

3. 第一世代运行时或构建时处理变量 #

如果使用第一世代运行时，可在Cloud Build步骤中读取Secret并生成.env文件，让Flask加载：

steps:
# 读取Secret并生成.env文件
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'bash'
  args:
    - '-c'
    - |
      echo "CAPTCHA_PUBLIC_KEY=$_CAPTCHA_PUBLIC_KEY" > .env
      echo "CAPTCHA_PRIVATE_KEY=$(gcloud secrets versions access latest --secret=captcha-private-key --project=myprojectid)" >> .env
# 部署应用
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'bash'
  args:
    - '-c'
    - |
      gcloud app deploy --project=myprojectid --quiet
# 创建Datastore索引
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'bash'
  args: ['-c', 'gcloud datastore indexes create index.yaml --project=myprojectid']
  timeout: '1600s'

然后在Flask项目中用python-dotenv加载变量：

from dotenv import load_dotenv
import os

load_dotenv()

captcha_public_key = os.getenv('CAPTCHA_PUBLIC_KEY')
captcha_private_key = os.getenv('CAPTCHA_PRIVATE_KEY')

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