[dubbo-website] branch master updated: Create dubbo-kubernetes-probe.md (#1101)

[cr...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

crazyhzm pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git


The following commit(s) were added to refs/heads/master by this push:
     new 27ee9b0e06 Create dubbo-kubernetes-probe.md (#1101)
27ee9b0e06 is described below

commit 27ee9b0e06ab1c71d30c92a666c51a987c16049c
Author: jody mford <11...@qq.com>
AuthorDate: Fri Jun 17 12:42:07 2022 +0800

    Create dubbo-kubernetes-probe.md (#1101)
    
    * Create dubbo-kubernetes-probe.md
    
    * Update dubbo-kubernetes-probe.md
    
    * Update dubbo-kubernetes-probe.md
---
 .../java-sdk/dubbo-kubernetes-probe.md             | 69 ++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/content/zh/docs3-building/java-sdk/dubbo-kubernetes-probe.md b/content/zh/docs3-building/java-sdk/dubbo-kubernetes-probe.md
new file mode 100644
index 0000000000..f8902ecc06
--- /dev/null
+++ b/content/zh/docs3-building/java-sdk/dubbo-kubernetes-probe.md
@@ -0,0 +1,69 @@
+# Dubbo using Kubernetes probe
+了解 Dubbo 与 Kubernetes 生命周期对齐探针的扩展与应用场景
+
+## 特性说明
+[Pod 的生命周期](https://kubernetes.io/zh/docs/concepts/workloads/pods/pod-lifecycle/)  与服务调度息息相关，通过对 Kubernetes 官方探针的实现，能够使 Dubbo 乃至整个应用的生命周期与 Pod 的生命周期，在 Pod 的整个生命周期中，影响到 Pod 的就只有健康检查这一部分, 我们可以通过配置 liveness probe（存活探针）和 readiness probe（可读性探针）来影响容器的生命周期。
+
+通过 Dubbo 的 SPI 机制，在内部实现多种“探针”，基于 Dubbo QOS 运维模块的 HTTP 服务，使容器探针能够获取到应用内对应探针的状态。另外，SPI 的实现机制也利于用户自行拓展内部“探针”，使整个应用的生命周期更有效的进行管控
+
+## Dobbo   SPI 接口探针 [Dubbo SPI扩展](https://dubbo.apache.org/zh/docs3-building/java-sdk/reference-manual/spi/description/)
+
+三种探针对应的 SPI 接口如下：
+
+-   livenessProbe:  `org.apache.dubbo.qos.probe.LivenessProbe`
+-   readinessProbe:  `org.apache.dubbo.qos.probe.ReadinessProbe`
+-   startupProbe:  `org.apache.dubbo.qos.probe.StartupProbe`
+
+接口将自动获取当前应用所有 SPI 的实现，对应接口的 SPI 实现均成功就绪则接口返回成功。
+
+#### 存活检测[](https://dubbo.apache.org/zh/docs/references/lifecycle/brief/#%E5%AD%98%E6%B4%BB%E6%A3%80%E6%B5%8B)
+
+对于 livenessProbe 存活检测，由于 Dubbo 框架本身无法获取到应用的存活状态，因此本接口无默认实现，且默认返回成功。开发者可以根据 SPI 定义对此 SPI 接口进行拓展，从应用层次对是否存活进行判断。
+
+#### 就绪检测[](https://dubbo.apache.org/zh/docs/references/lifecycle/brief/#%E5%B0%B1%E7%BB%AA%E6%A3%80%E6%B5%8B)
+
+对于 readinessProbe 就绪检测，目前 Dubbo 默认提供了两个检测维度，一是对 Dubbo 服务自身是否启停做判断，另外是对所有服务是否存在已注册接口，如果所有服务均已从注册中心下线（可以通过 QOS 运维进行操作）将返回未就绪的状态。
+
+#### 启动检测[](https://dubbo.apache.org/zh/docs/references/lifecycle/brief/#%E5%90%AF%E5%8A%A8%E6%A3%80%E6%B5%8B)
+
+对于 startupProbe 启动检测，目前Dubbo 默认提供了一个检测维度，即是在所有启动流程（接口暴露、注册中心写入等）均结束后返回已就绪状态。
+
+
+关于 [liveness 存活探针](https://dubbo.apache.org/zh/docs/references/lifecycle/liveness/) 扩展示例
+
+关于 [readiness 就绪探针](https://dubbo.apache.org/zh/docs/references/lifecycle/readiness/) 扩展示例
+
+关于 [startup 启动探针](https://dubbo.apache.org/zh/docs/references/lifecycle/startup/) 扩展示例
+
+## 使用场景
+
+ 
+## 使用方式：
+  步骤一：需要先配置 `参考示例`，保证 Kubernetes 集群的 Pod 健康检查。
+  
+  步骤二：为了使 Kubernetes 集群能够正常访问到探针，需要开启 QOS 允许远程访问，此操作有可能带来安全风险，请仔细评估后再打开。
+#### 说明：
+ QOS 当计算节点检测到内存压力时，kuberentes 会 BestEffort -> Burstable -> Guaranteed 依次驱逐 Pod
+
+### 参考示例
+```yaml
+livenessProbe:
+  httpGet:
+    path: /live
+    port: 22222
+  initialDelaySeconds: 5
+  periodSeconds: 5
+readinessProbe:
+  httpGet:
+    path: /ready
+    port: 22222
+  initialDelaySeconds: 5
+  periodSeconds: 5
+startupProbe:
+  httpGet:
+    path: /startup
+    port: 22222
+  failureThreshold: 30
+  periodSeconds: 10
+```
+目前三种探针均有对应的接口，路径为 QOS 中的命令，端口信息请根据 QOS 配置进行对应修改（默认端口为 22222）。其他参数请参考[Kubernetes官方文档说明](https://kubernetes.io/zh/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/)。