Coder OSS Dogfood 镜像文档

镜像概述

Coder OSS Dogfood镜像是针对Coder开源版本（Open Source Software）的内部测试镜像，主要供Coder开发团队日常使用和功能验证。该镜像包含最新开发阶段的功能、代码修复及性能改进，旨在帮助团队在正式发布前验证新功能的稳定性、兼容性及用户体验，确保最终版本质量。

核心功能与特性

1. 最新功能预览

• 集成开发中的未发布功能，支持团队提前体验和测试新特性。
• 包含针对已知问题的最新修复，优先解决开发过程中发现的bug。

2. 持续集成更新

• 基于Coder开源代码仓库的主分支（main branch）自动构建，频繁更新以反映最新代码变更。
• 每次代码合并后触发镜像更新，确保镜像与开发进度同步。

3. 开发环境一致性

• 统一团队开发环境配置，避免因本地环境差异导致的功能表现不一致问题。
• 内置标准化依赖和工具链，减少环境配置成本。

4. 兼容性测试支持

• 支持与主流开发工具（如VS Code、JetBrains IDEs）、版本控制系统（Git）及云服务（AWS、GCP等）的兼容性验证。
• 可模拟不同用户场景（如多用户并发、复杂权限配置）下的系统表现。

使用场景与适用范围

适用场景

• 日常开发：开发团队用于日常编码、调试及功能验证。
• 功能测试：针对新功能进行功能性测试、边界测试及压力测试。
• 兼容性验证：验证新功能与数据库（PostgreSQL等）、存储服务（S3等）的兼容性。
• 预发布验证：新版本发布前的集成测试和回归测试。

适用范围

• 使用对象：仅限Coder开发团队内部使用，非生产环境用途。
• 环境限制：需搭配Coder开源版本的依赖组件（如PostgreSQL数据库、外部存储服务）使用。

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本）及Docker Compose（可选）。
• 已配置Coder所需的外部依赖（如PostgreSQL数据库、域名解析及SSL证书，如需HTTPS）。

镜像拉取

通过Docker命令拉取最新版本镜像：

bash
docker pull codercom/oss-dogfood:latest

基本运行命令

使用以下命令启动容器（需替换示例中的占位符参数）：

bash
docker run -d \
  --name coder-oss-dogfood \
  -p 3000:3000 \  # 映射Web服务端口
  -v /path/to/data:/var/lib/coder \  # 持久化数据卷（存储配置、用户数据等）
  -e CODER_PG_CONNECTION_URL="postgresql://user:password@postgres:5432/coder" \  # PostgreSQL数据库连接URL
  -e CODER_ACCESS_URL="http://localhost:3000" \  # Coder访问地址（需匹配实际域名/IP）
  -e CODER_TELEMETRY=false \  # 禁用遥测（可选）
  codercom/oss-dogfood:latest

关键配置参数

数据持久化

为避免容器重启后数据丢失，需挂载持久化卷至容器内/var/lib/coder目录，该目录存储Coder的配置文件、用户数据及工作区元信息。

停止与更新

• 停止容器：docker stop coder-oss-dogfood
• 更新镜像并重启：

  bash
  docker pull codercom/oss-dogfood:latest && \
  docker rm -f coder-oss-dogfood && \
  # 重新执行上述docker run命令启动新容器
  

注意事项

• 该镜像为内部测试用途，不建议用于生产环境，可能存在未修复的稳定性问题。
• 因频繁更新，使用前建议备份持久化数据（如/var/lib/coder目录），避免数据丢失。
• 如遇功能异常，可通过Coder开源仓库的Issue跟踪系统反馈：[***]