理解 Output Relay

什么是 Output Relay？

Output Relay 是一种机制，允许同一个测试流水线中的一个测试用例将数据传递给另一个测试用例。可以把它理解为测试之间的"数据交接"。

简单类比：想象一场接力赛，运动员之间传递接力棒。在 Output Relay 中：

• 接力棒是一个变量（如 token、ID 或 URL）
• 第一棒选手（Output Case）生成并传递数据
• 下一棒选手（Input Case）接收并使用该数据

为什么需要 Output Relay？

问题：硬编码的依赖关系

没有 Output Relay 时，你可能会这样写测试：

PythonCopy
# 测试 A：登录并获取 token
def test_login():
    token = api.login("user", "pass")
    # Token 在测试结束后就丢失了！

# 测试 B：获取用户资料（失败 - 没有 token！）
def test_get_profile():
    token = "???"  # 这个从哪来？
    api.get_profile(token)

常见的变通方法（都有问题）：

• 硬编码 token → token 过期就失效
• 合并成一个巨大的测试 → 难以维护，调试缓慢
• 使用全局变量 → 测试之间产生耦合，变得脆弱

解决方案：Output Relay

使用 Output Relay，测试 A 可以将 token 传递给测试 B：

每个测试保持独立，但数据通过流水线流动。

核心概念

Output Case vs Input Case

Relay 变量

Relay 变量是一个命名变量，它：

1. 在 Testany 平台的 Output Case 环境变量中声明
2. 在 Output Case 的代码运行时被赋值
3. 作为环境变量被 Input Case 消费

流水线中的数据流向

以下是典型的 Output Relay 流水线中数据的流动方式：

在这个示例中：

• Case A 输出 ACCESS_TOKEN
• Case B 输入 ACCESS_TOKEN，输出 USER_ID
• Case C 同时输入 ACCESS_TOKEN（来自 A）和 USER_ID（来自 B）

端到端配置概览

配置 Output Relay 涉及跨两个系统的三个步骤：

步骤 1：编写代码输出数据

在 Output Case 中，使用 TESTANY_OUTPUT_RELAY_SERVICE 环境变量来 POST 数据：

PythonCopy
# Python 示例
import os
import requests

relay_service = os.environ.get('TESTANY_OUTPUT_RELAY_SERVICE')
requests.post(relay_service, json={
    'ACCESS_TOKEN': 'eyJhbGciOiJIUzI1NiIs...'
})

步骤 2：在平台上标记变量为 Relay

在测试用例详情页面，添加环境变量并点击 relay 图标 将其标记为 relay 变量。

步骤 3：配置 Pipeline YAML

在流水线定义中，使用 relay 连接用例：

YAMLCopy
kind: rule/v1.3
spec:
  rules:
    - run: A1B2C3D4  # 登录用例
    - run: E5F6A7B8  # 获取资料用例
      relay:
        - key: ACCESS_TOKEN
          refKey: A1B2C3D4/ACCESS_TOKEN  # 引用登录用例的输出

约束和限制

Relay 仅对通过的用例有效

在 rule/v1.3 中，这个约束还意味着：消费 relay 的测试脚本不能与提供 relay 的测试脚本处于可能同时启动的关系里。平台会要求提供 relay 的测试脚本先完成，再启动消费 relay 的测试脚本。

这意味着你不能这样配置：

YAMLCopy
# 无效 - relay 与 whenFailed 组合
- run: E5F6A7B8  # Input case
  whenFailed: A1B2C3D4  # Output case 失败了，没有可靠数据
  relay:
    - key: TOKEN
      refKey: A1B2C3D4/TOKEN

不允许循环依赖

平台会自动检测并拒绝循环的 relay 配置：

YAMLCopy
# 无效 - 循环依赖
- run: A1B2C3D4  # Case A
  relay:
    - key: X
      refKey: E5F6A7B8/Y
- run: E5F6A7B8  # Case B
  relay:
    - key: Y
      refKey: A1B2C3D4/X  # 错误：循环依赖

不支持性能测试

Output Relay 仅适用于功能测试，不支持性能/负载测试场景。

下一步

现在你已经理解了概念，请继续阅读实现指南：

快速参考