icodegarden/beecomb-worker

beecomb-worker 镜像文档

镜像概述

beecomb-worker是一个工作节点镜像，主要用于运行任务处理服务。该镜像基于Java环境构建，支持灵活配置Java虚拟机参数和应用程序启动参数，适用于需要分布式任务处理的场景，可部署在Docker容器或Kubernetes集群中。

核心功能与特性

• 灵活的Java配置：通过环境变量自定义Java VM启动参数（如内存分配、GC策略等）
• 应用参数配置：支持通过环境变量设置应用程序级启动参数（如服务绑定地址、外部依赖连接信息等）
• 跨环境部署：兼容Docker容器化部署和Kubernetes集群部署
• 端口暴露：默认暴露***端口用于服务通信

使用场景

• 分布式任务调度系统中的工作节点部署
• 需要自定义Java运行参数的服务环境
• 容器化或云原生架构下的任务处理服务

使用方法

Docker部署

基本启动命令

bash
docker run --name beecomb-worker -d -p 19898:19898 -e JAVA_OPTS="..." -e JAVA_ARGS="" icodegarden/beecomb-worker:{version}

参数说明

• --name beecomb-worker：指定容器名称
• -d：后台运行容器
• -p 19898:19898：映射容器端口到主机端口
• -e JAVA_OPTS：配置Java VM启动参数
• -e JAVA_ARGS：配置应用程序启动参数
• icodegarden/beecomb-worker:{version}：镜像名称及版本（需将{version}替换为具体版本号）

JAVA_OPTS配置示例

bash
-e JAVA_OPTS="-server -Xms2048M -Xmx2048M -Xmn1024M -XX:MaxDirectMemorySize=50M -Dio.netty.noPreferDirect=true"

可配置的VM参数包括内存分配（-Xms/-Xmx）、新生代大小（-Xmn）、直接内存限制（-XX:MaxDirectMemorySize）等。

JAVA_ARGS配置示例

bash
-e JAVA_ARGS="--zookeeper.connectString=127.0.0.1:2181 --server.bindIp=127.0.0.1"

可配置应用参数如ZooKeeper连接地址（--zookeeper.connectString）、服务绑定IP（--server.bindIp）等。

Kubernetes部署

Deployment配置示例

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: beecomb-worker  
  name: beecomb-worker
spec:
  selector:
    matchLabels:
      app: beecomb-worker
  template:
    metadata:
      labels:
        app: beecomb-worker
    spec:
      containers:
        - env:
            - name: TZ
              value: Asia/Shanghai
            - name: JAVA_OPTS
              value: >-
                -server -Xms2048M -Xmx2048M
                -Xmn1024M -Xss256K -XX:MetaspaceSize=256M
                -XX:MaxMetaspaceSize=256M -XX:MaxDirectMemorySize=50M -Dio.netty.noPreferDirect=true
                -XX:-OmitStackTraceInFastThrow
            - name: JAVA_ARGS
              value: >-
                --zookeeper.connectString=zk37-svc:2181
                --commons.shardingsphere.datasources[0].name=ds0
                --commons.shardingsphere.datasources[0].jdbc-url=jdbc:mysql://1.1.1.1:3306/beecomb_0?setUnicode=true&characterEncoding=utf8&useSSL=false&autoReconnect=true&allowMultiQueries=true&serverTimezone=Asia/Shanghai
                --commons.shardingsphere.datasources[0].username=beecomb
                --commons.shardingsphere.datasources[0].password=beecomb
                --commons.shardingsphere.datasources[1].name=ds1
                --commons.shardingsphere.datasources[1].jdbc-url=jdbc:mysql://1.1.1.2:3306/beecomb_1?setUnicode=true&characterEncoding=utf8&useSSL=false&autoReconnect=true&allowMultiQueries=true&serverTimezone=Asia/Shanghai
                --commons.shardingsphere.datasources[1].username=beecomb
                --commons.shardingsphere.datasources[1].password=beecomb
                --commons.shardingsphere.rangeModShardingAlgorithms[0].algorithmName=jobidrangemod
                --commons.shardingsphere.rangeModShardingAlgorithms[0].groups[0].name=group0
                --commons.shardingsphere.rangeModShardingAlgorithms[0].groups[0].rangeGte=0
                --commons.shardingsphere.rangeModShardingAlgorithms[0].groups[0].rangeLt=20000000
                --commons.shardingsphere.rangeModShardingAlgorithms[0].groups[0].mod=2
                --commons.shardingsphere.rangeModShardingAlgorithms[0].groups[0].modLoadBalance={"ds0":[0],"ds1":[1]}
          image: 'icodegarden/beecomb-worker:1.1.0'
          imagePullPolicy: IfNotPresent
          name: beecomb-worker
          ports:
            - containerPort: 19898
              name: tcp
              protocol: TCP
          resources:
            limits:
              cpu: '2'
              memory: 3Gi
            requests:
              cpu: '2'
              memory: 3Gi      

配置说明

• 环境变量：
  • TZ：设置时区（示例中为Asia/Shanghai）
  • JAVA_OPTS：Java VM参数，配置内存、GC等
  • JAVA_ARGS：应用参数，包括ZooKeeper连接、数据库分片配置等
• 容器配置：
  • image：镜像地址及版本（示例中为1.1.0）
  • ports：暴露***端口
  • resources：设置CPU和内存资源限制与请求

环境变量说明