在Google Cloud上为Python应用添加本地依赖仓库

碰到这种本地依赖部署不上的问题太常见了，我给你几个亲测有效的解决办法：

方案1：将本地依赖打包上传到GCS，在requirements.txt中指定路径 #

这是最通用的方法，适合任何环境：

1. 先把你的本地依赖打包成wheel格式（比源码包更稳定，避免编译问题）：

cd /path/to/your/local-dependency-folder
python setup.py bdist_wheel

执行后会在dist/目录下生成类似your-package-1.0.0-py3-none-any.whl的文件。

2. 把这个wheel文件上传到Google Cloud Storage的存储桶：

gsutil cp dist/your-package-1.0.0-py3-none-any.whl gs://your-bucket-name/dependencies/

3. 给这个文件设置公开可读权限（或者确保App Engine的服务账号有读取权限，公开设置更简单）：

gsutil acl ch -u AllUsers:R gs://your-bucket-name/dependencies/your-package-1.0.0-py3-none-any.whl

4. 最后修改项目根目录的requirements.txt，开头添加两行：

--find-links=https://storage.googleapis.com/your-bucket-name/dependencies/
your-package==1.0.0

这样gcloud app deploy执行时，pip会自动从GCS拉取并安装这个依赖。

方案2：把本地依赖放到项目目录，用相对路径引用 #

如果你的依赖体积小、不需要保密，可以直接把它的wheel文件放到项目的子目录里（比如./local_deps/）：

1. 将生成的wheel文件复制到项目的local_deps目录（没有就新建一个）。
2. 修改requirements.txt，添加：

--find-links=./local_deps/
your-package==1.0.0

部署时gcloud会把local_deps目录一起上传到服务器，pip就能找到这个依赖完成安装。

注意：如果用的是源码包而非wheel，App Engine标准环境可能缺少编译工具，导致安装失败，所以优先用wheel格式。

方案3：使用灵活环境自定义Dockerfile（完全控制安装流程） #

如果你的应用用的是App Engine灵活环境，那可以通过Dockerfile完全自定义部署步骤：

1. 在项目根目录创建Dockerfile，内容示例：

FROM gcr.io/google-appengine/python
WORKDIR /app
# 复制项目所有文件到镜像中
COPY . /app
# 安装依赖，指定本地依赖的路径
RUN pip install --find-links=./local_deps -r requirements.txt
# 设置启动命令（根据你的入口文件调整）
CMD ["gunicorn", "-b", ":$PORT", "main:app"]

这里假设本地依赖放在./local_deps目录，main.py是应用入口文件。

2. 修改app.yaml，指定使用自定义镜像：

runtime: custom
env: flex

部署时gcloud会按照你写的Dockerfile构建镜像，完全控制依赖安装的每一步。

方案4：自定义部署脚本（不推荐） #

你也可以写一个shell脚本，先把本地依赖上传到临时存储，再修改requirements.txt的路径后调用gcloud app deploy，但这个方法比较繁琐且不稳定，因为App Engine的部署环境是临时的，除非特殊情况不建议用。

总结下来，方案1和方案2是最省心的，方案3适合需要高度定制环境的场景。

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