如何用Google Cloud Buildpack打包Python项目source目录内容？

背景 #

已成功基于Sample Functions Framework Python示例应用完成GCP Buildpack本地运行，命令如下：

pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-python
docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-python

现尝试将该方案适配到Python 3.7遗留项目，项目结构如下：

.gitignore
source/
    main.py
    lib
        helper.py
    requirements.txt
tests/
    <测试文件>

原有Dockerfile逻辑是将source目录下的内容（不含source目录本身）打包到镜像的/app目录，示例片段：

COPY lib/ /app/lib
COPY main.py /app
WORKDIR /app
... Dockerfile其余内容 ...

问题1：如何用Buildpack仅打包source目录内容？ #

曾在project.toml中添加如下配置：

[[build.env]]
name = "GOOGLE_FUNCTION_SOURCE"
value = "./source/main.py"

但运行时出现模块导入错误：

File "/workspace/source/main.py", line 2, in <module>
  from source.lib.helper import mymethod
ModuleNotFoundError: No module named 'source'

虽将main.py和lib移到项目根目录可解决，但需更优方案。

解决方案 #

无需移动文件，只需调整两处配置：

1. 修正导入语句：Buildpack默认将项目根目录加入Python路径，指定GOOGLE_FUNCTION_SOURCE为./source/main.py后，运行环境中source是子目录，因此main.py里的导入需改为from lib.helper import mymethod（去掉前缀source.）。
2. 指定依赖文件路径：由于requirements.txt在source目录下，需在project.toml中补充配置让Buildpack识别：

[[build.env]]
name = "GOOGLE_FUNCTION_SOURCE"
value = "./source/main.py"

[[build.env]]
name = "PIP_REQUIREMENTS_FILE"
value = "./source/requirements.txt"

此配置下，Buildpack会正确加载依赖，同时默认忽略tests目录及.gitignore中指定的内容，仅将source目录核心代码打包进运行镜像。

问题2：如何查看Buildpack复制到镜像的项目文件？ #

可通过以下两种方式查看：

• 容器内直接查看：运行构建好的镜像并进入交互模式，默认工作目录为/workspace，执行命令查看文件结构：

  docker run -it --entrypoint bash <镜像名称>
  # 查看文件列表
  ls -la /workspace
  # 递归查找所有文件
  find /workspace -type f
  

• 构建阶段日志分析：启用Buildpack详细日志，查找Copying files相关步骤：

  pack build --builder=gcr.io/buildpacks/builder <镜像名> --verbose
  

  也可通过pack inspect-build <镜像名>查看构建阶段的文件处理细节。

更新说明 #

此前的模块导入错误是因移动lib目录到source后，IntelliJ自动更新了main.py的导入语句未被察觉，修正导入后应用上述方案即可正常运行。

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