paskalmaksim/envoy-docker-image

Envoy Control Plane

概述

Envoy Control Plane是一个功能完善的控制平面解决方案，用于管理和配置Envoy代理。它提供了动态配置管理、服务发现、流量路由和负载均衡等核心功能，帮助用户构建弹性、可扩展的微服务架构。

核心功能和特性

• 动态配置管理：支持Envoy代理的动态配置更新，无需重启服务
• 服务发现：集成多种服务发现机制，包括静态配置、DNS和自定义提供商
• 流量控制：提供细粒度的流量路由、分流和负载均衡策略
• 健康检查：内置服务健康检查机制，自动隔离不健康实例
• TLS管理：支持自动TLS证书配置和更新
• 指标收集：集成Prometheus指标导出，便于监控和分析

使用场景和适用范围

• 构建和管理微服务架构中的服务网格
• 需要动态配置和流量控制的云原生应用
• 多团队协作开发的大型应用系统
• 需要高可用性和可扩展性的生产环境
• Kubernetes集群中的服务通信管理

使用方法和配置说明

前提条件

• Docker 19.03+
• Docker Compose 2.0+ (可选)
• 至少1GB可用内存

基本使用

Docker Run 示例

bash
docker run -d \
  --name envoy-control-plane \
  -p 8080:8080 \
  -e LOG_LEVEL=info \
  -e SERVICE_DISCOVERY_TYPE=static \
  maksim-paskal/envoy-control-plane

Docker Compose 示例

yaml
version: '3'
services:
  control-plane:
    image: maksim-paskal/envoy-control-plane
    ports:
      - "8080:8080"
    environment:
      - LOG_LEVEL=info
      - SERVICE_DISCOVERY_TYPE=static
      - STATIC_SERVICES_CONFIG=/config/services.yaml
    volumes:
      - ./config:/config
    restart: always

环境变量配置

配置文件格式

静态服务配置文件示例 (services.yaml):

yaml
services:
  - name: service-a
    hosts:
      - address: 192.168.1.100
        port: 8080
      - address: 192.168.1.101
        port: 8080
    route_config:
      prefix: /api/service-a
      timeout: 5s
  
  - name: service-b
    hosts:
      - address: 192.168.1.102
        port: 8080
    route_config:
      prefix: /api/service-b
      timeout: 3s

API接口

控制平面提供以下主要API端点:

• GET /v1/config - 获取当前配置
• POST /v1/config - 更新配置
• GET /v1/services - 获取服务列表
• GET /v1/health - 健康检查端点
• GET /metrics - Prometheus指标导出

注意事项

• 在生产环境中建议启用TLS加密通信
• 对于大规模部署，考虑使用集群模式提高可用性
• 定期备份配置数据，防止数据丢失
• 升级前请查阅版本变更日志，注意兼容性问题