Connection Backoff Interop Test Descriptions

本文档用于证实客户端能够以正确的backoffs重连服务器。测试服务器有一个端口(控制端口)，运行控制服务器的rpc服务，另一个端口(重试端口)来关闭任何进入的 tcp 连接。测试有下述流：

服务器开始在控制端口上监听。
客户端调用在服务器控制端口上调用一个rpc。
服务器开始在重试端口上监听。
客户端使用backoffs连接服务器的重试端口，尝试540s，也就是大约13次重试。
客户端在服务器控制端口上调用停止服务器。
客户端检查响应，看服务器是否认为backoffs符合规范，或者对响应种的backoffs做自己的检查。

客户端和服务器使用test.proto。每个语言都需要实现自己的客户端，C++服务器在多语言间共享。

Client

客户端需要接收这些参数：

-server_control_port = PORT
- rpc连接的服务器端口。例如，“8080”。
-server_retry_port=PORT
- 为测试备值连接服务器的端口。例如，“8081”。

客户端必须不适用TLS连接控制端口。客户端必须使用TLS连接重试端口。客户端应当诊断服务器返回的backoff状态或者检查它自己的backoffs。
客户端的过程：

在服务控制端口上用一个很大的deadline或者没有deadline开始调用，等待它的完成或者检验是否成功。
初始化一个通向服务器重试端口的channel连接，它将使用合适的backoffs进行重连。一个方便的方法来实现此功能是调用使用540s的deadline开始。超过deadline时rpc应当失败。
调用在服务器控制端口上停止，并检验是否成功。
检验回复来确定是否服务器认为backoff通过了测试。
可选的，客户端能够对返回的backoff做自己的检验。

Server

一个C++服务器能被用于这个测试。其他语言不需要实现一个服务器。为了最小化网络延时，服务器应当在相同的机器上运行，或者在客户端二进制可执行文件附近的机器上运行(网络上的距离概念)。

一个服务器实现对其状态的重连服务。它也在重试端口打开一个tcp server，它仅仅关闭所有进来的tcp连接来模拟连接失败。服务器将保留所有重连时间戳的记录并在响应中返回连接backoff。服务器也检查backoffs来判断是否它们符合规范并返回是否客户端通过了测试。

当另一个客户端在测试时，如果服务器接收到一个启动调用，当另一个客户端完成操作时，它结束该调用。当一个客户端正在被测试时，如果其他的主机连接服务器的retry_port，服务器将打印出一个错误，但是可能会认为客户端测试失败。
服务器接受这些参数：

-control_port=PORT
- 控制rpcs监听端口。例如，“8080”
–retry_port=PORT
- tcp服务器端口。例如,“8081”