如何将含本地依赖的Turborepo Monorepo应用部署为Google Cloud Function？

下面是几个优雅的解决方案，帮你处理本地workspace:*依赖导致的部署失败问题：

方案1：用pnpm Deploy打包独立部署目录 #

pnpm自带的deploy命令可以把当前包及其所有依赖（包括本地workspace依赖）打包成一个独立目录，完全适配gcloud的部署流程：

1. 在云函数子包的package.json里加个准备部署的脚本：

{
  "scripts": {
    "deploy:prepare": "pnpm deploy --prod ./dist-deploy"
  }
}

2. 先执行项目构建和打包：

pnpm run build && pnpm run deploy:prepare

3. 让gcloud从打包好的目录部署：

gcloud functions deploy myCloudFunction \
  --entry-point myMainFunction --env-vars-file .env.yaml \
  --runtime nodejs16 --trigger-topic MY_TOPIC \
  --source ./dist-deploy

这个命令会把所有依赖（包括本地workspace包的构建产物）都复制到dist-deploy目录，gcloud部署时直接读取该目录，不会再解析workspace:*引用。

方案2：结合Turborepo管道+pnpm Pack处理本地依赖 #

如果要保留Turborepo的构建缓存优势，可以先把本地依赖打包成tar包，再让云函数包引用这些tar包：

1. 在项目根目录的turbo.json里添加打包任务的管道配置：

{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"]
    },
    "pack": {
      "dependsOn": ["build"],
      "outputs": ["*.tgz"]
    }
  }
}

2. 给每个本地依赖包的package.json加个pack脚本：

{
  "scripts": {
    "pack": "pnpm pack"
  }
}

3. 修改云函数子包的package.json，把workspace:*依赖替换成对应tar包的本地路径：

{
  "dependencies": {
    "@myrepo/utils": "./../utils/myrepo-utils-1.0.0.tgz"
  }
}

4. 执行Turbo构建+打包，再部署：

turbo run build pack && gcloud functions deploy myCloudFunction \
  --entry-point myMainFunction --env-vars-file .env.yaml \
  --runtime nodejs16 --trigger-topic MY_TOPIC

这个方法会利用Turborepo的缓存机制，只重新打包有变更的本地依赖，适合大型Monorepo场景。

方案3：自定义脚本复制本地依赖到node_modules #

如果需要更灵活的控制，可以写个简单脚本，在构建后把本地workspace依赖的构建产物复制到云函数包的node_modules里：

1. 在云函数子包目录下创建copy-local-deps.js脚本：

const fs = require('fs-extra');
const path = require('path');

async function copyLocalDeps() {
  const pkg = await fs.readJson(path.join(__dirname, 'package.json'));
  for (const [depName, depVersion] of Object.entries(pkg.dependencies)) {
    if (depVersion === 'workspace:*') {
      // 根据你的Monorepo目录结构调整本地依赖的路径
      const localDepDir = depName.replace('@your-repo/', '');
      const localDepPath = path.join(__dirname, '..', localDepDir);
      const targetPath = path.join(__dirname, 'node_modules', depName);
      
      await fs.remove(targetPath);
      // 复制本地依赖的构建产物（假设本地依赖的build输出在dist目录）
      await fs.copy(path.join(localDepPath, 'dist'), targetPath);
    }
  }
}

copyLocalDeps().catch(err => console.error('复制本地依赖失败:', err));

2. 在云函数子包的package.json里加个postbuild脚本，让构建完成后自动执行复制：

{
  "scripts": {
    "postbuild": "node copy-local-deps.js"
  }
}

3. 然后正常执行构建和部署命令即可：

pnpm run build && gcloud functions deploy myCloudFunction \
  --entry-point myMainFunction --env-vars-file .env.yaml \
  --runtime nodejs16 --trigger-topic MY_TOPIC

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