teracyhq/angular-cli Docker镜像文档

概述

teracyhq/angular-cli是一个基于官方Node.js镜像构建的Docker镜像，预安装了Angular CLI及相关开发工具，旨在提供一个一致、可移植的Angular应用开发环境。该镜像消除了本地环境配置的复杂性，使开发者能够快速开始Angular项目的开发工作。

核心功能和特性

• 预安装最新稳定版Angular CLI
• 包含Node.js和npm环境，无需额外配置
• 支持所有Angular CLI命令（new, serve, build, test等）
• 内置Git工具，便于版本控制
• 支持自定义Node.js和Angular CLI版本
• 轻量级设计，基于Alpine Linux构建

使用场景和适用范围

• Angular应用的快速原型开发
• 多版本Angular项目并行开发
• CI/CD流程中的Angular应用构建和测试
• 团队开发环境标准化
• 教学和演示环境快速搭建

使用方法和配置说明

基本用法

创建新的Angular项目：

docker run --rm -v $(pwd):/app teracyhq/angular-cli ng new my-angular-app

启动开发服务器：

cd my-angular-app
docker run --rm -v $(pwd):/app -p 4200:4200 teracyhq/angular-cli ng serve --host 0.0.0.0

构建生产版本：

docker run --rm -v $(pwd):/app teracyhq/angular-cli ng build --prod

运行单元测试：

docker run --rm -v $(pwd):/app teracyhq/angular-cli ng test

指定Angular CLI版本

可以通过标签指定特定版本的Angular CLI：

docker run --rm teracyhq/angular-cli:13.0.0 ng --version

Docker Compose配置

创建docker-compose.yml文件：

version: '3'
services:
  angular:
    image: teracyhq/angular-cli
    volumes:
      - ./:/app
    ports:
      - "4200:4200"
    command: ng serve --host 0.0.0.0

启动服务：

docker-compose up

环境变量

持久化依赖

为了避免每次运行都重新安装依赖，可以将node_modules目录挂载为卷：

docker run --rm -v $(pwd):/app -v angular_node_modules:/app/node_modules teracyhq/angular-cli npm install

高级配置

自定义构建

如需添加额外系统依赖，可以基于此镜像创建自定义Dockerfile：

FROM teracyhq/angular-cli

USER root
RUN apk add --no-cache some-package
USER node

与IDE集成

可以将容器内的项目与本地IDE集成，只需确保本地项目目录已正确挂载，大多数现代IDE都能识别容器内安装的依赖。

版本标签

• latest: 最新稳定版本
• X: Angular CLI主版本号
• X.Y: Angular CLI次版本号
• X.Y.Z: Angular CLI具体版本号
• node-X.Y.Z-angular-X.Y.Z: 指定Node.js和Angular CLI版本

注意事项

• Windows用户应使用%cd%代替$(pwd)
• 确保本地端口4200未被占用，或使用其他端口映射
• 首次运行可能需要较长时间下载依赖
• 生产环境部署应使用构建产物而非直接运行开发服务器