polarismesh/polaris-sidecar

镜像概述

该镜像为PolarisMesh官方提供的边车(sidecar)容器，旨在作为辅助容器与主应用协同工作，通过服务网格模式为应用提供微服务治理能力。sidecar与主应用共享网络命名空间，透明代理应用流量，实现服务发现、流量控制、配置管理等核心功能，无需修改主应用代码即可增强其分布式系统特性。

核心功能与特性### 1. 服务发现

• 自动将主应用实例注册至PolarisMesh服务端，支持健康检查（TCP/HTTP/自定义检查）确保服务可用性
• 动态发现服务集群中的其他实例，维护服务实例列表并实时更新

2. 流量治理

• 内置多种负载均衡策略（轮询、加权随机、一致性哈希等）
• 支持流量控制：熔断、限流、超时控制、重试机制
• 提供流量路由能力：基于权重的灰度发布、基于元数据的请求匹配

3. 配置管理

• 对接PolarisMesh配置中心，支持动态配置获取与热更新
• 配置变更自动推送至应用，无需重启即可生效
• 支持配置版本管理与回滚

4. 监控与可观测性

• 收集服务调用指标（QPS、延迟、错误率、吞吐量等）
• 输出标准化日志，支持日志级别（debug/info/warn/error）配置
• 兼容Prometheus指标暴露格式，便于接入监控系统

使用场景### 1. 微服务架构治理

适用于Spring Cloud、Dubbo等微服务框架，为服务间通信提供服务发现与流量控制能力。

2. 动态配置需求场景

需要频繁调整业务参数的应用（如限流阈值、功能开关），通过sidecar实时获取配置更新。

3. 分布式流量控制

在高并发场景下，需实现服务熔断、限流以保障系统稳定性的分布式应用。

4. 多环境部署管理

通过命名空间与路由规则，实现开发/测试/生产环境的流量隔离与灰度发布。

使用方法### 基本部署（Docker Run）

bash
docker run -d \
  --name polaris-sidecar \
  --network=host \  # 与主应用共享网络命名空间
  -e POLARIS_SERVER_ADDRESS=192.168.1.100:8091 \  # PolarisMesh服务端地址
  -e APP_NAME=order-service \  # 主应用服务名
  -e APP_NAMESPACE=prod \  # 服务命名空间
  -e APP_PORT=8080 \  # 主应用监听端口
  polarismesh/sidecar:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  app:
    image: my-business-app:1.0.0
    depends_on:
      - polaris-sidecar
    network_mode: "service:polaris-sidecar"  # 共享sidecar网络命名空间
    environment:
      - APP_ENV=production

  polaris-sidecar:
    image: polarismesh/sidecar:latest
    environment:
      - POLARIS_SERVER_ADDRESS=192.168.1.100:8091  # 必填，PolarisMesh服务端地址
      - APP_NAME=order-service  # 必填，主应用服务名
      - APP_NAMESPACE=prod  # 服务命名空间，默认default
      - APP_PORT=8080  # 主应用端口，sidecar代理流量至此
      - LOG_LEVEL=info  # 日志级别，默认info
      - SERVICE_REGISTER_ENABLE=true  # 自动注册服务，默认true
      - CONFIG_WATCH_ENABLE=true  # 启用配置监听，默认true
      - PROXY_HTTP_PORT=8090  # HTTP代理端口，默认8090

配置参数说明#### 环境变量

注意事项

1. 网络配置：sidecar必须与主应用共享网络命名空间（如--network=host或Compose中的network_mode: "service:..."），确保流量能被代理。
2. 启动顺序：主应用需在sidecar启动后启动，可通过depends_on配置依赖关系。
3. 服务端依赖：需确保PolarisMesh服务端已部署且网络可达，建议提前配置服务端地址与端口。
4. 资源限制：根据业务规模调整sidecar资源（CPU/内存），避免因资源不足影响代理性能。