nextdoor/zkwatcher

ZKWatcher：Zookeeper中的服务注册与监控辅助容器

镜像概述

ZKWatcher是一个轻量级辅助容器，用于将运行中的服务注册到Zookeeper的临时节点，并监控服务状态。它助力分布式系统实现服务发现功能，确保服务实例的动态管理与协调。

核心功能

• 自动将服务实例注册到Zookeeper指定路径的临时节点
• 实时监控服务运行状态，服务停止时自动移除对应Zookeeper节点
• 支持通过环境变量自定义Zookeeper连接参数、节点路径及服务信息

使用场景

• 分布式微服务架构中的服务发现场景
• 需要动态管理服务实例的集群环境
• 依赖Zookeeper进行服务协调的应用系统

配置说明

关键配置可通过环境变量设置：

• ZK_HOSTS：Zookeeper集群地址（格式：节点1:端口,节点2:端口）
• ZK_PATH：服务注册的Zookeeper节点路径（如/services/my-service）
• SERVICE_HOST：服务实例的主机地址或域名
• SERVICE_PORT：服务实例的监听端口

部署示例

Docker Run命令

bash
docker run -d \
  -e ZK_HOSTS="zk-cluster:2181" \
  -e ZK_PATH="/services/user-service" \
  -e SERVICE_HOST="user-service-01" \
  -e SERVICE_PORT="8080" \
  nextdoor/zkwatcher

Docker Compose示例

yaml
version: '3.8'
services:
  zkwatcher:
    image: nextdoor/zkwatcher
    environment:
      ZK_HOSTS: "zk:2181"
      ZK_PATH: "/services/product-service"
      SERVICE_HOST: "product-service"
      SERVICE_PORT: "9090"
    depends_on:
      - zk
  
  zk:
    image: zookeeper:3.8
    ports:
      - "2181:2181"
    volumes:
      - zk-data:/data
      - zk-datalog:/datalog

volumes:
  zk-data:
  zk-datalog: