Kinetic Task Docker镜像文档

1. 镜像概述

Kinetic Task Docker镜像是一个预配置的容器化解决方案，用于部署和运行Kinetic Task工作流自动化平台。该镜像封装了Kinetic Task运行所需的全部依赖组件，提供了一种简单、一致且可移植的部署方式，消除了复杂的手动配置过程。

2. 核心功能和特性

• 完整封装：包含Kinetic Task应用程序及其所有依赖组件
• 即开即用：预配置环境，简化部署流程
• 隔离性：容器化运行，确保环境一致性和系统隔离
• 可扩展性：支持横向扩展以满足不同负载需求
• 版本控制：通过镜像标签轻松管理不同版本的Kinetic Task
• 简化维护：简化升级和回滚流程

3. 使用场景和适用范围

• 企业工作流自动化：部署Kinetic Task平台实现业务流程自动化
• 开发环境：为开发团队提供一致的Kinetic Task开发和测试环境
• 演示环境：快速搭建Kinetic Task演示环境
• 生产环境：在生产环境中稳定运行Kinetic Task平台
• 集成测试：与其他系统集成时提供隔离的测试环境

4. 使用方法和配置说明

4.1 基本使用方法

4.1.1 拉取镜像

docker pull kineticdata/kinetic-task:latest

4.1.2 基本运行命令

docker run -d -p 8080:8080 --name kinetic-task kineticdata/kinetic-task:latest

4.1.3 使用Docker Compose部署

创建docker-compose.yml文件：

version: '3'
services:
  kinetic-task:
    image: kineticdata/kinetic-task:latest
    container_name: kinetic-task
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=db
      - DB_PORT=5432
      - DB_NAME=kinetictask
      - DB_USER=ktuser
      - DB_PASSWORD=ktpassword
      - TOMCAT_PORT=8080
      - KINETIC_TASK_HOME=/opt/kinetic-task
    volumes:
      - kinetic-task-data:/opt/kinetic-task/data
      - kinetic-task-logs:/opt/kinetic-task/logs
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: postgres:13
    container_name: kinetic-task-db
    environment:
      - POSTGRES_DB=kinetictask
      - POSTGRES_USER=ktuser
      - POSTGRES_PASSWORD=ktpassword
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  kinetic-task-data:
  kinetic-task-logs:
  postgres-data:

启动服务：

docker-compose up -d

4.2 配置说明

4.2.1 环境变量

Kinetic Task容器支持以下环境变量配置：

4.2.2 持久化数据

为确保数据持久化，建议挂载以下目录：

4.2.3 端口映射

默认情况下，Kinetic Task使用8080端口。可以通过-p参数映射到主机的其他端口：

docker run -d -p 80:8080 --name kinetic-task kineticdata/kinetic-task:latest

5. 高级配置

5.1 自定义配置文件

通过挂载自定义配置文件覆盖默认配置：

docker run -d \
  -p 8080:8080 \
  -v /path/to/custom/conf:/opt/kinetic-task/conf \
  --name kinetic-task \
  kineticdata/kinetic-task:latest

5.2 连接外部数据库

配置连接外部数据库：

docker run -d \
  -p 8080:8080 \
  -e DB_HOST=external-db.example.com \
  -e DB_PORT=5432 \
  -e DB_NAME=kinetictask \
  -e DB_USER=dbuser \
  -e DB_PASSWORD=dbpassword \
  --name kinetic-task \
  kineticdata/kinetic-task:latest

5.3 健康检查

添加健康检查确保服务正常运行：

docker run -d \
  -p 8080:8080 \
  --health-cmd "curl -f http://localhost:8080/kinetic-task/ || exit 1" \
  --health-interval 30s \
  --health-timeout 10s \
  --health-retries 3 \
  --name kinetic-task \
  kineticdata/kinetic-task:latest

6. 故障排除

6.1 查看日志

docker logs kinetic-task

或通过挂载的日志目录查看详细日志文件。

6.2 进入容器

docker exec -it kinetic-task /bin/bash

6.3 检查容器状态

docker inspect --format '{{json .State.Health}}' kinetic-task | jq .

7. 版本管理

通过镜像标签指定Kinetic Task版本：

docker pull kineticdata/kinetic-task:5.2.1
docker run -d -p 8080:8080 --name kinetic-task kineticdata/kinetic-task:5.2.1

8. 停止和删除容器

# 停止容器
docker stop kinetic-task

# 删除容器
docker rm kinetic-task

# 停止并删除使用docker-compose部署的服务
docker-compose down