argoproj/resource-gateway Docker 镜像 - 轩辕镜像

Kubernetes资源网关镜像文档

镜像概述

本镜像为Kubernetes集群提供资源网关功能，作为集群内资源的统一访问入口，实现对Kubernetes API资源、微服务及集群内其他资源的集中管理、路由转发和访问控制，简化集群资源访问流程并增强安全性。

核心功能与特性

• 资源路由管理：支持基于资源类型、命名空间、标签的请求路由，实现不同资源的精准转发
• 访问控制：集成RBAC（基于角色的访问控制）机制，支持细粒度权限配置，限制资源访问范围
• 流量监控：内置流量统计与监控功能，记录资源访问日志、请求延迟及错误率等指标
• 负载均衡：对集群内服务请求提供基础负载均衡能力，支持轮询、权重等负载均衡策略
• 高可用性：支持多实例部署，通过健康检查机制实现故障自动恢复
• 配置灵活性：支持环境变量配置、配置文件挂载及动态配置更新

使用场景

• 多团队共享集群：为不同团队分配独立访问入口，实现资源隔离与权限控制
• 微服务通信管理：作为微服务间通信的中间层，统一处理服务发现、路由及流量控制
• 集群资源外部访问：提供外部系统访问Kubernetes集群资源的安全入口，避免直接暴露集群API
• 资源访问审计：通过访问日志实现资源操作审计，满足合规性要求

使用方法

基础部署（Docker Run）

bash
docker run -d \
  --name k8-resource-gateway \
  -p 8080:8080 \
  -e KUBECONFIG=/etc/k8s/config \
  -e PORT=8080 \
  -e AUTH_MODE=rbac \
  -v /path/to/kubeconfig:/etc/k8s/config \
  k8-resource-gateway:latest

Docker Compose配置示例

yaml
version: '3'
services:
  resource-gateway:
    image: k8-resource-gateway:latest
    container_name: k8-resource-gateway
    ports:
      - "8080:8080"
    environment:
      - KUBECONFIG=/etc/k8s/config
      - PORT=8080
      - AUTH_MODE=rbac
      - LOG_LEVEL=info
      - METRICS_PORT=9090
    volumes:
      - /path/to/kubeconfig:/etc/k8s/config
      - /path/to/gateway-config:/etc/gateway/config.yaml
    restart: unless-stopped

环境变量配置

配置文件说明

路由规则配置文件（routes.yaml）示例：

yaml
routes:
  - name: "default-ns-pods"
    path: "/api/v1/namespaces/default/pods"
    destination:
      resource: "pods"
      namespace: "default"
    methods: ["GET", "POST"]
    auth:
      roles: ["pod-reader", "admin"]
  - name: "micro-service-route"
    path: "/services/*"
    destination:
      service: "micro-service"
      port: 8080
    load***:
      strategy: "round_robin"

访问与验证

启动容器后，可通过以下方式验证网关服务：

bash
# 检查服务状态
curl http://localhost:8080/health

# 访问集群资源（需配置正确权限）
curl http://localhost:8080/api/v1/namespaces/default/pods

注意事项

• 需确保容器内Kubernetes配置文件（KUBECONFIG）具有足够权限访问集群资源
• 生产环境建议启用AUTH_MODE=rbac并配置严格的角色权限
• 高负载场景下建议配合外部负载均衡器使用，并调整资源限制（--memory, --cpus）
• 路由规则变更后需重启容器或通过API动态加载配置（如支持）