paskalmaksim/envoy-control-plane

Envoy Control Plane Docker镜像

概述

Envoy Control Plane是一个基于Go语言开发的轻量级Envoy代理控制平面实现。该镜像提供了一个简单但功能完善的控制平面，允许通过REST API动态配置和管理Envoy代理实例，无需深入了解Envoy的复杂配置细节。

核心功能与特性

• 动态配置管理：通过REST API实现Envoy配置的动态更新
• REST API接口：提供直观的HTTP接口用于配置管理
• 配置验证：内置配置验证机制，确保Envoy配置的正确性
• 热重载支持：支持配置的热重载，无需重启Envoy代理
• 基于文件的存储：使用文件系统存储配置，便于备份和版本控制
• 轻量级设计：资源占用低，部署简单
• 高可用性：支持多实例部署，实现高可用架构

使用场景

• 微服务架构中Envoy代理的集中管理
• 需要动态调整流量路由规则的环境
• 服务网格(Service Mesh)的简化实现
• Envoy代理的快速部署和配置管理
• 开发和测试环境中的Envoy配置管理

快速开始

基本部署

使用以下命令启动Envoy Control Plane容器：

bash
docker run -d -p 8080:8080 --name envoy-control-plane maksim-paskal/envoy-control-plane

使用Docker Compose

创建docker-compose.yml文件：

yaml
version: '3'
services:
  envoy-control-plane:
    image: maksim-paskal/envoy-control-plane
    ports:
      - "8080:8080"
    volumes:
      - ./configs:/app/configs
    environment:
      - PORT=8080
      - CONFIG_PATH=/app/configs
      - LOG_LEVEL=info

启动服务：

bash
docker-compose up -d

配置说明

环境变量

持久化配置

为了持久化存储配置文件，建议挂载配置目录：

bash
docker run -d -p 8080:8080 \
  -v /host/path/to/configs:/app/configs \
  --name envoy-control-plane \
  maksim-paskal/envoy-control-plane

API使用

获取所有配置

bash
curl http://localhost:8080/api/v1/configs

创建新配置

bash
curl -X POST http://localhost:8080/api/v1/configs \
  -H "Content-Type: application/json" \
  -d @config.json

获取特定配置

bash
curl http://localhost:8080/api/v1/configs/{config_id}

更新配置

bash
curl -X PUT http://localhost:8080/api/v1/configs/{config_id} \
  -H "Content-Type: application/json" \
  -d @updated_config.json

删除配置

bash
curl -X DELETE http://localhost:8080/api/v1/configs/{config_id}

Envoy代理配置

Envoy代理需要配置为从控制平面获取配置。以下是一个基本的Envoy配置示例：

yaml
static_resources:
  clusters:
  - name: xds_cluster
    connect_timeout: 0.25s
    type: STATIC
    lb_policy: ROUND_ROBIN
    http2_protocol_options: {}
    hosts:
    - socket_address:
        address: envoy-control-plane
        port_value: 8080

dynamic_resources:
  lds_config:
    resource_api_version: V3
    api_config_source:
      api_type: REST
      transport_api_version: V3
      cluster_names: [xds_cluster]
      refresh_delay: 5s
  cds_config:
    resource_api_version: V3
    api_config_source:
      api_type: REST
      transport_api_version: V3
      cluster_names: [xds_cluster]
      refresh_delay: 5s

故障排除

查看日志

bash
docker logs envoy-control-plane

健康检查

控制平面提供健康检查端点：

bash
curl http://localhost:8080/health

启用调试模式

bash
docker run -d -p 8080:8080 \
  -e LOG_LEVEL=debug \
  -e ENABLE_PPROF=true \
  --name envoy-control-plane \
  maksim-paskal/envoy-control-plane

启用pprof后，可以通过http://localhost:8080/debug/pprof访问调试信息。

相关链接

• https://github.com/maksim-paskal/envoy-control-plane
• Envoy官方文档
• https://github.com/maksim-paskal/envoy-control-plane/blob/master/docs/api.md