Loome Development Agent 镜像文档

概述

Loome Development Agent 是一个专为开发环境设计的Docker镜像，旨在提供高效的开发代理服务。该镜像集成代码同步、环境配置管理和开发流程自动化功能，帮助开发团队统一开发环境配置，减少环境差异导致的问题，提升本地开发与团队协作效率。

核心功能与特性

• 代码同步机制：支持与Git等版本控制系统的实时同步，自动拉取远程代码更新并推送本地修改，确保开发环境代码一致性。
• 环境配置管理：提供集中式环境变量和配置文件管理，支持多环境（开发、测试、预发布）配置模板，一键切换开发上下文。
• 开发流程自动化：集成常见开发工具链（如构建工具、测试框架），支持自定义自动化脚本，简化代码构建、测试和部署流程。
• 跨平台兼容性：兼容Linux、macOS和Windows系统的Docker环境，支持x86_64和ARM架构，满足不同开发设备需求。
• 资源优化设计：采用轻量级基础镜像，优化运行时资源占用，确保在低配开发设备上仍能高效运行。

使用场景与适用范围

• 本地开发环境标准化：个人开发者快速搭建一致的开发环境，避免"在我电脑上能运行"的问题。
• 团队协作开发：统一团队开发工具链和配置参数，确保所有成员使用相同的开发环境配置。
• CI/CD流程前置验证：在本地模拟CI/CD流程，提前发现构建和测试问题，减少集成阶段故障。
• 多项目并行开发：通过容器隔离实现多项目开发环境共存，避免项目间依赖冲突。

使用方法与配置说明

基础使用（Docker Run）

通过以下命令快速启动Loome Development Agent容器：

docker run -d \
  --name loome-dev-agent \
  -p 8080:8080 \
  -v $(pwd)/agent-config:/app/config \
  -v $(pwd)/project-code:/app/workspace \
  -e AGENT_MODE=development \
  -e SYNC_INTERVAL=30s \
  -e REMOTE_REPO=[***] \
  loome/development-agent:latest

参数说明：

• -p 8080:8080：映射容器代理服务端口到主机
• -v $(pwd)/agent-config:/app/config：挂载本地配置目录，持久化代理配置
• -v $(pwd)/project-code:/app/workspace：挂载项目代码目录，实现代码同步
• AGENT_MODE：指定运行模式，控制代理行为强度
• SYNC_INTERVAL：代码同步间隔时间
• REMOTE_REPO：关联的远程代码仓库地址

环境变量配置

Docker Compose 配置示例

创建docker-compose.yml文件进行多容器协作或复杂配置：

version: '3.8'

services:
  dev-agent:
    image: loome/development-agent:latest
    container_name: loome-dev-agent
    ports:
      - "8080:8080"  # 代理服务端口
      - "9090:9090"  # 监控面板端口
    volumes:
      - ./agent-config:/app/config:rw
      - ./project-code:/app/workspace:rw
      - ~/.ssh:/root/.ssh:ro  # 挂载SSH密钥用于私有仓库访问
    environment:
      - AGENT_MODE=development
      - SYNC_INTERVAL=15s
      - LOG_LEVEL=debug
      - REMOTE_REPO=***:example/secret-project.git
      - AUTH_TYPE=ssh
      - AUTH_CREDENTIAL=/root/.ssh/id_rsa
    restart: unless-stopped
    networks:
      - dev-network

networks:
  dev-network:
    driver: bridge

配置文件说明

容器内/app/config目录支持自定义配置文件（agent.yaml），覆盖环境变量配置：

sync:
  interval: 20s
  auto_push: true
  ignore_patterns:
    - "node_modules/"
    - ".git/"
logging:
  level: info
  output: both  # console/file/both
  file_path: /app/logs/agent.log
workspace:
  cleanup_unused: false
  max_size: 10GB

注意事项

• 首次启动需确保挂载的本地目录（如agent-config、project-code）具有读写权限，可通过chmod 755调整
• 访问私有代码仓库时，建议通过SSH密钥认证（挂载~/.ssh目录）或环境变量注入令牌，避免明文存储凭据
• 生产环境使用时建议设置AGENT_MODE=production，禁用自动推送等风险操作，仅保留代码同步功能
• 如需自定义代理端口，可修改端口映射参数（如-p 8081:8080将主机8081端口映射到容器8080端口）