doc: sync gRPC Streaming Graceful Shutdown (#1190)

Co-authored-by: yuxuan.wang1 <[email protected]>

content/en/docs/kitex/Tutorials/basic-feature/protocol/streaming/_index.md

@@ -0,0 +1,7 @@
+---
+title: "Streaming"
+linkTitle: "Streaming"
+weight: 2
+date: 2024-01-13
+description: >
+---

content/en/docs/kitex/Tutorials/basic-feature/protocol/streaming/gRPC/_index.md

@@ -0,0 +1,7 @@
+---
+title: "gRPC"
+linkTitle: "gRPC"
+weight: 2
+date: 2024-01-13
+description: >
+---

content/en/docs/kitex/Tutorials/basic-feature/protocol/streaming/gRPC/graceful_shutdown.md

@@ -0,0 +1,40 @@
+---
+title: "gRPC Streaming Graceful Shutdown"
+date: 2025-01-13
+weight: 4
+keywords: ["gRPC Streaming Graceful Shutdown"]
+description: "This article describes how to use Graceful Shutdown over gRPC"
+---
+
+## Background
+
+To effectively solve the problem of upstream error reporting caused by service upgrade/migration, Kitex supports the graceful shutdown function of gRPC Streaming in the new version (v0.12.0).
+
+By setting a reasonable window time, the streams with a lifetime shorter than this window can continue to work until the end, while the streams with a lifetime longer than this window will be forcibly closed.
+
+## Usage
+
+### Confirm the window time
+
+Before starting the configuration, please obtain the duration distribution of the streams in the current service based on business statistics, and thereby establish a reasonable window time, denoted as **graceTime**, for example:
+
+- All streams can be completed within 5 minutes, and 5 minutes is an acceptable service upgrade time, then **graceTime** is 5 minutes.
+- Most streams can be completed within 5 minutes, and very few streams will last for 30 minutes, then **graceTime** can still be set to 5 minutes, and the flows exceeding graceTime will be forcibly closed.
+
+### Configuration
+
+When creating the Server, pass `server.WithExitWaitTime(graceTime)`.
+
+If not configured, the default is **5 s**.
+
+```go
+import (
+    "github.com/cloudwego/kitex/server"
+)
+
+const (
+    graceTime = 600 * time.Second
+)
+
+svr := testservice.NewServer(hdl, server.WithExitWaitTime(graceTime))
+```

content/en/docs/kitex/Tutorials/basic-feature/protocol/transport-streaming/thrift_streaming.md → content/en/docs/kitex/Tutorials/basic-feature/protocol/streaming/gRPC/thrift_streaming.md

@@ -1,9 +1,9 @@
 ---
-title: "Thrift Streaming"
+title: "Thrift Streaming over gRPC"
 date: 2024-03-09
-weight: 2
-keywords: ["Kitex", "Streaming", "Thrift"]
-description: This article describes how to define and use the Streaming API in Thrift IDL.
+weight: 3
+keywords: ["Kitex", "Streaming", "Thrift", "gRPC"]
+description: This article describes how to define and use the Streaming API in Thrift IDL over gRPC.
 ---
 
 ## Introduction

content/zh/docs/kitex/Tutorials/basic-feature/protocol/streaming/_index.md

@@ -0,0 +1,7 @@
+---
+title: "Streaming"
+linkTitle: "Streaming"
+weight: 2
+date: 2024-03-06
+description: >
+---

content/zh/docs/kitex/Tutorials/basic-feature/protocol/streaming/gRPC/_index.md

@@ -0,0 +1,7 @@
+---
+title: "gRPC"
+linkTitle: "gRPC"
+weight: 2
+date: 2025-01-13
+description: >
+---

content/zh/docs/kitex/Tutorials/basic-feature/protocol/transport-streaming/graceful_shutdown.md → content/zh/docs/kitex/Tutorials/basic-feature/protocol/streaming/gRPC/graceful_shutdown.md

@@ -1,7 +1,7 @@
 ---
 title: "gRPC Streaming 优雅退出"
 date: 2025-01-10
-weight: 3
+weight: 4
 keywords: ["优雅退出"]
 description: "本文介绍如何使用 gRPC Streaming 优雅突出"
 ---

content/zh/docs/kitex/Tutorials/basic-feature/protocol/transport-streaming/thrift_streaming.md → content/zh/docs/kitex/Tutorials/basic-feature/protocol/streaming/gRPC/thrift_streaming.md

@@ -1,8 +1,8 @@
 ---
-title: "Thrift Streaming"
+title: "Thrift Streaming over gRPC"
 date: 2024-03-06
-weight: 2
-keywords: ["Kitex", "Streaming", "Thrift"]
+weight: 3
+keywords: ["Kitex", "Streaming", "Thrift", "gRPC"]
 description: 本文介绍如何在 Thrift IDL 里定义并使用 Streaming API。
 ---