使用Cloud Builders Community镜像构建Angular时Node SASS安装失败

根因分析 #

你判断的版本兼容问题完全正确。本次构建失败的核心原因是cloud-builders-community中ng构建器的默认配置问题：其Dockerfile使用node:current作为基础镜像，你构建时对应版本为Node 16.10.0，而内置依赖的node-sass@3.5.5最高仅支持到Node 14，高版本Node下编译原生模块必然报错。

解决方法 #

方案1：修改本地构建器配置后重新提交

这是最贴合你当前操作流程的修复方式：

1. 进入你已经克隆的cloud-builders-community/ng目录
2. 编辑目录下的Dockerfile，将第一行的FROM node:current替换为FROM node:14-bullseye
3. 重新执行提交命令即可：

gcloud builds submit --config cloudbuild.yaml .

Node14与对应版本的node-sass、node-gyp 3.8.0完全兼容，不会再出现编译错误。

方案2：跳过自定义ng构建器部署，直接使用官方Node镜像

如果你不需要复用ng自定义构建器，后续Cloud Build流程可以直接用官方Node镜像完成Angular构建，不需要提前编译自定义构建器，从根源避免这类依赖问题，示例构建步骤如下：

steps:
  - name: node:14
    entrypoint: npm
    args: ['install', '-g', '@angular/cli@latest']
  - name: node:14
    entrypoint: npm
    args: ['install']
  - name: node:14
    entrypoint: ng
    args: ['build', '--prod']

额外优化建议 #

node-sass已经官方废弃，目前Angular生态已经全面切换为dart-sass（包名为sass），如果你的项目还在使用node-sass，建议后续替换为sass依赖，可以完全避免后续Node版本升级带来的原生模块编译问题。

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