AWS CodePipeline无公网VPC下Docker构建离线安装nvm方案咨询
无公网VPC下Docker内离线安装nvm的落地实现方案
核心思路
原在线Dockerfile的所有公网请求,全部替换为从本地构建上下文读取离线资源完成安装,完全不依赖外网连通性,适配无互联网网关的VPC构建环境。
前置准备
在有公网的本地环境提前下载全部依赖资源,统一存放到与Dockerfile同层的offline-assets目录,确保目录在Docker构建上下文范围内:
- 对应版本的nvm源码压缩包(匹配原脚本使用的v0.37.2版本)
- 与
NODE_VERSION参数完全一致的Node.js Linux x64二进制压缩包 - 两个需要全局安装的npm包的离线tgz包:
aws-cdk、cdk-assume-role-credential-plugin@1.1.1
Dockerfile改造步骤
替换原有涉及公网请求的命令,完整可运行的改造后片段如下:
# 复制本地离线资源进入镜像临时目录 COPY ./offline-assets /tmp/offline-assets # 替换原curl在线安装nvm的命令 RUN mkdir -p ~/.nvm && \ # 解压nvm源码到默认安装路径,移除压缩包自带的顶层目录 tar -xzf /tmp/offline-assets/nvm-v0.37.2.tar.gz -C ~/.nvm --strip-components=1 && \ chmod +x ~/.nvm/nvm.sh # 替换原在线拉取Node、在线安装npm全局包的命令 RUN /bin/bash -c ". ~/.nvm/nvm.sh && \ # 从本地离线包安装指定版本Node,跳过公网拉取 nvm install /tmp/offline-assets/node-v${NODE_VERSION}-linux-x64.tar.xz && \ nvm use $NODE_VERSION && \ # 从本地离线包安装全局npm组件,跳过公网源请求 npm install -g /tmp/offline-assets/aws-cdk.tgz /tmp/offline-assets/cdk-assume-role-credential-plugin-1.1.1.tgz && \ nvm alias default node && \ nvm cache clear && \ # 清理临时离线资源,减小镜像体积 rm -rf /tmp/offline-assets" # 以下原有配置逻辑无需改动,与离线安装路径完全兼容 RUN echo export PATH="\ /root/.nvm/versions/node/${NODE_VERSION}/bin:\ $(python3.8 -m site --user-base)/bin:\ $(python3 -m site --user-base)/bin:\ $PATH" >> ~/.bashrc && \ echo "nvm use ${NODE_VERSION} 1> /dev/null" >> ~/.bashrc RUN /bin/bash -c ". ~/.nvm/nvm.sh && cdk --version" ENTRYPOINT [ "/bin/bash", "-c", ". ~/.nvm/nvm.sh && uvicorn cdkproxymain:app --host 0.0.0.0 --port 8080" ]
关键注意事项
- 原nvm在线安装脚本的核心动作仅为将nvm源码解压到
/root/.nvm路径、追加bashrc配置,离线操作的步骤与脚本逻辑完全等价,不存在功能缺失。之前尝试将nvm文件夹放到项目src目录的实现方向完全可行,只要确保nvm的所有文件平铺到/root/.nvm路径下,nvm.sh就可以被正常加载,不需要依赖在线脚本的逻辑 - 所有离线资源的版本必须和原在线流程的版本严格对齐,避免运行时出现版本不兼容问题
- nvm原生支持传入本地二进制压缩包路径完成Node安装,npm原生支持传入本地tgz包路径完成全局安装,两个能力都不会触发任何外网请求,适配无公网VPC的构建环境
- 确保
offline-assets目录被纳入CodePipeline的代码同步范围,不要加入.gitignore文件,避免构建时找不到本地资源
内容的提问来源于stack exchange,提问作者Jaja
相关产品推荐
相关产品推荐

