ericmjl/llamabot-devcontainer

LlamaBot开发容器镜像文档

概述

LlamaBot开发容器镜像是专为LlamaBot应用开发设计的Docker镜像，旨在简化LlamaBot相关应用的开发流程。该镜像集成了LlamaBot开发所需的基础依赖、运行时环境、开发工具及默认配置，开发者可直接基于此镜像快速搭建一致的本地开发环境，无需手动配置底层依赖，专注于应用逻辑开发。

核心功能与特性

1. 预配置开发环境

• 内置LlamaBot运行及开发所需的完整依赖栈，包括Python环境、相关库（如llama-cpp-python、transformers等）及系统工具
• 预设开发目录结构，符合LlamaBot应用的标准项目组织规范
• 集成代码编辑器工具（如vim、nano）和版本控制工具（git），支持直接在容器内进行代码编写与管理

2. 依赖管理与版本控制

• 固化依赖版本，确保不同开发环境下的依赖一致性，避免"在我机器上能运行"问题
• 支持通过pip或requirements.txt动态更新项目依赖，满足个性化开发需求
• 内置依赖检查工具，可自动验证环境依赖完整性

3. 开发流程优化

• 支持热重载（需配合应用框架配置），修改代码后无需重启容器即可生效
• 集成调试工具，支持通过VS Code等IDE远程连接容器进行断点调试
• 简化日志输出，默认配置符合开发场景的日志格式与级别

4. 轻量与可扩展

• 基于官方Python slim镜像构建，减小镜像体积，提升启动速度
• 预留扩展接口，支持通过Dockerfile或docker-compose叠加自定义配置
• 兼容主流容器编排工具（Docker Compose、Kubernetes），支持开发环境与部署环境的无缝迁移

使用场景

• LlamaBot应用本地开发：快速搭建标准化开发环境，避免本地环境配置冲突
• 多版本并行开发：通过容器隔离不同LlamaBot项目或版本的开发环境
• 团队协作开发：统一团队开发环境，确保代码在不同开发者机器上的一致性运行
• 快速原型验证：基于预配置环境快速验证LlamaBot相关功能原型

使用方法

基础使用（Docker Run）

bash
# 拉取镜像（假设镜像名为llamabot/dev-container）
docker pull llamabot/dev-container:latest

# 启动容器并挂载本地项目目录
docker run -it --name llamabot-dev \
  -v $(pwd):/app \  # 将本地当前目录挂载到容器内/app（项目工作目录）
  -p 8000:8000 \    # 映射端口（如需运行Web服务）
  -e LOG_LEVEL=debug \  # 设置日志级别为debug
  llamabot/dev-container:latest

进入容器开发

容器启动后默认进入交互式bash终端，可直接进行开发操作：

bash
# 进入运行中的容器（如容器已启动）
docker exec -it llamabot-dev bash

# 在容器内执行开发命令（示例）
cd /app
pip install -r requirements.txt  # 安装项目依赖
python main.py  # 运行LlamaBot应用

使用Docker Compose（推荐）

创建docker-compose.yml文件简化配置管理：

yaml
version: '3.8'
services:
  llamabot-dev:
    image: llamabot/dev-container:latest
    container_name: llamabot-dev
    volumes:
      - ./:/app  # 挂载本地项目目录
      - ~/.cache/huggingface:/root/.cache/huggingface  # 共享模型缓存（可选）
    ports:
      - "8000:8000"  # Web服务端口
      - "5678:5678"  # 调试工具端口（如debugpy）
    environment:
      - WORKDIR=/app
      - PYTHONPATH=/app
      - LOG_LEVEL=info
    tty: true  # 保持终端交互
    stdin_open: true

启动服务：

bash
docker-compose up -d
docker-compose exec llamabot-dev bash  # 进入容器

配置说明

环境变量

容器支持通过环境变量自定义配置，常用变量如下：

数据持久化

为避免容器重启导致数据丢失，建议挂载以下目录：

• 项目代码目录：-v $(pwd):/app（本地代码实时同步到容器）
• 依赖缓存目录：-v ./venv:/app/venv（保留已安装依赖）
• 模型缓存目录：-v ~/.cache/huggingface:/root/.cache/huggingface（共享大模型缓存文件）

扩展配置

如需自定义镜像，可基于此镜像构建新Dockerfile：

dockerfile
FROM llamabot/dev-container:latest

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

# 添加自定义开发工具
RUN pip install --no-cache-dir black flake8  # 代码格式化与检查工具

# 设置自定义工作目录
ENV WORKDIR=/llamabot-project
RUN mkdir -p $WORKDIR
WORKDIR $WORKDIR

注意事项

• 容器默认以root用户运行，生产环境使用需配置非root用户（开发环境可忽略）
• 热重载功能需应用框架支持（如FastAPI的--reload参数），启用时需确保挂载目录权限正确
• 首次启动容器可能需要下载基础依赖或模型文件，建议在网络稳定环境下进行