ewally/serverless-ci

Node.js无服务器项目测试与部署镜像

镜像概述

本镜像是专为Node.js无服务器（Serverless）项目设计的测试与部署工具集合，基于Node.js环境构建，集成了项目测试、验证及部署所需的核心工具链。旨在简化无服务器项目的开发流程，提供一致的测试环境和便捷的部署能力，适用于开发阶段验证及CI/CD流程集成。

核心功能与特性

测试工具集成

• 内置主流Node.js测试框架（Jest、Mocha、Chai等），支持单元测试、集成测试及端到端测试
• 提供测试覆盖率分析工具（Istanbul），生成标准化测试报告
• 支持测试环境变量配置，模拟生产环境依赖

部署工具支持

• 集成Serverless Framework核心组件，支持AWS Lambda、Azure Functions、Google Cloud Functions等主流无服务器平台部署
• 内置AWS CLI、Azure CLI等云平台命令行工具，支持直接与云资源交互
• 支持部署配置文件自动解析，简化部署参数设置

环境兼容性

• 支持Node.js 12+、14+、16+、18+版本运行环境，可通过环境变量指定版本
• 兼容Linux/amd64架构，支持主流容器化运行环境（Docker、Kubernetes）
• 轻量级设计，基于Alpine Linux，减少镜像体积

使用场景

• 开发阶段：本地运行自动化测试，验证无服务器函数逻辑正确性
• CI/CD流程：集成到Jenkins、GitHub Actions等持续集成工具，实现测试通过后自动部署
• 多环境部署：通过环境变量配置，支持开发、测试、生产环境的差异化部署
• 团队协作：统一测试与部署工具链，避免环境差异导致的问题

使用方法与配置说明

基本使用方式

通过docker run命令启动容器，挂载项目目录并执行测试或部署命令：

bash
# 运行项目测试
docker run -v /本地项目路径:/app -e NODE_VERSION=16 --rm your-image-name npm test

# 执行部署操作
docker run -v /本地项目路径:/app -e DEPLOY_TARGET=prod -e AWS_ACCESS_KEY=xxx -e AWS_SECRET_KEY=xxx --rm your-image-name serverless deploy

环境变量配置

部署示例（docker-compose）

创建docker-compose.yml配置文件，集成测试与部署流程：

yaml
version: '3'
services:
  sls-test-deploy:
    image: your-image-name
    volumes:
      - ./:/app
    environment:
      - NODE_VERSION=18
      - DEPLOY_TARGET=test
      - AWS_ACCESS_KEY=${AWS_ACCESS_KEY}
      - AWS_SECRET_KEY=${AWS_SECRET_KEY}
    command: sh -c "npm install && npm test && serverless deploy --stage test"

注意事项

• 本地项目需包含package.json及测试配置文件（如jest.config.js、serverless.yml）
• 部署敏感信息（如云平台密钥）建议通过环境变量注入，避免硬编码
• 首次运行时会自动安装项目依赖，建议挂载node_modules目录以加速后续执行

镜像维护与更新

• 基础镜像定期更新，同步Node.js安全补丁
• 工具链版本（Serverless Framework、测试框架等）随主流版本迭代更新
• 镜像标签规则：{node-version}-{toolchain-version}（如16-3.28.0表示Node.js 16 + Serverless Framework 3.28.0）