This is an automated email from the ASF dual-hosted git repository.
liujun 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 8b1dd8c278b fix doc
8b1dd8c278b is described below
commit 8b1dd8c278bbadd4f9e8a31ee346350cc9c595c2
Author: chickenlj <[email protected]>
AuthorDate: Tue Sep 17 22:39:46 2024 +0800
fix doc
---
.../mannual/java-sdk/quick-start/deploy.md | 4 +--
.../serialization/serialization-upgrade.md | 3 ---
.../mannual/java-sdk/tasks/develop/springboot.md | 10 +++++---
.../mannual/java-sdk/tasks/protocols/dubbo.md | 4 +--
.../mannual/java-sdk/tasks/protocols/protocol.md | 4 ++-
.../zh-cn/overview/reference/integrations/nacos.md | 30 +++++++++++++++++++---
layouts/shortcodes/blocks/cover.html | 2 +-
7 files changed, 41 insertions(+), 16 deletions(-)
diff --git a/content/zh-cn/overview/mannual/java-sdk/quick-start/deploy.md
b/content/zh-cn/overview/mannual/java-sdk/quick-start/deploy.md
index d6a7701b5f2..690abe8a505 100644
--- a/content/zh-cn/overview/mannual/java-sdk/quick-start/deploy.md
+++ b/content/zh-cn/overview/mannual/java-sdk/quick-start/deploy.md
@@ -17,7 +17,7 @@ weight: 3
{{% /alert %}}
## 部署应用
-我们为您提前准备好了示例项目的镜像与部署文件，您可以使用如下命令将示例快速部署到 Kubernetes 集群：
+我们为您提前准备好了示例项目的镜像与部署文件，您可以使用如下命令将示例快速部署到 Kubernetes 集群（请确保在示例源码根目录执行如下命令）：
```shell
kubectl apply -f ./Kubernetes-manifests.yaml
@@ -52,7 +52,7 @@ kubectl get services -n dubbo-quickstart
执行以下命令进行本地端口映射：
```shell
-kubectl port-forward <pod-name> 50051:50051
+kubectl port-forward <pod-name> 50051:50051 -n dubbo-quickstart
```
通过 curl 访问服务：
diff --git
a/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/serialization-upgrade.md
b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/serialization-upgrade.md
index bfdb578304f..e0a6ff67eb6 100644
---
a/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/serialization-upgrade.md
+++
b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/serialization-upgrade.md
@@ -11,9 +11,6 @@ weight: 5
---
-
-
-
在 `3.1.0` 版本中，Dubbo 默认支持的序列化协议新增对 Fastjson2
的支持。部分用户可能会考虑在现有的系统中对序列化协议进行升级，但服务端和客户端版本的差异可能导致客户端并不支持服务端的序列化协议。
在 `3.2.0` 版本中, Dubbo 的服务端引入新的配置
`prefer-serialization`，该特性可以完美解决服务端序列化升级过程中可能带来的风险。
diff --git
a/content/zh-cn/overview/mannual/java-sdk/tasks/develop/springboot.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/develop/springboot.md
index 76b70cb3319..fef4ea085df 100644
--- a/content/zh-cn/overview/mannual/java-sdk/tasks/develop/springboot.md
+++ b/content/zh-cn/overview/mannual/java-sdk/tasks/develop/springboot.md
@@ -9,11 +9,15 @@ weight: 1
Dubbo 提供了对 Spring 框架的完整支持，我们推荐使用官方提供的 `dubbo-spring-boot-starter` 高效开发 Dubbo
微服务应用。
## 创建项目
-创建 Dubbo 应用最快捷的方式就是使用官方项目脚手架工具 - <a href="https://start.dubbo.apache.org";
target="_blank">start.dubbo.apache.org</a> 在线服务。它可以帮助开发者创建 Spring Boot
结构应用，自动管理 `dubbo-spring-boot-starter` 等依赖和必要配置。
+创建 Dubbo 应用最快捷的方式就是直接复制快速开始中的示例并进行定制化修改。
+
+另一种更灵活的方式是使用官方项目脚手架工具 - <a href="https://start.dubbo.apache.org";
target="_blank">start.dubbo.apache.org</a> 在线服务。它可以帮助开发者创建 Spring Boot
结构应用，根据用户的选择自动管理 `dubbo-spring-boot-starter` 等依赖和必要配置。
<img style="max-width:800px;height:auto;margin-bottom:10px;" alt="项目结构截图"
src="/imgs/v3/quickstart/start.jpg"/>
+{{% alert title="注意" color="info" %}}
另外，Jetbrain 官方也提供了 Apache Dubbo 项目插件，可用于快速创建 Dubbo Spring Boot 项目，能力与
start.dubbo.apache.org 对等，具体安装使用请查看
[博客文章](/zh-cn/blog/2023/10/23/intellij-idea%EF%B8%8Fapache-dubboidea官方插件正式发布/)
+{{% /alert %}}
## dubbo-spring-boot-starter
在 [快速开始](/zh-cn/overview/mannual/java-sdk/quick-start/) 中，我们已经详细介绍了典型的 Dubbo
Spring Boot 工程源码及其项目结构，不熟悉的开发者可以前往查看。
@@ -52,7 +56,7 @@ Dubbo 提供了对 Spring 框架的完整支持，我们推荐使用官方提供
</dependencies>
```
-`dubbo-spring-boot-starter` 和 `dubbo-zookeeper-spring-boot-starter` 是官方提供的
starter，提供了 Spring Boot 的集成适配，它们的版本号与 Dubbbo 主框架版本号完全一致。
+`dubbo-spring-boot-starter` 和 `dubbo-zookeeper-spring-boot-starter` 是官方提供的
starter，提供了 Spring Boot 的集成适配，它们的版本号与 Dubbbo 主框架版本号完全一致。Dubbo 还支持
`dubbo-nacos-spring-boot-starter` 等 starter，具体可查看参见 [starter
列表](overview/mannual/java-sdk/reference-manual/config/spring/spring-boot/#starter列表)。
### application.yml 配置文件
以下是一个示例文件配置
@@ -69,7 +73,7 @@ dubbo:
address: zookeeper://127.0.0.1:2181
```
-除 service、reference 之外的组件都可以在 application.yml 文件中设置，具体可参考
[配置列表](/zh-cn/overview/mannual/java-sdk/reference-manual/config/spring/spring-boot/#applicationyaml)。
+除 service、reference 之外的组件都可以在 application.yml 文件中设置，具体可参考
[配置列表](overview/mannual/java-sdk/reference-manual/config/spring/spring-boot/#applicationyaml)。
service、reference 组件也可以通过 `id` 与 application 中的全局组件做关联，以下面配置为例。如果要扩展 service 或
reference 的注解配置，则需要增加 `dubbo.properties` 配置文件或使用其他非注解如 Java Config 方式，具体请看下文
[扩展注解的配置](#扩展注解配置)。
diff --git a/content/zh-cn/overview/mannual/java-sdk/tasks/protocols/dubbo.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/protocols/dubbo.md
index 057591a935f..58972868728 100644
--- a/content/zh-cn/overview/mannual/java-sdk/tasks/protocols/dubbo.md
+++ b/content/zh-cn/overview/mannual/java-sdk/tasks/protocols/dubbo.md
@@ -107,9 +107,9 @@ dubbo:
```
{{% alert title="注意" color="info" %}}
-自 3.2.0 版本开始，Dubbo 增加了序列化协议的自动协商机制，如果满足条件 `两端都为 Dubbo3 特定版本 + 存在 Fastjson2
相关依赖`，则会自动使用 fastjson2 序列化协议，否则使用 hessian2 协议，协商对用户透明无感。
+自 3.2.0 版本开始，Dubbo 增加了
[序列化协议的自动协商机制](overview/mannual/java-sdk/reference-manual/serialization/serialization/#切换序列化协议)，如果满足条件
`两端都为 Dubbo3 特定版本 + 存在 fastjson2 相关依赖 + 配置了
prefer-serialization=fastjson2`，则框架会自动优先尝试使用 fastjson2
序列化协议，如有任一一端由于各种原因不支持，则继续使用默认的 hessian2 序列化。
-由于 Dubbo2 默认序列化协议是
hessian2，对于部分有拦截rpc调用payload的场景，比如sidecar等对链路payload有拦截与解析，在升级过程中需留意兼容性问题，其他用户不用担心。
+由于 Dubbo2 默认序列化协议是
hessian2，对于部分有拦截rpc调用payload的场景，比如sidecar等对链路payload有拦截与解析，在升级过程中需留意兼容性问题。
{{% /alert %}}
### 共享连接
diff --git
a/content/zh-cn/overview/mannual/java-sdk/tasks/protocols/protocol.md
b/content/zh-cn/overview/mannual/java-sdk/tasks/protocols/protocol.md
index 40a7e7a3ec5..1acc48749e1 100755
--- a/content/zh-cn/overview/mannual/java-sdk/tasks/protocols/protocol.md
+++ b/content/zh-cn/overview/mannual/java-sdk/tasks/protocols/protocol.md
@@ -36,7 +36,7 @@ Dubbo 作为一款 RPC 框架内置了高效的 RPC 通信协议，帮助解决
| **rest** | tri 或 rest | - Java Interface + SpringMVC <br/> - Java Interface
+ JAX-RS | 50051 | HTTP/1、HTTP/2 | JSON | 否 |
{{% alert title="注意" color="info" %}}
- 考虑到对过往版本的兼容性，当前 Dubbo 各个发行版本均默认使用 `dubbo` 通信协议。**对于新用户而言，我们强烈建议在一开始就明确配置使用
`triple` 协议**，老用户也尽快参考文档
[实现协议的平滑迁移](/zh-cn/overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/migration/)。
+ 考虑到对过往版本的兼容性，当前 Dubbo 各个发行版本均默认使用 `dubbo` 通信协议。**对于新用户而言，我们强烈建议在一开始就明确配置使用
`triple` 协议**。老用户也尽快参考文档
[实现协议的平滑迁移](overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/migration-triple/)。
{{% /alert %}}
接下来，我们一起看以下几个协议的基本使用方式。
@@ -248,3 +248,5 @@ dubbo:
name: dubbo
ext-protocol: tri
```
+
+
如果想了解更多多协议使用方法，[参考手册](overview/mannual/java-sdk/reference-manual/protocol/multi-protocols/)
和
[协议迁移指南](overview/mannual/java-sdk/reference-manual/upgrades-and-compatibility/migration-triple/)
中有关于多协议的更多示例说明。
diff --git a/content/zh-cn/overview/reference/integrations/nacos.md
b/content/zh-cn/overview/reference/integrations/nacos.md
index 2c8012f3c9e..354449fea93 100644
--- a/content/zh-cn/overview/reference/integrations/nacos.md
+++ b/content/zh-cn/overview/reference/integrations/nacos.md
@@ -14,7 +14,7 @@ weight: 5
Nacos 依赖 <a href="https://sdkman.io/"; target="_blank">Java 环境</a> 来运行，目前支持
Linux、MacOS、Windows 等环境。
-您可以 <a href="https://github.com/alibaba/nacos/releases";
target="_blank">下载最新稳定版本 Nacos</a>，解压缩二进制包：
+您可以 <a href="https://nacos.io/download/nacos-server/"; target="_blank">下载最新稳定版本
Nacos</a>，解压缩二进制包：
```shell
unzip nacos-server-$version.zip
@@ -39,12 +39,34 @@ startup.cmd -m standalone
通过浏览器访问以下链接打开控制台：http://127.0.0.1:8848/nacos/
## docker
-使用 docker 启动 nacos，请首先确保您已经在本地机器正确 <a
href="https://docs.docker.com/engine/install/"; target="_blank">下载页面</a> 安装
docker</a>。
+下载 nacos-docker 项目。
```shell
-docker run --name nacos-quick -e MODE=standalone -p 8849:8848 -d
nacos/nacos-server:2.3.1
+git clone https://github.com/nacos-group/nacos-docker.git
+cd nacos-docker
+```
+
+执行 docker-compose 命令启动Nacos。
+
+```shell
+docker-compose -f example/standalone-derby.yaml up
```
## kubernetes
-请参考 <a
href="https://github.com/nacos-group/nacos-k8s/blob/master/operator/README-CN.md";
target="_blank">nacos-operator</a> 了解如何部署 Nacos 到 Kubernetes 集群。
+下载 nacos-k8s 项目
+
+```shell
+git clone https://github.com/nacos-group/nacos-k8s.git
+cd nacos-k8s
+```
+
+快速启动（注意：使用此方式快速启动,请注意这是没有使用持久化卷的,可能存在数据丢失风险）
+
+```shell
+cd nacos-k8s
+chmod +x quick-startup.sh
+./quick-startup.sh
+```
+
+请参考 <a href="https://nacos.io/docs/latest/quickstart/quick-start-kubernetes/";
target="_blank">nacos-operator</a> 了解如何部署 Nacos 到 Kubernetes 集群。
diff --git a/layouts/shortcodes/blocks/cover.html
b/layouts/shortcodes/blocks/cover.html
index fc265ca673b..7938f491c54 100644
--- a/layouts/shortcodes/blocks/cover.html
+++ b/layouts/shortcodes/blocks/cover.html
@@ -161,7 +161,7 @@
</div>
</div> -->
<div class="btn-group homepage-btn-group">
- <a class="btn btn-secondary btn-lg mb-4 " href="overview/quickstart/">
+ <a class="btn btn-secondary btn-lg mb-4 "
href="overview/mannual/java-sdk/quick-start/starter/">
{{ T "homepage_button_2" }}
</a>
<a class="btn btn-lg homepage-btn-base mb-4 " href="overview/demo/">
