等待就绪
解释如何配置 RPC 在发送请求之前等待服务器就绪。
等待就绪
解释如何配置 RPC 在发送请求之前等待服务器就绪。
概述
这是一项可以在 stub 上使用的功能,它将导致 RPC 在发送请求之前等待服务器变为可用状态。这允许健壮的批量工作流程,因为瞬时的服务器问题不会导致失败。截止时间仍然适用,因此如果超过截止时间,等待将被中断。
当通道未能连接到服务器时创建 RPC 时,如果不使用等待就绪,它将立即返回失败;使用等待就绪,它将简单地排队,直到连接准备就绪。默认情况下为不使用等待就绪。
有关详细语义,请参阅此。
如何使用等待就绪
您可以指定 stub 是否应使用等待就绪,这将在创建 RPC 时自动传递。
注意
RPC 仍然可能因为服务器未准备就绪之外的其他原因而失败,因此仍然需要进行错误处理。以下显示了当客户端向服务器发送消息时发生的事件序列,基于通道状态以及是否设置了等待就绪。
sequenceDiagram
participant A as Application
participant RPC
participant CH as Channel
participant S as Server
A->>RPC: Create RPC using stub
RPC->>CH: Initiate Communication
alt channel state: READY
CH->>S: Send message
else Channel state: IDLE or CONNECTING
CH-->>CH: Wait for state change
else Channel state: TRANSIENT_FAILURE
alt with Wait-for-Ready
CH-->>CH: Wait for channel<br>becoming READY<br>(or a permanent failure)
CH->>S: Send message
else without Wait-for-Ready
CH->>A: Failure
end
else Channel state is a Permanent Failure
CH->>A: Failure
end
以下是基于状态的视图
stateDiagram-v2
state "Initiating Communication" as IC
state "Channel State" as CS
IC-->CS: Check Channel State
state CS {
state "Permanent Failure" as PF
state "TRANSIENT_FAILURE" as TF
IDLE --> CONNECTING
CONNECTING --> READY
READY-->[*]
CONNECTING-->TF
CONNECTING-->PF
TF-->READY
TF -->[*]: without\n wait-for-ready
TF-->PF
PF-->[*]
}
state "MSG sent" as MS
state "RPC Failed" as RF
CS-->WAIT:From IDLE /\nCONNECTING
CS-->WAIT:From Transient\nFailure with\nWait-for-Ready
WAIT-->CS:State Change
CS-->MS: From READY
CS-->RF: From Permanent failure or\nTransient Failure without\nWait-for-Ready
MS-->[*]
RF-->[*]
替代方案
- 循环(使用指数退避),直到 RPC 停止返回瞬时失败。
- 为了提高效率,这可以与实现
onReady
处理程序(对于支持此功能的语言)相结合。
- 为了提高效率,这可以与实现
- 接受可能可以通过等待避免的失败,因为您希望快速失败
语言支持
语言 | 示例 |
---|---|
Java | Java 示例 |
Go | Go 示例 |
Python | Python 示例 |
上次修改时间:2023 年 8 月 22 日:fix: Go example url error in Wait-for-Ready documentation page (#1179) (007035b)