kuzcoxyz/worker

Kuzco Worker Docker镜像文档

1. 镜像概述和主要用途

Kuzco Worker Docker镜像是Kuzco工作节点的容器化版本，旨在提供一个轻量级、可移植的任务处理环境。该镜像封装了Kuzco Worker运行所需的所有依赖组件，能够无缝集成到Kuzco分布式系统中，执行分配的计算任务和数据处理工作。

2. 核心功能和特性

• 独立部署：作为独立容器运行，简化部署流程
• 资源隔离：通过容器化实现CPU、内存等系统资源的有效隔离
• 弹性扩展：支持根据任务负载动态调整worker实例数量
• 自动恢复：容器健康检查和自动重启机制确保服务可用性
• 配置灵活：通过环境变量和配置文件实现多样化配置
• 日志集成：标准输出日志支持与主流日志收集系统集成

3. 使用场景和适用范围

适用场景

• 分布式计算任务处理
• 后台数据处理和转换
• 定时任务执行
• 消息队列消费者
• 微服务架构中的任务执行节点

适用范围

• 开发环境中的本地测试
• 持续集成/持续部署(CI/CD)流程
• 生产环境中的任务处理集群
• 云平台和容器编排系统(Kubernetes、Docker Swarm等)

4. 使用方法和配置说明

4.1 基本使用方法

Docker Run命令示例

bash
docker run -d \
  --name kuzco-worker \
  -e KUZCO_MASTER_URL=http://master:8080 \
  -e WORKER_ID=worker-01 \
  -e LOG_LEVEL=info \
  --restart unless-stopped \
  kuzco-worker:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  kuzco-worker:
    image: kuzco-worker:latest
    container_name: kuzco-worker
    restart: unless-stopped
    environment:
      - KUZCO_MASTER_URL=http://master:8080
      - WORKER_ID=worker-01
      - LOG_LEVEL=info
      - CPU_LIMIT=2
      - MEMORY_LIMIT=2G
      - TASK_TIMEOUT=300
    volumes:
      - worker-data:/var/lib/kuzco-worker
    networks:
      - kuzco-network

volumes:
  worker-data:

networks:
  kuzco-network:
    driver: bridge

4.2 环境变量配置

4.3 数据持久化

如需持久化worker数据，可挂载以下目录：

bash
-v /host/path/worker-data:/var/lib/kuzco-worker

该目录包含：

• 任务执行日志
• 临时缓存数据
• 本地配置文件

4.4 网络配置

Kuzco Worker需要与Kuzco主节点和其他组件通信，建议通过自定义网络实现容器间通信：

bash
# 创建自定义网络
docker network create kuzco-network

# 连接到网络
docker run -d --name kuzco-worker --network kuzco-network kuzco-worker:latest

5. 健康检查

容器内置健康检查机制，可通过以下方式配置：

bash
docker run -d \
  --name kuzco-worker \
  --health-cmd "curl -f http://localhost:8081/health || exit 1" \
  --health-interval 30s \
  --health-timeout 10s \
  --health-retries 3 \
  kuzco-worker:latest

健康检查端点：http://localhost:8081/health

6. 扩展配置

6.1 多实例部署

在生产环境中，可部署多个worker实例提高处理能力：

yaml
# docker-compose.yml
version: '3.8'
services:
  kuzco-worker:
    image: kuzco-worker:latest
    deploy:
      replicas: 5  # 部署5个worker实例
    environment:
      - KUZCO_MASTER_URL=http://master:8080
    networks:
      - kuzco-network

networks:
  kuzco-network:

6.2 资源限制配置

为确保系统稳定性，建议配置资源限制：

yaml
services:
  kuzco-worker:
    image: kuzco-worker:latest
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 2G
        reservations:
          cpus: '0.5'
          memory: 512M