This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch cn-site
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/cn-site by this push:
new 568799e1f7 deploy: a91c5690052223f403f680f80234cdee426c179f
568799e1f7 is described below
commit 568799e1f743efc3e7c6f364a32071a9163fff10
Author: AlbumenJ <[email protected]>
AuthorDate: Wed Jun 28 12:13:10 2023 +0000
deploy: a91c5690052223f403f680f80234cdee426c179f
---
sitemap.xml | 2 +-
.../upgrades-and-compatibility/service-discovery/index.xml | 8 +++++---
.../service-discovery/migration-service-discovery/index.html | 9 ++++-----
zh-cn/sitemap.xml | 2 +-
4 files changed, 11 insertions(+), 10 deletions(-)
diff --git a/sitemap.xml b/sitemap.xml
index 8178042a6b..5c6744da8c 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";><sitemap><loc>https://cn.dubbo.apache.org/zh-cn/sitemap.xml</loc><lastmod>2023-06-28T20:07:56+08:00</lastmod></sitemap><sitemap><loc>https://cn.dubbo.apache.org/en/sitemap.xml</loc><lastmod>2023-05-10T11:59:30+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";><sitemap><loc>https://cn.dubbo.apache.org/zh-cn/sitemap.xml</loc><lastmod>2023-06-28T20:08:09+08:00</lastmod></sitemap><sitemap><loc>https://cn.dubbo.apache.org/en/sitemap.xml</loc><lastmod>2023-05-10T11:59:30+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
diff --git
a/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/index.xml
b/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/index.xml
index cec9c7ad47..7f0fd9ec95 100644
---
a/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/index.xml
+++
b/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/index.xml
@@ -58,8 +58,10 @@ FORCE_APPLICATION：仅应用级订阅，将只采用全新的服务发现模型
</blockquote>
<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-java" data-lang="java"><span
style="display:flex;"><span>step: FORCE_INTERFACE
</span></span></code></pre></div></description></item><item><title>Overview:
接口级服务发现迁移至应用级服务发现指南</title><link>https://cn.dubbo.apache.org/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery/</guid><description>
-<p><strong>总体上来说，在地址注册与发现环节，3.x 是完全兼容 2.x
版本的，这意味着，用户可以选择将集群内任意数量的应用或机器升级到 3.x，同时在这个过程中保持与 2.x 版本的互操作性。</strong>
-如关心迁移背后工作原理，请参考 <a
href="../service-discovery-rule">迁移规则详情与工作原理</a></p>
+<p>总体上来说，在地址注册与发现环节，<code>3.x</code> 是完全兼容 <code>2.x</code>
版本的，这意味着，用户可以选择将集群内任意数量的应用或机器升级到 <code>3.x</code>，同时在这个过程中保持与
<code>2.x</code> 版本的互操作性。</p>
+<blockquote>
+<p>如关心迁移背后工作原理，请参考 <a
href="../service-discovery-rule">迁移规则详情与工作原理</a></p>
+</blockquote>
<h2 id="1-快速升级步骤">1 快速升级步骤</h2>
<p>简单的修改 pom.xml 到最新版本就可以完成升级，如果要迁移到应用级地址，只需要调整开关控制 3.x 版本的默认行为。</p>
<ol>
@@ -126,7 +128,7 @@ FORCE_APPLICATION：仅应用级订阅，将只采用全新的服务发现模型
</span></span><span style="display:flex;"><span> - <span
style="color:#268bd2">serviceKey</span>:
org.apache.dubbo.config.api.DemoService:1.0.0
</span></span><span style="display:flex;"><span> <span
style="color:#268bd2">step</span>: FORCE_INTERFACE
</span></span></code></pre></div><p>使用这种方式能做到比较精细迁移控制，但是当下及后续的改造成本会比较高，除了一些特别场景，我们不太推荐启用这种配置方式。
-(<a href="../service-discovery-rule/">迁移指南</a>)
<strong>官方推荐使用的全局的开关式的迁移策略，让消费端实例在启动阶段自行决策使用哪份可用的地址列表。</strong></p>
+<a
href="../service-discovery-rule/">迁移指南</a>官方推荐使用的全局的开关式的迁移策略，让消费端实例在启动阶段自行决策使用哪份可用的地址列表。</p>
<h2 id="4-迁移状态的收敛">4 迁移状态的收敛</h2>
<p>为了同时兼容 2.x 版本，升级到 3.x 版本的应用在一段时间内要么处在双注册状态，要么处在双订阅状态。</p>
<p>解决这个问题，我们还是从 Provider 视角来看，当所有的 Provider
都切换到应用级地址注册之后，也就不存在双订阅的问题了。</p>
diff --git
a/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery/index.html
b/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery/index.html
index abf7a09dc5..e1413df07a 100644
---
a/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery/index.html
+++
b/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery/index.html
@@ -1,4 +1,4 @@
-<!doctype html><html lang=zh-cn class=no-js><head><meta name=ROBOTS
content="INDEX, FOLLOW"><link rel=canonical
href=https://cn.dubbo.apache.org/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery/><script>var
_hmt=_hmt||[];(function(){var
e,t=document.createElement("script");t.src="https://hm.baidu.com/hm.js?3b78f49ba47181e4d998a66b689446e9",e=document.getElementsByTagName("script")[0],e.parentNode.insertBefore(t,e)})()</script><meta
[...]
+<!doctype html><html lang=zh-cn class=no-js><head><meta name=ROBOTS
content="INDEX, FOLLOW"><link rel=canonical
href=https://cn.dubbo.apache.org/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery/><script>var
_hmt=_hmt||[];(function(){var
e,t=document.createElement("script");t.src="https://hm.baidu.com/hm.js?3b78f49ba47181e4d998a66b689446e9",e=document.getElementsByTagName("script")[0],e.parentNode.insertBefore(t,e)})()</script><meta
[...]
<script>var
doNotTrack=!1;if(!doNotTrack){window.dataLayer=window.dataLayer||[];function
gtag(){dataLayer.push(arguments)}gtag("js",new
Date),gtag("config","G-NM6FFMT51J",{anonymize_ip:!1})}</script><link
rel=preload
href=/scss/main.min.827bbd3e83b1e0c66a1c08738c713f88f8068e84600146c2dbf9035f0f496f01.css
as=style><link
href=/scss/main.min.827bbd3e83b1e0c66a1c08738c713f88f8068e84600146c2dbf9035f0f496f01.css
rel=stylesheet integrity><script src=/js/jquery-3.5.1.min.js
integrity="sha256-9/a [...]
<link rel=stylesheet href=https://cdn.jsdelivr.net/npm/@docsearch/css@3><meta
name=theme-color content="#326ce5"><link rel=stylesheet
href=/css/feature-states.css><meta name=description content="本文档专门针对使用 2.x
版本的老用户，详细阐述了升级到 3.x 后的默认地址注册与发现行为、如何平滑的迁移到新版本的地址模型。"><meta
property="og:description" content="本文档专门针对使用 2.x 版本的老用户，详细阐述了升级到 3.x
后的默认地址注册与发现行为、如何平滑的迁移到新版本的地址模型。"><meta name=twitter:description
content="本文档专门针对使用 2.x 版本的老用户，详细阐述了升级到 3.x
后的默认地址注册与发现行为、如何平滑的迁移到新版本的地址模型。"><meta property= [...]
<link href=/css/community.css rel=stylesheet><link href=/css/contactus.css
rel=stylesheet><link href=/css/language.css rel=stylesheet><script
src=/js/script.js></script></head><body class="td-page
td-documentation"><header><nav class="js-navbar-scroll navbar navbar-expand
navbar-dark flex-column flex-md-row td-navbar" data-auto-burger=primary><a
class=navbar-brand href=/zh-cn/><span class=navbar-logo></span><span
class="text-uppercase font-weight-bold">Apache Dubbo</span></a><div class="
[...]
@@ -670,8 +670,7 @@
<label for=m-zh-cnoverviewreferenceprotocols-check><a
href=/zh-cn/overview/reference/protocols/ class="align-left pl-0
td-sidebar-link td-sidebar-link__section"
id=m-zh-cnoverviewreferenceprotocols><span>协议规范</span></a></label><ul
class="ul-3 foldable"><li class="td-sidebar-nav__section-title
td-sidebar-nav__section without-child"
id=m-zh-cnoverviewreferenceprotocolstriple-li><input type=checkbox
id=m-zh-cnoverviewreferenceprotocolstriple-check>
<label for=m-zh-cnoverviewreferenceprotocolstriple-check><a
href=/zh-cn/overview/reference/protocols/triple/ title="Triple 协议设计理念与规范"
class="align-left pl-0 td-sidebar-link td-sidebar-link__page"
id=m-zh-cnoverviewreferenceprotocolstriple><span>Triple
协议规范</span></a></label></li><li class="td-sidebar-nav__section-title
td-sidebar-nav__section without-child"
id=m-zh-cnoverviewreferenceprotocolstcp-li><input type=checkbox
id=m-zh-cnoverviewreferenceprotocolstcp-check>
<label for=m-zh-cnoverviewreferenceprotocolstcp-check><a
href=/zh-cn/overview/reference/protocols/tcp/ class="align-left pl-0
td-sidebar-link td-sidebar-link__page"
id=m-zh-cnoverviewreferenceprotocolstcp><span>Dubbo2
协议规范</span></a></label></li><li class="td-sidebar-nav__section-title
td-sidebar-nav__section without-child"
id=m-zh-cnoverviewreferenceprotocolshttp-li><input type=checkbox
id=m-zh-cnoverviewreferenceprotocolshttp-check>
-<label for=m-zh-cnoverviewreferenceprotocolshttp-check><a
href=/zh-cn/overview/reference/protocols/http/ class="align-left pl-0
td-sidebar-link td-sidebar-link__page"
id=m-zh-cnoverviewreferenceprotocolshttp><span>HTTP
协议规范</span></a></label></li></ul></li></ul></li></ul></li></ul></nav></div></div><main
class="col-12 col-md-9 col-xl-8 pl-md-5" role=main><nav aria-label=breadcrumb
class=td-breadcrumbs><ol class=breadcrumb><li class=breadcrumb-item><a
href=https://cn.dubbo.apache.org/zh-c [...]
-如关心迁移背后工作原理，请参考 <a href=../service-discovery-rule>迁移规则详情与工作原理</a></p><h2
id=1-快速升级步骤>1 快速升级步骤</h2><p>简单的修改 pom.xml 到最新版本就可以完成升级，如果要迁移到应用级地址，只需要调整开关控制
3.x 版本的默认行为。</p><ol><li>升级 Provider 应用到最新 3.x
版本依赖，配置双注册开关<code>dubbo.application.register-mode=all</code>（建议通过全局配置中心设置，默认已自动开启），完成应用发布。</li><li>升级
Consumer 应用到最新 3.x
版本依赖，配置双订阅开关<code>dubbo.application.service-discovery.migration=APPLICATION_FIRST</code>（建议通过全局配置中心设置，默认已自动开启），完成应用发布。</li><li>在确认
Provider 的上有 Consumer 全部完成应用级地址迁移后，Provider [...]
+<label for=m-zh-cnoverviewreferenceprotocolshttp-check><a
href=/zh-cn/overview/reference/protocols/http/ class="align-left pl-0
td-sidebar-link td-sidebar-link__page"
id=m-zh-cnoverviewreferenceprotocolshttp><span>HTTP
协议规范</span></a></label></li></ul></li></ul></li></ul></li></ul></nav></div></div><main
class="col-12 col-md-9 col-xl-8 pl-md-5" role=main><nav aria-label=breadcrumb
class=td-breadcrumbs><ol class=breadcrumb><li class=breadcrumb-item><a
href=https://cn.dubbo.apache.org/zh-c [...]
</span></span><span style=display:flex><span># 可选值 interface、instance、all，默认是
all，即接口级地址、应用级地址都注册
</span></span></code></pre></div><p>另外，可以在配置中心修改全局默认行为，来控制所有 3.x
实例注册行为。其中，全局性开关的优先级低于 -D 参数。</p><p>为了保证平滑迁移，即升级到 3.x 的实例能同时被 2.x 与 3.x
的消费者实例发现，3.x 实例需要开启双注册；当所有上游的消费端都迁移到 3.x 的地址模型后，提供端就可以切换到 instance
模式（只注册应用级地址）。对于如何升级消费端到 3.x 请参见下一小节。</p><h3 id=21-双注册带来的资源消耗>2.1
双注册带来的资源消耗</h3><p>双注册不可避免的会带来额外的注册中心存储压力，但考虑到应用级地址发现模型的数据量在存储方面的极大优势，即使对于一些超大规模集群的用户而言，新增的数据量也并不会带来存储问题。总体来说，对于一个普通集群而言，数据增长可控制在之前数据总量的
1/100 ~ 1/1000</p><p>�
�一个中等规模的集群实例来说： 2000 实例、50个应用（500 个 Dubbo 接口，平均每个应用 10 个接口）。</p><p> [...]
</span></span><span style=display:flex><span># 可选值
@@ -687,9 +686,9 @@
</span></span><span style=display:flex><span> - <span
style=color:#268bd2>serviceKey</span>:
org.apache.dubbo.config.api.DemoService:1.0.0
</span></span><span style=display:flex><span> <span
style=color:#268bd2>step</span>: FORCE_INTERFACE
</span></span></code></pre></div><p>使用这种方式能做到比较精细迁移控制，但是当下及后续的改造成本会比较高，除了一些特别场景，我们不太推荐启用这种配置方式。
-(<a href=../service-discovery-rule/>迁移指南</a>)
<strong>官方推荐使用的全局的开关式的迁移策略，让消费端实例在启动阶段自行决策使用哪份可用的地址列表。</strong></p><h2
id=4-迁移状态的收敛>4 迁移状态的收敛</h2><p>为了同时兼容 2.x 版本，升级到 3.x
版本的应用在一段时间内要么处在双注册状态，要么处在双订阅状态。</p><p>解决这个问题，我们还是从 Provider 视角来看，当所有的 Provider
都切换到应用级地址注册之后，也就不存在双订阅的问题了。</p><h3 id=41-不同的升级策略影响很大>4.1
不同的升级策略影响很大</h3><p>毫无疑问越早越彻底的升级，就能尽快摆脱这个局面。设想，如果可以将组织内所有的应用都升级到 3.x
版本，则版本收敛就变的非常简单：升级过程中 Provider 始终保持双注册，当所有的应用都升级到 3.x 之后，就可以调整全局默认行为，让 P
rovider 都变成应用级地址单注册了，这个过程并不会给 Consumer 应用带来困扰，因 [...]
+<a
href=../service-discovery-rule/>迁移指南</a>官方推荐使用的全局的开关式的迁移策略，让消费端实例在启动阶段自行决策使用哪份可用的地址列表。</p><h2
id=4-迁移状态的收敛>4 迁移状态的收敛</h2><p>为了同时兼容 2.x 版本，升级到 3.x
版本的应用在一段时间内要么处在双注册状态，要么处在双订阅状态。</p><p>解决这个问题，我们还是从 Provider 视角来看，当所有的 Provider
都切换到应用级地址注册之后，也就不存在双订阅的问题了。</p><h3 id=41-不同的升级策略影响很大>4.1
不同的升级策略影响很大</h3><p>毫无疑问越早越彻底的升级，就能尽快摆脱这个局面。设想，如果可以将组织内所有的应用都升级到 3.x
版本，则版本收敛就变的非常简单：升级过程中 Provider 始终保持双注册，当所有的应用都升级到 3.x 之后，就可以调整全局默认行为，让 Provider
都变成应
用级地址单注册了，这个过程并不会给 Consumer 应用带来困扰，因为它们已经是可以识别应用级地址的 3.x [...]
在这种情况下，我们追求的只能是尽量保持已升级应用的上下游实现版本及功能收敛。推动某些 Provider 的上游消费者都升级到
Dubbo3，这样就可以解除这部分 Provider
的双注册，要做到这一点，可能需要一些辅助统计工具的支持。</p><ol><li>要能分析出应用间的依赖关系，比如一个 Provdier
应用被哪些消费端应用消费，这可以通过 Dubbo 提供的服务元数据上报能力来实现。</li><li>要能知道每个应用当前使用的 dubbo
版本，可以通过扫描或者主动上报手段。</li></ol><div id=pre-footer><h2>反馈</h2><p
class=feedback--prompt>此页是否对您有帮助？</p><button class="btn btn-primary mb-4
feedback--yes">是</button>
-<button class="btn btn-primary mb-4
feedback--no">否</button></div><script>const
yes=document.querySelector(".feedback--yes"),no=document.querySelector(".feedback--no");document.querySelectorAll(".feedback--link").forEach(e=>{e.href=e.href+window.location.pathname});const
sendFeedback=e=>{gtag||console.log("!gtag"),gtag("event","click",{event_category:"Helpful",event_label:window.location.pathname,value:e})},disableButtons=()=>{yes.disabled=!0,yes.classList.add("feedback--button__disabled
[...]
+<button class="btn btn-primary mb-4
feedback--no">否</button></div><script>const
yes=document.querySelector(".feedback--yes"),no=document.querySelector(".feedback--no");document.querySelectorAll(".feedback--link").forEach(e=>{e.href=e.href+window.location.pathname});const
sendFeedback=e=>{gtag||console.log("!gtag"),gtag("event","click",{event_category:"Helpful",event_label:window.location.pathname,value:e})},disableButtons=()=>{yes.disabled=!0,yes.classList.add("feedback--button__disabled
[...]
<a
href="https://github.com/apache/dubbo-website/new/master/content/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/service-discovery/migration-service-discovery.md?filename=change-me.md&value=---%0Atitle%3A+%22Long+Page+Title%22%0AlinkTitle%3A+%22Short+Nav+Title%22%0Aweight%3A+100%0Adescription%3A+%3E-%0A+++++Page+description+for+heading+and+indexes.%0A---%0A%0A%23%23+Heading%0A%0AEdit+this+template+to+create+your+new+page.%0A%0A%2A+Give+it+a+good+name%2C+ending+in+%60.md
[...]
<a
href="https://github.com/apache/dubbo-website/issues/new?title=%e6%8e%a5%e5%8f%a3%e7%ba%a7%e6%9c%8d%e5%8a%a1%e5%8f%91%e7%8e%b0%e8%bf%81%e7%a7%bb%e8%87%b3%e5%ba%94%e7%94%a8%e7%ba%a7%e6%9c%8d%e5%8a%a1%e5%8f%91%e7%8e%b0%e6%8c%87%e5%8d%97";
target=_blank><i class="fab fa-github fa-fw"></i> 登记问题</a>
<a href=https://github.com/apache/dubbo/issues/new target=_blank><i class="fas
fa-tasks fa-fw"></i> 提交项目问题</a></div></main><div class="d-none d-xl-block
col-xl-2 td-toc d-print-none"><nav id=TableOfContents><ul><li><a
href=#1-快速升级步骤>1 快速升级步骤</a></li><li><a href=#2-provider-端升级过程详解>2 Provider
端升级过程详解</a><ul><li><a href=#21-双注册带来的资源消耗>2.1
双注册带来的资源消耗</a></li></ul></li><li><a href=#3-consumer-端升级过程>3 Consumer
端升级过程</a><ul><li><a href=#31-双订阅带来的资源消耗>3.1 双订阅带来的资源消耗</a></li><li><a
href=#32-消费端更 [...]
diff --git a/zh-cn/sitemap.xml b/zh-cn/sitemap.xml
index 6a5915ed1b..dd979dd212 100644
--- a/zh-cn/sitemap.xml
+++ b/zh-cn/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";
xmlns:xhtml="http://www.w3.org/1999/xhtml";><url><loc>https://cn.dubbo.apache.org/zh-cn/blog/2023/01/16/%E9%98%BF%E9%87%8C%E5%B7%B4%E5%B7%B4%E5%8D%87%E7%BA%A7-dubbo3-%E5%85%A8%E9%9D%A2%E5%8F%96%E4%BB%A3-hsf2/</loc><lastmod>2023-02-22T15:03:22+08:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://cn.dubbo.apache.org/zh-cn/overview/mannu
[...]
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";
xmlns:xhtml="http://www.w3.org/1999/xhtml";><url><loc>https://cn.dubbo.apache.org/zh-cn/blog/2023/01/16/%E9%98%BF%E9%87%8C%E5%B7%B4%E5%B7%B4%E5%8D%87%E7%BA%A7-dubbo3-%E5%85%A8%E9%9D%A2%E5%8F%96%E4%BB%A3-hsf2/</loc><lastmod>2023-02-22T15:03:22+08:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://cn.dubbo.apache.org/zh-cn/overview/mannu
[...]
\ No newline at end of file
