takelwerk/takelbuild

takelage-dev Docker镜像文档

镜像概述与主要用途

takelage-dev是一个专为开发者设计的Docker镜像，旨在提供一致、可移植的跨平台开发环境。它集成了多种常用开发工具与依赖，解决因操作系统、本地配置差异导致的"在我电脑上能运行"问题，确保团队成员及不同开发环境中使用统一的工具链与配置。主要用途包括简化项目初始化流程、标准化开发环境、降低跨平台协作门槛，适用于个人开发与团队协作场景。

核心功能与特性

多语言与工具支持

• 支持多种编程语言开发环境，包括但不限于Python、JavaScript/TypeScript、Go、Ruby、Java等
• 集成常用开发工具：Git（含LFS支持）、SSH客户端、curl、wget、jq、rsync、编辑器配置（Vim/Neovim/VS Code远程开发支持）

环境一致性

• 跨平台兼容：在Windows、macOS、Linux系统上提供一致的开发体验
• 预配置工具链版本，避免版本差异导致的依赖冲突
• 统一的Shell环境（Bash/Zsh），包含常用别名与开发脚本

灵活性与可定制性

• 支持通过环境变量调整配置（用户ID、时区、工具开关等）
• 可通过挂载本地配置文件覆盖默认设置
• 提供基础镜像，支持基于此扩展自定义开发环境

开发效率优化

• 内置项目初始化脚本，快速搭建项目结构
• 支持SSH密钥挂载，无缝连接远程仓库与服务器
• 轻量级设计，平衡功能与性能，启动速度快

使用场景与适用范围

团队协作开发

• 确保团队成员使用完全一致的开发工具与依赖版本，消除"环境差异"问题
• 新人快速上手：无需手动配置复杂环境，拉取镜像即可开始开发

多项目管理

• 在单一系统中隔离不同项目的开发环境，避免依赖冲突
• 快速切换项目：不同项目共享基础环境，仅需调整项目特定配置

跨平台开发测试

• 在Windows/macOS上模拟Linux开发环境，验证跨平台兼容性
• 无需双系统或虚拟机，通过Docker直接运行目标环境

CI/CD流程集成

• 作为开发阶段的基础环境，与CI/CD管道衔接，确保开发与构建环境一致
• 支持在容器内运行单元测试、代码检查等开发阶段任务

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+）与Docker Compose（2.0+）
• 网络连接正常（用于拉取镜像及依赖）

基本使用示例（docker run）

交互式运行开发环境

bash
# 拉取最新镜像
docker pull takelwerk/takelage-dev:latest

# 交互式启动，挂载当前项目目录到容器内/app
docker run -it --rm \
  -v $(pwd):/app \
  -v ~/.ssh:/root/.ssh:ro \  # 只读挂载本地SSH密钥（可选）
  -v takelage-dev-data:/home/dev \  # 持久化开发用户数据（可选）
  --name takelage-dev-env \
  takelwerk/takelage-dev:latest

在容器内执行单条命令

bash
# 在容器内运行项目测试命令
docker run --rm \
  -v $(pwd):/app \
  takelwerk/takelage-dev:latest \
  sh -c "cd /app && npm install && npm test"

Docker Compose 配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  dev:
    image: takelwerk/takelage-dev:latest
    volumes:
      - .:/app:rw  # 挂载当前项目目录
      - ssh-keys:/root/.ssh:ro  # SSH密钥挂载（可选）
      - dev-data:/home/dev  # 持久化开发数据
    environment:
      - USER_ID=1000  # 匹配宿主用户ID，避免文件权限问题
      - TZ=Asia/Shanghai  # 设置时区
      - ENABLE_NEOVIM=true  # 启用Neovim编辑器支持
    tty: true  # 保持终端连接
    stdin_open: true  # 允许交互式输入

volumes:
  ssh-keys:
    driver_opts:
      type: bind
      o: bind
      device: ~/.ssh
  dev-data:  # 自动创建命名卷，持久化开发环境数据

启动服务：

bash
docker-compose up -d
docker-compose exec dev bash  # 进入交互式终端

环境变量与配置参数

持久化开发数据

为避免容器重建后丢失开发配置（如VS Code插件、Shell历史），建议挂载数据卷：

bash
# 创建命名卷
docker volume create takelage-dev-data

# 使用命名卷启动
docker run -it --rm \
  -v takelage-dev-data:/home/dev \
  takelwerk/takelage-dev:latest

自定义配置与扩展

通过Dockerfile扩展镜像

如需添加项目特定工具，可创建自定义Dockerfile：

dockerfile
FROM takelwerk/takelage-dev:latest

# 安装额外系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
  postgresql-client \
  redis-tools \
  && rm -rf /var/lib/apt/lists/*

# 安装Python依赖
RUN pip install --no-cache-dir poetry

# 添加自定义Shell配置
COPY .bashrc /home/dev/.bashrc

构建并使用自定义镜像：

bash
docker build -t my-takelage-dev .
docker run -it --rm my-takelage-dev

挂载本地配置文件

覆盖默认配置（如Git、编辑器设置）：

bash
# 挂载本地Git配置
docker run -it --rm \
  -v ~/.gitconfig:/home/dev/.gitconfig \
  takelwerk/takelage-dev:latest