rocketmakers/ci-build-node-az

Azure Node.js构建镜像

镜像概述

本镜像为Node.js构建流程提供Azure环境优化版本，专为在Azure云平台中运行Node.js脚本或后端项目的构建任务设计。它集成了Azure服务兼容性组件，可无缝对接Azure DevOps、Azure Container Instances等服务，简化Node.js项目在Azure生态中的构建流程。

核心功能与特性

• Azure环境适配：预配置Azure服务集成所需依赖，支持与Azure资源（如Blob Storage、Key Vault）的安全交互
• Node.js构建支持：内置Node.js运行时及npm/yarn包管理工具，支持多种Node.js版本（可通过环境变量指定）
• 多项目类型兼容：同时支持独立Node.js脚本执行和Node.js后端应用（Express、NestJS等框架）的构建流程
• 构建流程优化：包含缓存机制，加速依赖安装过程，提升构建效率

使用场景

• Azure DevOps流水线中的Node.js项目自动化构建
• Azure Container Instances中运行Node.js后端应用的构建任务
• 需要与Azure服务（如数据库、存储）集成的Node.js脚本执行环境
• 本地开发环境中模拟Azure生产环境的Node.js构建测试

使用方法与配置说明

基础使用（docker run）

bash
# 基本交互式运行
docker run -it --rm docker.xuanyuan.run/azure-node-build:latest

# 执行Node.js脚本
docker run -v $(pwd):/app -w /app docker.xuanyuan.run/azure-node-build:latest node script.js

# 指定Node.js版本
docker run -e NODE_VERSION=18 -it --rm docker.xuanyuan.run/azure-node-build:latest

环境变量配置

Docker Compose示例

yaml
version: '3'
services:
  node-build:
    image: docker.xuanyuan.run/azure-node-build:latest
    environment:
      - NODE_VERSION=20
      - AZURE_CREDENTIALS={"clientId":"xxx","clientSecret":"xxx","tenantId":"xxx"}
    volumes:
      - ./src:/app
      - build-cache:/root/.npm
    working_dir: /app
    command: npm run build

volumes:
  build-cache:

与Azure DevOps集成

在Azure DevOps Pipeline中使用：

yaml
jobs:
- job: Build
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - task: Docker@2
    inputs:
      containerRegistry: 'azure-acr'
      repository: 'azure-node-build'
      command: 'run'
      arguments: '-v $(Build.SourcesDirectory):/app -w /app -e AZURE_CREDENTIALS=$(azure-creds) azure-node-build:latest npm run build'

注意事项

• 使用AZURE_CREDENTIALS时需确保权限最小化，建议仅授予构建所需的资源访问权限
• 本地开发时，可通过挂载~/.azure目录共享Azure CLI认证信息，避免重复配置
• 如需自定义Node.js版本，需确保镜像支持该版本（目前支持LTS版本14及以上）