arakurumi/bot

My Project Bot Docker镜像文档

镜像概述

My Project Bot Docker镜像为项目机器人提供标准化、可移植的运行环境，旨在简化部署流程并确保跨环境一致性。通过预配置依赖和运行参数，用户可快速启动机器人服务，无需手动配置底层环境。

核心功能与特性

• 预配置环境：内置机器人运行所需的全部依赖组件，无需手动安装
• 轻量级设计：基于Alpine或Debian slim基础镜像，优化镜像体积和资源占用
• 灵活配置：支持通过环境变量自定义机器人参数（如令牌、日志级别等）
• 跨平台兼容：支持Linux、Windows、macOS等主流操作系统的Docker环境
• 健康检查：内置健康检查机制，自动监控服务运行状态

使用场景

• 开发环境：快速搭建本地开发环境，统一团队开发配置
• 测试环境：在CI/CD流程中提供一致的测试实例，确保测试结果可靠性
• 生产环境：简化部署流程，支持容器编排工具（如Kubernetes、Docker Swarm）集成

使用方法

基本运行

通过docker run命令直接启动容器：

bash
docker run -d \
  --name my-project-bot \
  -p 8080:8080 \
  -e BOT_TOKEN="your_bot_api_token" \
  my-project-bot:latest

Docker Compose配置

创建docker-compose.yml文件进行多容器协调部署：

yaml
version: '3.8'
services:
  bot-service:
    image: my-project-bot:latest
    container_name: my-project-bot
    ports:
      - "8080:8080"
    environment:
      - BOT_TOKEN="your_bot_api_token"       # 机器人API令牌（必填）
      - LOG_LEVEL="info"                      # 日志级别（debug/info/warn/error）
      - MAX_CONCURRENT_TASKS=5                # 最大并发任务数
      - DB_CONNECTION_STRING="sqlite:///data/bot.db"  # 数据库连接字符串
    volumes:
      - ./bot-data:/app/data                  # 持久化数据卷
    restart: unless-stopped                   # 服务异常时自动重启

启动服务：

bash
docker-compose up -d

环境变量配置

数据持久化

为避免容器重启导致数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name my-project-bot \
  -p 8080:8080 \
  -e BOT_TOKEN="your_bot_api_token" \
  -v /host/path/to/data:/app/data \
  my-project-bot:latest

其中/host/path/to/data为宿主机数据目录，/app/data为容器内数据目录。

版本更新

定期更新镜像以获取最新功能和安全修复：

bash
# 拉取最新镜像
docker pull my-project-bot:latest

# 重启容器
docker restart my-project-bot

故障排查

• 日志查看：docker logs my-project-bot
• 健康状态检查：docker inspect --format='{{.State.Health.Status}}' my-project-bot
• 环境变量验证：docker exec my-project-bot env | grep BOT_