coco/k8s-path-routing-varnish

UPP Path routing Varnish 镜像文档

镜像概述

UPP Path routing Varnish是一个部署在api-policy-component之后的Varnish路由代理。其核心作用是基于URL中的上下文路径，将流量路由到K8s集群内的相应服务，实现集群内部的智能流量分发。

核心功能与特性

• 上下文路径路由：通过解析URL中的上下文路径，将请求定向到指定服务
• K8s集群适配：专为K8s集群环境设计，支持集群内部服务间的流量路由
• VCL策略定义：路由规则通过Varnish配置语言（VCL）定义，具体策略可参考default.vcl文件

使用场景

适用于K8s集群环境中需要基于URL路径进行服务路由的场景，尤其适合微服务架构下的API流量分发，可作为API网关后的二级路由层使用。

使用方法与配置说明

路由策略查看

Varnish的路由策略定义在default.vcl配置文件中，该文件包含了完整的请求匹配规则和服务路由逻辑。可通过以下方式查看具体策略：

bash
# 查看default.vcl文件内容
cat /default.vcl

部署建议

在K8s集群中部署时，建议将default.vcl作为配置项（ConfigMap）挂载到容器中，以便灵活调整路由策略。典型的K8s部署配置示例（片段）：

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: varnish-config
data:
  default.vcl: |
    # 此处为具体的VCL路由配置内容
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: upp-path-routing-varnish
spec:
  template:
    spec:
      containers:
      - name: varnish
        image: [镜像名称]
        volumeMounts:
        - name: varnish-config-volume
          mountPath: /default.vcl
          subPath: default.vcl
      volumes:
      - name: varnish-config-volume
        configMap:
          name: varnish-config

关键配置说明

• VCL配置文件：default.vcl是核心配置文件，包含vcl_recv等关键子例程，定义了请求接收、匹配和路由逻辑
• 路由规则：通过在VCL中配置if条件判断或switch语句，基于req.url的上下文路径（如/service1、/api/v2等）匹配目标服务地址