libatomic/atomic 镜像文档

1. 镜像概述

libatomic/atomic 是一个需要 MySQL 数据库支持的服务镜像，默认通过 9000 端口提供 Web 服务。该镜像支持通过环境变量配置核心参数（如数据库连接、日志级别等），并可通过卷挂载实现资产（assets）和 feeds 数据的持久化存储，确保服务重启后数据不丢失。

2. 核心功能与特性

• 数据库依赖：必须连接 MySQL 数据库，通过 DB_SOURCE 环境变量配置连接字符串，支持数据持久化存储。
• Web 服务暴露：默认监听 9000 端口提供 HTTP 服务，可通过 SERVER_ADDR 自定义监听地址。
• 日志与调试：支持通过 LOG_LEVEL 设置日志级别（如 debug、info 等），并可通过 HTTP_TRACE_ENABLE 启用 HTTP 请求跟踪，便于问题排查。
• 数据持久化：提供 /app/assets 和 /app/feeds 目录用于资产和 feeds 数据存储，支持通过卷挂载至宿主机目录实现持久化。

3. 使用场景

适用于需要 MySQL 数据库支持、提供 Web 访问接口且需持久化存储特定数据的应用场景，例如：

• 内容管理系统后端服务
• 数据处理与展示平台
• 需要数据库交互的轻量级 Web 应用

4. 使用方法

4.1 直接运行（docker run）

通过 docker run 命令快速启动服务，需提前确保 MySQL 数据库已部署并配置正确连接信息：

bash
docker run -it -p 9000:9000 \
  -e DB_SOURCE="root:password@tcp(192.168.1.174:3306)/atomic?parseTime=true" \
  -e LOG_LEVEL="debug" \
  -e HTTP_TRACE_ENABLE=true \
  libatomic/atomic

4.2 使用 docker-compose 部署（推荐）

通过 docker-compose 可一键部署服务及依赖的 MySQL 数据库，自动处理服务依赖关系和数据持久化：

yml
version: "2.4"
services:
  mysql:
    image: "mysql:8.0.34"
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: "password"  # MySQL  root 密码
      MYSQL_DATABASE: "atomic"         # 自动创建 atomic 数据库
    volumes:
      - "mysql:/var/lib/mysql"         # MySQL 数据持久化

  atomic:
    image: "libatomic/atomic:latest"
    ports:
      - "9000:9000"                    # 映射 Web 服务端口
    depends_on:
      - "mysql"                        # 依赖 MySQL 服务启动
    environment:
      LOG_LEVEL: "debug"               # 日志级别设为 debug
      SERVER_ADDR: "0.0.0.0:9000"      # 监听所有网络接口的 9000 端口
      DB_SOURCE: "root:password@tcp(mysql:3306)/atomic?parseTime=true"  # 连接 MySQL 容器
    volumes:
      - "~/.atomic/assets:/app/assets"  # 资产数据持久化到宿主机 ~/.atomic/assets
      - "~/.atomic/feeds:/app/feeds"    # feeds 数据持久化到宿主机 ~/.atomic/feeds

volumes:
  mysql:
    driver: "local"  # MySQL 数据卷使用本地驱动

5. 配置参数说明

5.1 环境变量

5.2 卷挂载