jhtna/node-build Docker 镜像 - 轩辕镜像

BitBucket Pipelines的Node构建环境

概述

基于官方Node Docker镜像的构建环境，专为BitBucket Pipelines设计。包含Node运行时、构建工具、Docker客户端和AWS CLI，可满足多种构建场景需求。$HOME目录路径设置为/root/。

核心功能和特性

• 包含Node运行时环境
• 内置构建工具（make、gcc等）
• 集成Docker客户端
• 预装AWS CLI工具
• 支持Docker构建、Node项目构建和Selenium测试
• 提供环境配置脚本简化构建流程

使用场景和适用范围

适用于BitBucket Pipelines中的以下场景：

• Node.js项目构建和打包
• Docker镜像构建与推送
• 基于Selenium的自动化测试
• 需要AWS服务交互的构建流程
• 使用私有npm仓库或BitBucket托管npm模块的项目

使用方法和配置说明

Docker构建

环境变量配置

使用Docker命令连接Docker构建服务器时，需设置以下环境变量：

• AWS_ACCESS_KEY_ID: 用于获取Docker构建服务器证书和ECR登录
• AWS_SECRET_ACCESS_KEY: AWS访问密钥
• AWS_DEFAULT_REGION: AWS默认区域
• S3_DOCKER_CERT_LOCATION: Docker证书的S3存储路径（格式：s3://<路径>）
• DOCKER_HOST: Docker服务器连接地址（格式：tcp://<主机地址>）
• DOCKER_TLS_VERIFY: 必须设置为1（启用TLS验证）
• DOCKERHUB_USERNAME: Docker Hub登录用户名
• DOCKERHUB_PASSWORD: Docker Hub登录密码

构建流程

在构建脚本中执行以下命令完成ECR/Docker Hub登录和证书配置：

bash
$HOME/setup-docker.bash

Node构建

私有npm仓库配置

使用私有npm仓库时，需设置环境变量：

• NPM_TOKEN: npm仓库访问令牌

BitBucket托管npm模块配置

使用BitBucket托管的npm模块时：

1. 设置环境变量 S3_SSH_KEY_LOCATION，指定用于BitBucket SSH访问的私钥S3路径
2. 在构建脚本中执行以下命令配置SSH密钥和known_hosts：

bash
$HOME/setup-ssh.bash

Selenium测试构建

环境准备

使用webdriver测试Firefox或Chromium时：

1. 在测试前执行以下命令启动XVFB：

bash
$HOME/start-xvfb.bash

2. 可通过XVFB_SCREEN_DIMENSIONS环境变量自定义屏幕分辨率（默认：1280x1024x16）
3. 默认显示端口为:1.0

推荐配置

• 设置NPM_CONFIG_LOGLEVEL=warn减少npm输出信息
• 设置bower_quiet=true减少bower输出信息