有些前端的小伙伴可能会好奇,nvm是什么?这里接简单介绍下,它是一个Nodejs版本管理工具。为什么需要它呢?当然是需要多个Nodejs版本的时候,那什么时候需要多个Nodejs版本?那肯定是在有点年头的公司了,例如vue2的很多依赖都是在Nodejs14年代的,如果你升级到Node20,那很可能会报错。如果你用vite创建新项目,那也肯定是没法在Node14下运行。(如果你问为啥要Nodejs,欢迎留言,或者看一部它的纪录片哈)
迭代过快虽然能够享受到各种新科技,但对于很多公司来说,去适配nodejs版本也是不太值得投入的成本。ε=(´ο`*)))唉,想想前端就累呀
报错信息具体内容
# node -v
node: /lib64/libm.so.6: version `GLIBC_2.27' not found (required by node)
node: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.20' not found (required by node)
node: /lib64/libstdc++.so.6: version `CXXABI_1.3.9' not found (required by node)
node: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.21' not found (required by node)
node: /lib64/libc.so.6: version `GLIBC_2.28' not found (required by node)
node: /lib64/libc.so.6: version `GLIBC_2.25' not found (required by node)
nodejs都不可用,更别说构建了,如果构建不出东西,在这个依赖框架的年代,就相当于白干啊!突然怀念jquery的时代了,(#^.^#)
触发场景
- 有老的vue项目,需要nodejs14 (这个必须的,18+就构建不了!)
- 有新的vue3项目,需要nodejs20+ (vite需要的,ε=(´ο`*)))唉,自己开发是挺爽,但没想到CI这里出问题了哈)
- 必须要jenkins上部署和构建(jenkins跑在linux上,之前我被windows server版docker搞的头发掉了一大撮)
- 构建物必须是一个docker镜像,这几个项目放在一个镜像(就是要一次构建多个项目)
好像上面是这个时代比较通用的了,于是便很自然的安装了nvm,构建不同项目之前,用nvm切换下。
问题分析
但是,当我构建vue3项目是,就遇到上面的报错了。呃,搜索一通,么得什么头绪,我发现切回去node16就可以了,啊,竟然是版本问题,后面发现是宿主机的centos版本太低了,我的天!我没想到一个前端竟然遇到这个问题,也算是长姿势了!
于是这时候就有个解决办法了,那就是让运维的部署点高版本的centos吧!提了个需求,但不知道何时才能实现,等等等
解决办法
看到这里,问题大概就是找到了,也可以解决了:那就是升级centos版本
解决问题思路扩展
在docker容器内构建项目
但是我从第一性原理开始想,为啥我需要安装这个Nodejs呢?既然产出物是前端代码,部署又不需要这个nodejs(只需要一个nginx镜像+那些构建物),构建的时候能不能使用Docker构建,只要用不同的镜像去构建,不就可以了?说干就干。
下面是Dockerfile构建脚本: 阶段1构建,注意不同的项目修改自己node:版本 (这里用到了docker的多阶段构建,想了解的可以自己去研究,或许后期我会抽空介绍它的好处)
# 构建阶段
FROM node:20.16-alpine as builder# 设置工作目录
WORKDIR /app# 复制package.json和package-lock.json(如果存在)
COPY package*.json ./# 安装项目依赖
RUN npm install# 复制项目文件到工作目录
COPY . .# 构建应用
RUN npm run build
这个构建的产出物在镜像内的/app/dist,如果是直接docker部署,可以使用第二个stage直接复制到新的镜像中,但此时为考虑到某些场景需要提取出这个目录,就需要一个辅助的nodejs方法:
1. 构建
2. 启动容器
3. 复制到目标目录
启动临时容器复制到宿主机目录
一个全功能辅助的nodejs脚本
下面这个方法是一个build.cjs脚本内容,构建的时候,定义好需要构建的模块,然后node build.cjs就可以了,这里不展开。
function buildRunCopy(imageName, dockerfileDir, containerDist, outputDir) {// 生成容器名称const containerName = `container-${imageName}`;// 构建 Dockerfile 路径和输出目录的绝对路径const dockerfilePath = path.resolve(dockerfileDir, "Dockerfile");const hostDir = path.resolve(outputDir);try {// 创建宿主机目录(如果不存在的话)if (!fs.existsSync(hostDir)) {fs.mkdirSync(hostDir, { recursive: true });}// 构建 Docker 镜像console.log("Building Docker image...");execSync(`docker build -t ${imageName} -f ${dockerfilePath} ${dockerfileDir}`,{stdio: "inherit",cwd: dockerfileDir,});console.log("Docker image built successfully.");// 运行 Docker 容器console.log("Running Docker container...");execSync(`docker run --name ${containerName} -d ${imageName}`);console.log("Docker container started successfully.");// 复制容器内的目录到宿主机目录execSync(`docker cp ${containerName}:/${containerDist} ${hostDir}`);console.log("Files copied successfully.");} catch (error) {console.error(`Error: ${error.message}`);throw error;} finally {// 停止并移除 Docker 容器try {console.log("Removing Docker container...");execSync(`docker rm -f ${containerName}`);console.log("Docker container removed successfully.");} catch (removeError) {console.error(`Error removing Docker container: ${removeError.message}`);}}
}
脚本函数用法举例
下面就是一个例子:将项目某个test-app下面的项目进行构建,并将其构建物从/app/dist复制到原项目下面的dist目录
// 构建 build.cjs const basePath = path.join(projectsBasePath, "test-app");const tmpDistFolder = path.join(basePath, "dist");console.info(`清理构建临时目录`);fs.rmSync(tmpDistFolder, { recursive: true, force: true });buildRunCopy("test-app", basePath, "/app/dist", basePath);
然后就可以实现使用docker构建项目了,宿主机的nodejs只需要跑这个脚本,构建过程用到的nodejs是来自于容器内的,想用啥版本直接修改Dockerfile文件就可了
看完记得活动下脖子,这算是我今天的前3.5个小时的总结了...