docs/upgrade docs to 1.18.0 (#379)

content/zh-cn/docs/使用指南/k8s和网格代理/Envoy网格接入.md

@@ -59,7 +59,8 @@ bookinfo          Active   3d2h   enabled
 ### 启用 Envoy 按需加载机制
 
 {{< note >}}
-需北极星服务端版本 >= 1.18.0
+- polaris-server 需要 >= 1.18.0-beta 版本
+- polaris-controller 需要 >= 1.7.0-beta 版本
 {{</ note >}}
 
 在 POD 中添加以下 annonations **sidecar.polarismesh.cn/openOnDemand: true** 即可启用 Envoy 的按需加载
@@ -131,9 +132,9 @@ demo 项目中，productpage 会访问 reviews 服务，reviews 服务共有三
 
 路由规则的标签填写格式要求：
 
-- 对于Path：标签KEY需要填写$path
-- 对于Header：标签KEY需要带上前缀$header，如$header.end-user
-- 对于Query：标签KEY需要带上前缀$query，如$query.end-user
+- 对于Path：标签KEY需要填写 **$path**
+- 对于Header：标签KEY需要带上前缀 **$header**，如 **$header.end-user**
+- 对于Query：标签KEY需要带上前缀 **$query**，如 **$query.end-user**
 
 3. 验证路由是否生效
 
@@ -144,16 +145,11 @@ demo 项目中，productpage 会访问 reviews 服务，reviews 服务共有三
 {{< note >}}
 - polaris-server 需要 >= 1.17.3 版本
 - polaris-controller 需要 >= 1.6.0 版本
-- 
+- 在envoy接入的场景中，受XDS协议的限制，当前限流标签仅支持以下两个。
+  - 请求头(HEADER)
+  - 请求参数(QUERY)
 {{< /note >}}
 
-北极星网格支持目前仅支持单机限流，同时直接细粒度的配额的设置。
-
-在envoy接入的场景中，受XDS协议的限制，当前限流标签仅支持以下两个。
-
-- 请求头(HEADER)
-- 请求参数(QUERY)
-
 ![](../images/envoy/分布式限流.png)
 
 1. 使用场景: demo项目中，为details服务设置流量限制，对于jason用户的请求，设置访问的频率为5/m，其余请求不做限制。

content/zh-cn/docs/使用指南/k8s和网格代理/k8s-配置同步.md

@@ -4,9 +4,7 @@ linkTitle: "K8s 配置同步（Beta）"
 weight: 3
 ---
 
-{{< notice tip >}} 
-- 该文章仅适用于北极星服务端版本 >= 1.18.0
-{{< /notice >}} 
+{{< notice tip >}} 该文章仅适用于北极星服务端版本 >= 1.18.0 {{< /notice >}} 
 
 支持两种 K8s ConfigMap 同步模式：
 

content/zh-cn/docs/参考文档/版本信息/release_1_18.0.md

@@ -15,6 +15,26 @@ weight: 1
 
 在 1.18.0-beta 版本中，社区正式将 **apiserver-nacos** 插件纳入官方默认插件，并完善了 **nacos1.x**/**nacos2.x** 的客户端功能特性兼容。用户无需替换自己的 **nacos-client** 依赖，只需更换接入地址即可接入北极星的注册发现以及配置管理。
 
+- nacos1.x
+  - 注册发现
+    - [x] 实例注册
+    - [x] 服务发现
+    - [x] 心跳上报
+    - [x] 基于 UDP 的服务端主动推送
+  - 配置管理
+    - [x] 配置发布
+    - [x] 配置查询
+    - [x] 配置监听
+- nacos2.x
+    - [x] 实例注册
+    - [x] 服务发现
+    - [x] 基于 gRPC 长连接的实例信息维护
+    - [x] 基于 gRPC 的服务端主动推送
+  - 配置管理
+    - [x] 配置发布
+    - [x] 配置查询
+    - [x] 配置监听
+
 ```yaml
 apiservers:
   - name: service-nacos
@@ -32,30 +52,55 @@ apiservers:
 
 #### 支持 Mesh Sidecar 场景下的 Cluster/Endpoint 按需加载
 
-Sidecar Mesh 场景下，每个 Sidecar 进程都会收到 XDS Server 推送下来的全量服务数据。假设一个 Workload-1 他仅仅调用了 Service-1/Service-2 两个服务，但是大部份的 XDS Server 都会将全量的 Service 推送给 Workload-1 的 Sidecar。这样子带来的后果就是每个 Sidecar 的内存、资源消耗会随着服务量级的增长而增长。
+Sidecar Mesh 场景下，每个 Sidecar 进程都会收到 xDS Server 推送下来的全量服务数据。假设一个 Workload-1 他仅仅调用了 Service-1/Service-2 两个服务，但是大部份的 xDS Server 都会将全量的 Service 推送给 Workload-1 的 Sidecar。这样子带来的后果就是每个 Sidecar 的内存、资源消耗会随着服务量级的增长而增长。
 
 ![](../images/release-v1.18/envoy-sideacr-xds-memory.png)
 
-为了解决上述问题。社区在 1.18.0-beta 版本中实现了 Envoy XDS 中的 [OCDS 能力](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/on_demand_updates_filter)。默认只推送全量的 VHDS 到 Sidecar 中，Cluster/Endpoint 资源根据实际请求进行按需加载。
+为了解决上述问题。社区在 1.18.0-beta 版本中实现了 Envoy xDS 中的 [OCDS 能力](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/on_demand_updates_filter)。默认只推送全量的 VHDS 到 Sidecar 中，Cluster/Endpoint 资源根据实际请求进行按需加载。
+
+同时我们也优化了服务端关于 xDS 规则生成的内存占用，不再使用 envoy go-control-plane 中的 SnapshotCache 实现，而是选择了 LinearCache，根据每类 xDS 资源的生成特点进行存放在不同的 LinearCache 中，尽可能将公共的 xDS 资源只生成一份，其余的需要按照 mtls、odcds 场景的规则则各自存在对应的 LinearCache 中。
 
 - 需要搭配 [polaris-controller v1.7.0-beta](https://github.com/polarismesh/polaris-controller/releases/tag/v1.7.0-beta) 版本一起使用
+- 由于当前 Envoy 的按需加载能力，当 On-Demand VHDS 和 On-Demand Cluster 同时启用时存在 BUG，因此目前仅实现了 On-Demand Cluster 的能力，待和 Envoy 社区推进解决该 BUG 后用户可享受真正的 Envoy 按需加载能力，[社区 issue](https://github.com/envoyproxy/envoy/issues/24726)
 
 #### 支持 Mesh Sidecar 场景下的分布式限流
 
 在 1.18.0-beta 版本中，我们针对 Mesh Sidecar 的场景，支持将 Polaris 的分布式限流通过由 Polaris-Sidecar 组件实现的 RLS 提供给 Envoy 的限流 Filter，使得用户在 Mesh 场景下可以享受 Polaris 的分布式限流能力
 
+![](../images/release-v1.18/envoy_rls.png)
+
 - 需要搭配 [polaris-controller v1.7.0-beta](https://github.com/polarismesh/polaris-controller/releases/tag/v1.7.0-beta) 版本一起使用
 
 #### 配置中心支持灰度发布
 
 为了让用户有更好的配置中心使用体验，社区在 v1.18.0-beta 版本中支持配置灰度能力，当前灰度能力支持用户自定义客户端标签进行灰度控制下发；针对存量老版本客户端仅支持根据客户端IP进行灰度控制台下发。
 
+![](../images/release-v1.18/config_beta_publish_op_2.png)
+
+> polaris-go 配置客户端标签
+
+```yaml
+global:
+  serverConnector:
+    addresses:
+      - 127.0.0.1:8091
+  client:
+    labels:
+      ${label_key}: ${label_value}
+```
+
+> polaris-java
+
+开发中...
+
+> 
+
 ## 版本变化
 
 ### 特性
 
-- [[PR #1175]](https://github.com/polarismesh/polaris/pull/1175) feat(xds): add OutlierDetection and HealthCheck
 - [[PR #1174]](https://github.com/polarismesh/polaris/pull/1174) feat:support push envoy rls filter xds
+- [[PR #1175]](https://github.com/polarismesh/polaris/pull/1175) feat(xds): add OutlierDetection and HealthCheck
 - [[PR #1215]](https://github.com/polarismesh/polaris/pull/1215) 服务端支持流量无损停机
 - [[PR #1237]](https://github.com/polarismesh/polaris/pull/1237) feat: allow empty db password
 - [[PR #1253]](https://github.com/polarismesh/polaris/pull/1253) feat:envoy ratelimit action suppoer all spec label & add hds feature
@@ -86,9 +131,9 @@ Sidecar Mesh 场景下，每个 Sidecar 进程都会收到 XDS Server 推送下
 - [[PR #1192]](https://github.com/polarismesh/polaris/pull/1192) 修复batchConfig批量注销实例配置问题
 - [[PR #1196]](https://github.com/polarismesh/polaris/pull/1196) 修复心跳上报写redis异常时未将异常结果返回问题
 - [[PR #1197]](https://github.com/polarismesh/polaris/pull/1208) 修复熔断/探测规则更新绑定服务信息后缓存遗留脏数据
+- [[PR #1201]](https://github.com/polarismesh/polaris/pull/1216) 修复 arm64 环境无法使用 docker image
 - [[PR #1212]](https://github.com/polarismesh/polaris/pull/1212) 修复清理软删除实例时没有同步清理 instance_metadata 以及 health_check 表的数据
 - [[PR #1213]](https://github.com/polarismesh/polaris/pull/1214) 修复xDS 生成 cacheKey 时缺失 gatewayService
-- [[PR #1201]](https://github.com/polarismesh/polaris/pull/1216) 修复 arm64 环境无法使用 docker image
 - [[PR #1233]](https://github.com/polarismesh/polaris/pull/1233) fix: Dockerfile 8761 port duplicate
 - [[PR #1240]](https://github.com/polarismesh/polaris/pull/1240) fix typo: firtstUpdate -> firstUpdate
 - [[PR #1273]](https://github.com/polarismesh/polaris/pull/1273) 解决配置中心标签 value 和 key 相同的问题