radiantone/eoc-orchestrator

NestJS TypeScript 启动镜像

镜像概述

NestJS是一个基于Node.js的渐进式框架，专为构建高效、可靠的服务器端应用而设计。本镜像提供NestJS框架的TypeScript启动环境，集成了开发、测试和生产部署所需的核心工具链，帮助开发者快速搭建模块化、可扩展的后端服务架构。

核心功能与特性

• TypeScript原生支持：内置TypeScript编译环境，提供类型安全和更好的开发体验
• 模块化架构：基于模块、控制器、服务的分层设计，支持复杂应用的解耦开发
• 依赖注入：内置依赖注入系统，简化组件间依赖管理和测试
• 多服务器适配：兼容Express（默认）和Fastify等HTTP服务器，可按需切换
• 开发工具链：集成热重载（watch mode）、单元测试、E2E测试和代码覆盖率工具
• 企业级特性：支持中间件、拦截器、管道、守卫等，满足复杂业务需求

使用场景

• 构建RESTful API和GraphQL服务
• 开发微服务架构后端应用
• 企业级后端系统开发
• 需要TypeScript强类型支持的Node.js项目
• 快速原型验证和生产环境部署

使用方法

前提条件

• 安装Docker Engine（20.10+）
• 熟悉NestJS基本概念和TypeScript语法

获取镜像

bash
# 拉取最新版本镜像
docker pull nestjs/typescript-starter:latest

运行开发环境

开发模式下支持代码热重载，适合实时开发：

bash
# 映射当前目录到容器内/app，暴露3000端口
docker run -it --rm \
  -p 3000:3000 \
  -v $(pwd):/app \
  -w /app \
  nestjs/typescript-starter \
  npm run start:dev

运行生产环境

生产模式需先构建应用，再启动优化后的服务：

bash
# 构建应用（假设项目代码在当前目录）
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  nestjs/typescript-starter \
  npm run build

# 启动生产服务
docker run -d --name nest-app \
  -p 3000:3000 \
  -v $(pwd)/dist:/app/dist \
  nestjs/typescript-starter \
  npm run start:prod

运行测试

支持单元测试、E2E测试和代码覆盖率分析：

bash
# 单元测试
docker run --rm -v $(pwd):/app -w /app nestjs/typescript-starter npm run test

# E2E测试
docker run --rm -v $(pwd):/app -w /app nestjs/typescript-starter npm run test:e2e

# 测试覆盖率
docker run --rm -v $(pwd):/app -w /app nestjs/typescript-starter npm run test:cov

Docker Compose配置示例

创建docker-compose.yml简化开发流程：

yaml
version: '3.8'

services:
  nest-app:
    image: nestjs/typescript-starter:latest
    ports:
      - "3000:3000"
    volumes:
      - ./:/app
    working_dir: /app
    command: npm run start:dev
    environment:
      - NODE_ENV=development
      - PORT=3000

启动服务：

bash
docker-compose up

环境变量配置

支持与许可

• 支持：NestJS是MIT许可的开源项目，可通过官方文档、***社区获取支持
• 许可：MIT许可，允许商业和非商业用途

相关资源

• 官方网站：[***]
• GitHub仓库：https://github.com/nestjs/nest
• 文档：[***]