为 Google Cloud App Engine Flexible 指定 Node.js 版本

Question

我正在尝试部署 GCloud App Engine 灵活服务。我有一个 yaml 文件，其中指定了 Node.js 运行时和 env。

runtime: nodejs
env: flex

正如文档所说“您可以使用引擎字段在应用程序的 package.json 文件中指定不同的 Node.js 版本。”，我还在package.json 中添加了以下内容：

"name": "@bindr/dev",
"version": "1.0.0",
"engines": {
  "node": ">=14.0.0"
},

但是，当我运行 gcloud app deploy 时，我收到以下错误：

error @bindr/dev@1.0.0: The engine "node" is incompatible with this module. Expected version ">=14.0.0". Got "12.19.0"

部署过程似乎没有考虑engines 属性，因为即使我指定了无效版本（例如>=18.0.0）它仍然没有抱怨，只有yarn install 失败。如何让构建过程使用指定的 Node 版本？

我发现我可以在 cloudbuild.yaml 中为构建的某些步骤指定 Node 的版本，如下所示：

steps:
  - name: node:node-14.10.0
    args: ['predeploy.js', 'content-server']
  - name: 'gcr.io/cloud-builders/yarn:node-14.17.1'
    args: ['install']
  - name: 'gcr.io/cloud-builders/gcloud'
    args: ['app', 'deploy']
timeout: '900s'

在此过程中，yarn install 步骤成功，但在尝试安装依赖项时gcloud app deploy 步骤仍然失败（我找不到如何将节点版本指定为gcr.io/cloud-builders/gcloud，它没有好像是这样的标签）。

我还检查了相同的12.19.0 版本正在生产实例上运行，因此不仅构建环境具有旧版本。

我做错了什么？

Answer 1

我遇到了同样的问题并为它创建了一个问题here。我怀疑这是 Google App Engine 的错误，而不是您的应用程序的错误。

作为一种解决方法，我最终为我的应用使用了custom runtime。为此，在您的 GAE 配置文件中，您从 runtime: nodejs 切换到 runtime: custom 并将 Dockerfile 添加到您的项目根目录。关于编写 dockerfile here 有很好的文档，但这里有一个您可以使用的简单文档：

# syntax=docker/dockerfile:1

FROM node:14.10.0
ENV NODE_ENV=production

WORKDIR /app

COPY ["package.json", "package-lock.json*", "./"]

RUN npm install --production

COPY . .

CMD [ "node", "server.js" ]

您可能还需要一个至少包含node_modules 的.dockerignore 文件。

最终我认为GAE修复会更好，因为在package.json中配置你的节点版本会更简单，就像你应该能够做到的那样。但这应该足以让事情正常运行并避开似乎是 GAE 错误的问题。

Answer 2

总结一下，正如@CharlieA 提到的，App Engine Flex 环境有一个 Node.js 的默认图像，当前版本为12.19.01。

正如@Cleanbeans 所指出的，根据Flex environment docs，Node.js 的运行时应该在app.yaml 中指定为runtime: nodejs，统一其他可以指定版本号的语言。这解释了为什么尽管指定了版本 14，但引擎仍返回默认版本。

回到@CharlieA 评论，这可以通过使用app.yaml 中的自定义运行时来修复，如下所示：runtime: custom。

或者，尝试在您的package.json 中使用固定版本，正如Github thread 中所讨论的那样。

除了上面提到的 Github 线程，@CharlieA 还创建了一个Public Issue tracker 供 Google 审核。您可能需要请求 documentation 更新，详细说明如何在灵活环境中指定 Node.js 版本。

Answer 3

所以看看这个doc，特别注意这一行

engines.node 属性是可选的，但如果存在，该值必须与 app.yaml 文件中指定的 Node.js 版本兼容。例如：

我相信默认版本是 12（即runtime: nodejs），以便在您的app.yaml 文件集运行时中更正此问题，如下runtime: nodejs14 或更新版本

还请记住，次要补丁会自动更新，因此您只能指定主要版本，即 14.X.X。此外，如果您声明的版本不可用，则构建过程将失败。

注意：如果您使用带有 cloudbuild.yaml 和 flex 环境的云构建，您可能会遇到构建错误，请将 cloudbuild.yaml 移动到其自己的文件夹中以防止出现此错误并使用 --config 选项来说明yaml。如需进一步指导，请参阅this doc