eipwork/eip-service-index

EIP服务索引镜像文档

概述

EIP服务索引镜像是一个轻量级的服务注册与发现解决方案，专为微服务架构设计。它提供了服务注册、健康检查、元数据管理和负载均衡等核心功能，帮助构建可靠、可扩展的分布式系统。

核心功能和特性

• 服务注册：支持服务实例的动态注册与注销
• 服务发现：提供API和DNS两种服务发现方式
• 健康检查：内置多种健康检查机制，确保只将请求路由到健康的服务实例
• 元数据管理：存储和检索服务相关的元数据信息
• 负载均衡：支持多种负载均衡策略，包括轮询、权重和最少连接
• 高可用性：支持集群部署，确保服务索引本身的高可用
• REST API：提供完整的RESTful API，便于集成和管理
• 轻量级：基于Go语言开发，资源占用低，启动迅速

使用场景和适用范围

• 微服务架构中的服务注册与发现
• 分布式系统的服务治理
• 容器化应用的服务路由
• 云原生环境中的服务管理
• 需要动态扩展的应用系统

使用方法和配置说明

基本使用

使用以下命令启动EIP服务索引容器：

bash
docker run -d -p 8500:8500 --name eip-service-index shaohq/eip-service-index:latest

环境变量配置

支持以下环境变量进行配置：

持久化数据

为确保服务数据持久化，建议挂载数据卷：

bash
docker run -d -p 8500:8500 \
  -v /host/data/dir:/data \
  --name eip-service-index \
  shaohq/eip-service-index:latest

Docker Compose配置

yaml
version: '3'
services:
  eip-service-index:
    image: shaohq/eip-service-index:latest
    container_name: eip-service-index
    ports:
      - "8500:8500"
    environment:
      - LOG_LEVEL=info
      - CLUSTER_MODE=false
    volumes:
      - eip-data:/data
    restart: unless-stopped

volumes:
  eip-data:

集群部署

部署3节点集群示例：

bash
# 启动第一个节点
docker run -d -p 8500:8500 \
  -e CLUSTER_MODE=true \
  -e ADVERTISE_ADDR=192.168.1.101 \
  -e INITIAL_CLUSTER=node1=192.168.1.101:8300,node2=192.168.1.102:8300,node3=192.168.1.103:8300 \
  --name eip-service-index-node1 \
  shaohq/eip-service-index:latest

API使用示例

注册服务

bash
curl -X POST http://localhost:8500/v1/services \
  -H "Content-Type: application/json" \
  -d '{
    "service": "user-service",
    "id": "user-service-1",
    "address": "192.168.1.10",
    "port": 8080,
    "tags": ["v1", "production"],
    "check": {
      "http": "http://192.168.1.10:8080/health",
      "interval": "10s",
      "timeout": "5s"
    }
  }'

发现服务

bash
curl http://localhost:8500/v1/services/user-service

维护和更新

查看日志

bash
docker logs -f eip-service-index

升级镜像

bash
docker pull shaohq/eip-service-index:latest
docker stop eip-service-index
docker rm eip-service-index
docker run -d -p 8500:8500 --name eip-service-index shaohq/eip-service-index:latest

常见问题

• Q: 如何实现服务索引的高可用？ A: 通过集群模式部署3个或更多节点，确保即使部分节点故障，服务索引仍能正常工作。

• Q: 支持多少个服务实例注册？ A: 理论上无限制，实际取决于服务器资源，建议单个节点不超过1000个服务实例。