ridyio/delivery-gateway-box

Waves Docker镜像文档

镜像概述

Waves镜像基于Nx（Extensible Dev Tools for Monorepos）构建，提供一站式Monorepos开发环境，专为多框架全栈应用开发设计。集成Nx的项目依赖图谱管理、自动化代码生成、构建测试工具链及Nx Cloud云端加速能力，旨在简化大型项目及多团队协作的开发流程，提升全栈应用开发效率。

核心功能与特性

多框架支持

• 主流框架兼容：原生支持Angular、React、Nest、Express、Node.js及无框架Web开发，可通过社区插件扩展更多技术栈。
• 统一开发体验：为前端（Angular/React）与后端（Nest/Express）开发者提供一致的命令行工具与配置体系。

增强开发工具链

• 自动化代码生成：支持快速生成应用、库、组件等代码模块，减少重复工作。
• 项目依赖可视化：通过nx dep-graph命令生成依赖图谱，清晰展示项目间关系。
• 增量构建测试：nx affected:test与nx affected:e2e命令仅处理变更代码，提升开发效率。

Nx Cloud加速

• 云端计算缓存：将构建、测试结果缓存至云端，团队共享缓存，最高可提升10倍构建速度。
• 跨团队协作优化：新团队接入即可享受缓存红利，无需额外配置。

使用场景与适用范围

• 全栈应用开发：需同时开发前端与后端项目，追求技术栈灵活性的团队。
• 大型Monorepos项目：通过单一代码库管理多个关联应用/库，需统一依赖与版本控制的场景。
• 多团队并行开发：需要协调多团队工作流、统一开发规范的企业级项目。

使用方法与配置说明

Docker部署示例

1. 基础开发环境启动

bash
docker run -it --name waves-dev -v $(pwd):/workspace waves:latest /bin/bash

说明：挂载本地工作目录至容器/workspace，进入交互模式后即可使用Nx命令行工具。

2. 开发服务器运行

bash
docker run -it -p 4200:4200 -v $(pwd):/workspace waves:latest ng serve my-app

说明：映射容器4200端口至本地，启动指定应用（my-app）的开发服务器，访问http://localhost:4200即可实时预览应用（代码变更自动热重载）。

核心操作命令

添加框架插件

根据项目需求安装对应框架支持：

bash
# Angular
ng add @nrwl/angular

# React
ng add @nrwl/react

# Nest（后端）
ng add @nrwl/nest

# Express（后端）
ng add @nrwl/express

# Node.js（后端）
ng add @nrwl/node

应用与库生成

bash
# 生成Angular应用（替换插件名可生成其他框架应用）
ng g @nrwl/angular:app my-app

# 生成共享库（可被多个应用引用）
ng g @nrwl/angular:lib my-lib  # 库路径默认为@waves/mylib，支持跨项目导入

构建与打包

bash
# 开发环境构建（输出至dist/目录）
ng build my-app

# 生产环境构建（优化代码体积与性能）
ng build my-app --prod

测试执行

bash
# 单元测试（基于Jest）
ng test my-app

# 端到端测试（基于Cypress）
ng e2e my-app

# 仅测试变更项目（增量测试）
nx affected:test  # 单元测试
nx affected:e2e   # 端到端测试

依赖图谱查看

bash
nx dep-graph

生成交互式依赖关系图，可在浏览器中查看项目间依赖链路。

Nx Cloud配置

启用云端缓存加速：

bash
nx connect-to-nx-cloud

按提示完成账号注册与团队配置后，即可享受云端缓存与协作功能。

进一步帮助

访问https://nx.dev/angular%E8%8E%B7%E5%8F%96%E5%AE%8C%E6%95%B4%E5%91%BD%E4%BB%A4%E5%8F%82%E8%80%83%E4%B8%8E%E8%BF%9B%E9%98%B6%E9%85%8D%E7%BD%AE%E6%8C%87%E5%8D%97%E3%80%82