namiaio/node-docker

用于BitBucket流水线的Node.js项目Docker镜像

镜像概述

本镜像专为BitBucket流水线（BitBucket Pipelines）设计，基于Node.js环境构建，旨在简化Node.js项目在CI/CD流程中的集成。通过预配置的Node.js运行时环境，支持在BitBucket的持续集成/持续部署（CI/CD）流程中快速构建、测试和运行Node.js应用，减少手动配置成本。

核心功能与特性

• Node.js环境支持：内置Node.js运行时及npm/yarn包管理器，兼容主流Node.js版本（具体版本需参考镜像标签）。
• BitBucket Pipelines兼容：预配置以适配BitBucket流水线环境，可直接作为CI/CD步骤的执行环境。
• CI/CD流程优化：简化项目构建、依赖安装、单元测试、代码检查等流水线步骤的配置。
• 轻量级设计：基于官方Node.js基础镜像优化，减少镜像体积，提升流水线执行效率。

使用场景与适用范围

• BitBucket托管的Node.js项目：适用于所有使用BitBucket进行代码托管的Node.js应用（如React、Vue、Express等前后端项目）。
• 持续集成流程：用于代码提交后的自动化构建、依赖安装、单元测试、代码质量检查（如ESLint）等场景。
• 持续部署流程：支持在流水线中完成应用打包、镜像构建、部署到测试/生产环境等部署环节。
• 开发环境标准化：确保团队成员及CI/CD环境使用统一的Node.js版本和依赖管理工具，避免"本地能跑，线上报错"问题。

使用方法与配置说明

1. 在BitBucket Pipelines中使用

在BitBucket仓库的bitbucket-pipelines.yml配置文件中直接引用本镜像，示例如下：

yaml
# bitbucket-pipelines.yml
image: [镜像名称]:[标签]  # 例如：bitbucket-nodejs:18（对应Node.js 18.x版本）

pipelines:
  default:
    - step:
        name: 安装依赖并构建
        script:
          - npm install  # 安装项目依赖
          - npm run lint  # 代码质量检查（如配置）
          - npm run test  # 运行单元测试
          - npm run build  # 构建项目（如前端项目打包）
    - step:
        name: 部署到测试环境
        script:
          - npm run deploy:test  # 执行部署脚本（需项目内定义）

2. 本地测试或独立运行

通过docker run命令可在本地模拟流水线环境或运行Node.js应用，示例：

bash
# 挂载本地项目目录并运行npm命令
docker run --rm -v $(pwd):/app -w /app [镜像名称]:[标签] npm run build

# 交互式进入容器环境
docker run -it --rm [镜像名称]:[标签] /bin/bash

3. 环境变量配置

可通过环境变量自定义镜像行为，常用配置如下：

示例：指定国内npm镜像源加速依赖安装

yaml
# 在bitbucket-pipelines.yml中配置环境变量
image: [镜像名称]:18
pipelines:
  default:
    - step:
        script:
          - npm install
        environment:
          NPM_REGISTRY: https://registry.npmmirror.com

注意事项

• 版本选择：通过镜像标签指定Node.js版本（如:16对应Node.js 16.x，:18对应18.x），需与项目兼容的Node.js版本匹配。
• 权限配置：在BitBucket流水线中使用时，确保仓库已启用Pipelines功能，并配置足够的构建权限（如访问私有依赖仓库、部署目标环境等）。
• 缓存优化：为提升流水线效率，建议结合BitBucket Pipelines的缓存功能缓存node_modules目录（需在bitbucket-pipelines.yml中配置caches字段）。