rocketmakers/ci-build-node-gcp

镜像概述

本镜像为针对Google Cloud Platform (GCP) 环境优化的Node.js构建专用Docker镜像，专门用于基于Node.js的脚本执行或后端应用构建场景。通过预集成GCP CLI及相关工具链，简化在GCP环境中进行Node.js项目构建、打包和部署的流程，确保开发环境与GCP生产环境的一致性。

核心功能与特性

• GCP环境深度适配：内置GCP命令行工具（gcloud CLI）及认证组件，支持与GCP服务（如Cloud Storage、Cloud Build、Artifact Registry）无缝集成
• 完整Node.js环境：包含稳定版Node.js运行时及npm/yarn包管理器，支持多版本Node.js配置（通过环境变量指定）
• 多场景构建支持：同时支持独立Node.js脚本执行和复杂后端应用（如Express、NestJS）的构建流程
• 轻量级优化：基于Alpine或Debian slim基础镜像构建，减小镜像体积，提升CI/CD流水线执行效率

使用场景与适用范围

• GCP云平台上的Node.js项目持续集成/持续部署（CI/CD）流水线
• 需要与GCP服务交互的Node.js后端应用构建过程
• 自动化脚本执行（如数据处理、云资源管理脚本）
• 本地开发环境与GCP生产环境的构建一致性保障

使用方法与配置说明

基本使用（docker run）

bash
# 执行Node.js构建脚本
docker run --rm -v $(pwd):/app \
  -e GCP_PROJECT_ID=your-gcp-project-id \
  ***-gcr.xuanyuan.run/[your-project-id]/node-gcp-build:latest \
  node /app/scripts/build.js

# 运行后端应用构建命令
docker run --rm -v $(pwd):/app \
  -e NODE_ENV=production \
  ***-gcr.xuanyuan.run/[your-project-id]/node-gcp-build:latest \
  sh -c "npm install && npm run build"

docker-compose配置示例

yaml
version: '3.8'
services:
  node-build:
    image: ***-gcr.xuanyuan.run/[your-project-id]/node-gcp-build:latest
    volumes:
      - ./:/app  # 挂载本地项目代码
      - ~/.config/gcloud:/root/.config/gcloud  # 挂载本地gcloud配置（可选）
    environment:
      - NODE_ENV=production
      - GCP_PROJECT_ID=your-gcp-project-id
      - NODE_VERSION=18  # 指定Node.js版本（默认最新LTS）
    working_dir: /app
    command: >
      sh -c "npm install && 
             npm run lint && 
             npm run build && 
             gcloud builds submit --tag gcr.io/your-gcp-project-id/your-app:latest"

环境变量配置

构建流程示例

1. 准备工作：确保本地已安装Docker及gcloud CLI（用于推送镜像至GCP Artifact Registry）
2. 项目挂载：将Node.js项目代码目录挂载至容器内/app目录
3. GCP认证：通过挂载本地gcloud配置文件（~/.config/gcloud）或设置GOOGLE_APPLICATION_CREDENTIALS环境变量进行认证
4. 执行构建：运行构建命令（如npm run build），利用容器内GCP工具将构建产物部署至GCP服务

注意事项

• 若需使用私有npm包，需通过NPM_REGISTRY环境变量配置私有仓库地址，并在容器内设置npm认证（可通过挂载.npmrc文件实现）
• 生产环境建议指定具体Node.js版本（通过NODE_VERSION）以确保构建一致性
• 敏感信息（如GCP密钥）建议通过环境变量或挂载外部文件传入，避免硬编码在镜像中