在Solo.io Gloo中实现请求头到请求体的转换

概述

在现代API网关的使用场景中，经常需要处理请求和响应数据的转换。本文将详细介绍如何在Solo.io Gloo网关中实现将HTTP请求头信息添加到JSON请求体中的功能。这种功能在需要将认证信息、跟踪ID等头部信息传递到后端服务的场景中非常有用。

前置准备

在开始之前，我们需要确保已经完成以下准备工作：

1. 已安装并运行Gloo网关
2. 已配置一个可用的上游服务（本文使用Postman Echo服务作为示例）
3. 准备一个简单的JSON文件作为请求体

基础配置

首先，我们创建一个基本的Virtual Service配置，将所有流量路由到Postman Echo服务：

apiVersion: gateway.solo.io/v1
kind: VirtualService
metadata:
  name: headers-to-body
  namespace: gloo-system
spec:
  virtualHost:
    domains:
    - '*'
    routes:
    - matchers:
       - prefix: /
      routeAction:
        single:
          upstream:
            name: postman-echo
            namespace: gloo-system
      options:
        autoHostRewrite: true

同时，我们创建一个简单的JSON请求体文件data.json：

{
  "payload": {
    "foo": "bar"
  }
}

验证基础配置

使用curl命令测试基础配置是否正常工作：

curl -H "Content-Type: application/json" $(glooctl proxy url)/post -d @data.json | jq

如果配置正确，你应该会看到一个包含原始请求体和各种头部信息的响应。

实现头部到请求体的转换

现在，我们来实现将特定头部信息添加到请求体的功能。我们需要修改Virtual Service配置，添加转换规则：

apiVersion: gateway.solo.io/v1
kind: VirtualService
metadata:
  name: headers-to-body
  namespace: gloo-system
spec:
  virtualHost:
    domains:
    - '*'
    routes:
    - matchers:
       - prefix: /
      routeAction:
        single:
          upstream:
            name: postman-echo
            namespace: gloo-system
      options:
        autoHostRewrite: true
    options:
      transformations:
        requestTransformation:
          transformationTemplate:
            mergeExtractorsToBody: {}
            extractors:
              root:
                header: 'root'
                regex: '.*'
              payload.nested:
                header: 'nested'
                regex: '.*'

配置解析

1. transformations：定义数据转换规则
2. requestTransformation：指定这是请求转换（而非响应转换）
3. transformationTemplate：使用模板方式进行转换
4. mergeExtractorsToBody：将提取的值合并到请求体中
5. extractors：定义从请求中提取数据的规则
   • root：提取名为'root'的头部值，并放在JSON的根级别
   • payload.nested：提取名为'nested'的头部值，并放在payload对象内

测试转换功能

现在我们可以测试转换功能是否正常工作：

curl -H "Content-Type: application/json" -H "root: root-val" -H "nested: nested-val" $(glooctl proxy url)/post -d @data.json | jq

在响应中，你应该能看到头部信息已经被成功添加到请求体中：

{
  "data": {
    "payload": {
      "foo": "bar",
      "nested": "nested-val"
    },
    "root": "root-val"
  },
  // 其他响应字段...
}

高级用法

嵌套路径控制

通过extractor的名称可以控制值在JSON中的嵌套位置：

• 使用点号(.)表示嵌套层级（当advancedTemplates为false时）
• 例如payload.user.id会创建三层嵌套结构

正则表达式处理

每个extractor必须包含一个regex模式：

• 简单匹配可以使用.*
• 复杂场景可以使用正则表达式提取特定部分

多值处理

如果需要处理多个头部或复杂转换，可以：

1. 定义多个extractor
2. 使用更复杂的transformationTemplate

清理资源

完成测试后，可以删除创建的Virtual Service和Upstream：

kubectl delete virtualservice -n gloo-system headers-to-body
kubectl delete upstream -n gloo-system postman-echo

总结

本文详细介绍了如何在Solo.io Gloo网关中实现将HTTP头部信息添加到JSON请求体的功能。通过这种转换，我们可以灵活地将各种头部信息传递到后端服务，满足不同的业务需求。Gloo的转换功能非常强大，除了本文介绍的基础用法外，还支持更复杂的转换场景，值得进一步探索。