gitpod/workspace-dotnet

.NET 增强型工作空间镜像文档

镜像概述和主要用途

本镜像基于 workspace-full 构建，在其基础上新增了完整的 .NET 开发环境支持。主要用途是为开发者提供集成 .NET 工具链的一站式开发工作空间，适用于 .NET 应用的开发、调试、构建及测试流程，同时保留 workspace-full 原有的多工具集成特性。

核心功能和特性

继承自 workspace-full 的基础功能

• 集成常用开发工具（Git、SSH、curl、wget 等系统工具）
• 内置 Web IDE 支持（如 VS Code Server，默认暴露 8080 端口）
• 多语言运行时基础环境（Python、Node.js 等，具体取决于 workspace-full 版本）
• 容器化环境隔离与标准化配置

新增 .NET 开发支持

• .NET SDK 集成：包含最新稳定版 .NET SDK（默认 8.0，支持 7.0/6.0 兼容模式）
• 运行时环境：内置 .NET Runtime、ASP.NET Core Runtime、.NET Desktop Runtime
• 工具链：dotnet CLI、NuGet 包管理器、EF Core 工具、Roslyn 编译器
• 调试支持：集成 .NET 调试器（vsdbg），支持与 IDE 联动调试

使用场景和适用范围

1. .NET 应用开发：为开发者提供本地一致的 .NET 开发环境，支持控制台应用、Web 应用（ASP.NET Core）、桌面应用等开发
2. CI/CD 流程：作为构建节点集成到流水线，用于 .NET 项目的自动化编译、测试和打包
3. 团队协作：标准化团队开发环境，避免因本地配置差异导致的"在我电脑上能运行"问题
4. 教学/演示：快速部署包含 .NET 环境的临时工作空间，用于技术培训或项目演示

详细使用方法和配置说明

镜像拉取

bash
# 拉取最新版本
docker pull [镜像仓库地址]/workspace-full-dotnet:latest

# 拉取指定 .NET SDK 版本（如 7.0）
docker pull [镜像仓库地址]/workspace-full-dotnet:7.0

基本运行示例（docker run）

bash
docker run -d \
  --name dotnet-workspace \
  -p 8080:8080  # Web IDE 端口（继承自 workspace-full）\
  -p 5000:5000  # ASP.NET Core 应用默认端口\
  -v $(pwd)/workspace:/workspace  # 挂载本地工作目录到容器\
  -e DOTNET_CLI_TELEMETRY_OPTOUT=1  # 禁用 .NET CLI 遥测\
  -e WORKSPACE_PASSWORD=dev123  # Web IDE 访问密码（继承自 workspace-full）\
  [镜像仓库地址]/workspace-full-dotnet:latest

Docker Compose 配置示例

创建 docker-compose.yml：

yaml
version: '3.8'
services:
  dotnet-workspace:
    image: [镜像仓库地址]/workspace-full-dotnet:latest
    container_name: dotnet-workspace
    ports:
      - "8080:8080"  # Web IDE 访问端口
      - "5000:5000"  # .NET 应用调试端口
      - "5001:5001"  # HTTPS 应用端口
    volumes:
      - ./workspace:/workspace  # 持久化工作目录
      - ./nuget-cache:/root/.nuget/packages  # 持久化 NuGet 缓存
    environment:
      - DOTNET_VERSION=8.0  # 指定 .NET SDK 版本（需镜像支持）
      - DOTNET_CLI_TELEMETRY_OPTOUT=1  # 禁用遥测
      - WORKSPACE_USER=devuser  # 自定义登录用户名（继承自 workspace-full）
      - WORKSPACE_PASSWORD=SecurePass123!  # 登录密码
    restart: unless-stopped

启动容器：

bash
docker-compose up -d

配置参数与环境变量

注意事项

1. 镜像大小：因包含完整开发工具链，镜像体积较大（建议预留 10GB+ 存储空间）。
2. 数据持久化：务必通过 -v 挂载工作目录，避免容器销毁导致代码丢失。
3. 版本选择：生产环境建议使用具体版本标签（如 8.0）而非 latest，确保环境一致性。
4. 资源需求：运行 .NET 编译或调试任务时，建议分配至少 2GB 内存和 2 CPU 核心。