Skip to content

docs: update README for v3.3.2 tool releases #3597

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
AlexStocks wants to merge 1 commit into
base: develop
Choose a base branch
from
+36 −4
Open

docs: update README for v3.3.2 tool releases #3597

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@ You can visit [the official website](https://dubbo.apache.org/) for more informa

For detailed changes, refer to [CHANGELOG.md](CHANGELOG.md).

- **3.3.2**:
- **[3.3.2](https://github.com/apache/dubbo-go/releases/tag/v3.3.2)**:

***BREAKING CHANGE***: `config` package has been removed, please use modern `global` package, check [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) for usage instructions.
**Upgrade note:** Go 1.25 or later is required. The legacy `config` package has been removed; applications that imported it directly must migrate to the instance/options APIs and configuration types under `global`. See the [3.3.2 changelog](CHANGELOG.md#332) and [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) for migration details and current usage.
Comment thread
AlexStocks marked this conversation as resolved.

Apache Dubbo-go 3.3.2 is a production-readiness release focused on API consolidation, Triple protocol capabilities, application-level metadata, service governance, concurrency safety, and release tooling. It completes the removal of the legacy config package, expands generic invocation and HTTP-facing Triple features, refreshes generated-project workflows, and fixes multiple races, stale-snapshot issues, and resource leaks.

Expand All @@ -31,7 +31,7 @@ For detailed changes, refer to [CHANGELOG.md](CHANGELOG.md).

### Prerequisites

- Go 1.24 or later (recommended for compatibility with recent updates).
- Go 1.25 or later.

### Installation

Expand Down Expand Up @@ -125,6 +125,15 @@ Common development tools live in `tools/`.
| [dubbo-go-schema](./tools/dubbo-go-schema/README.md) | Provide JSON Schema completion and validation for dubbo-go YAML config. |
| [benchmark](./tools/benchmark/README.md) | Performance benchmark suite for comparing Dubbo-Go, Dubbo-Java, and gRPC frameworks. |

Prebuilt archives for Darwin, Linux, and Windows are available from GitHub Releases:

- [dubbogo-cli v1.0.1](https://github.com/apache/dubbo-go/releases/tag/tools/dubbogo-cli/v1.0.1)
- [protoc-gen-go-triple v3.3.2](https://github.com/apache/dubbo-go/releases/tag/tools/protoc-gen-go-triple/v3.3.2)
- [protoc-gen-triple-openapi v3.3.2](https://github.com/apache/dubbo-go/releases/tag/tools/protoc-gen-triple-openapi/v3.3.2)
- [imports-formatter v1.0.11](https://github.com/apache/dubbo-go/releases/tag/tools/imports-formatter/v1.0.11)

After installing `dubbogo-cli`, run `dubbogo-cli install all` to install the companion generators and formatter. Source installation commands are documented in each tool's README.

Comment on lines +128 to +136

@Alanxtl Alanxtl Aug 5, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这些不需要

## Ecosystem
- [dubbo-go-samples](https://github.com/apache/dubbo-go-samples)
- [dubbo-go-pixiu which acting as a proxy to solve Dubbo multi-language interoperability](https://github.com/apache/dubbo-go-pixiu)
Expand Down
25 changes: 24 additions & 1 deletion README_CN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,25 @@

您可以访问 [官网](https://dubbo.apache.org/) 以获取更多信息。

## 近期更新

详细变更请参阅 [CHANGELOG.md](CHANGELOG.md)。
Comment thread
AlexStocks marked this conversation as resolved.

- **[3.3.2](https://github.com/apache/dubbo-go/releases/tag/v3.3.2)**：

**升级提醒：** 需要 Go 1.25 或更高版本。旧版 `config` 包已被移除；直接导入该包的应用需要迁移到实例/选项 API 和 `global` 包下的配置类型。迁移说明和当前用法请参阅 [3.3.2 更新日志](CHANGELOG.md#332)及 [dubbo-go-samples](https://github.com/apache/dubbo-go-samples)。

Apache Dubbo-go 3.3.2 重点提升生产可用性，涵盖 API 整合、Triple 协议能力、应用级元数据、服务治理、并发安全和发布工具链。该版本扩展了泛化调用和面向 HTTP 的 Triple 能力，更新了项目生成流程，并修复了多项竞态、过期快照和资源泄漏问题。

- **3.3.1**：优化配置热加载，通过基于内容的缓存避免重复通知；新增实验性 HTTP/3 支持、Apollo 集成和 Triple 协议 OpenAPI 生成；修复高并发服务发现中的关键竞态问题。

- **3.3.0**：引入脚本路由、多目标条件路由、Triple 协议 keepalive 与连接池、Nacos 多类别订阅，并增强可观测性和互操作性。

## 快速开始

### 环境准备

* Go 1.24 或更高版本（建议使用最新版本以获得最佳性能与兼容性）。
* Go 1.25 或更高版本。

### 安装

Expand Down Expand Up @@ -111,6 +125,15 @@ func main() {
| [dubbo-go-schema](./tools/dubbo-go-schema/README_CN.md) | 为 dubbo-go YAML 配置提供 JSON Schema 补全与校验。 |
| [benchmark](./tools/benchmark/README_CN.md) | 对比 Dubbo-Go、Dubbo-Java 和 gRPC 框架性能的基准测试套件。 |

GitHub Releases 提供适用于 Darwin、Linux 和 Windows 的预编译压缩包：

- [dubbogo-cli v1.0.1](https://github.com/apache/dubbo-go/releases/tag/tools/dubbogo-cli/v1.0.1)
- [protoc-gen-go-triple v3.3.2](https://github.com/apache/dubbo-go/releases/tag/tools/protoc-gen-go-triple/v3.3.2)
- [protoc-gen-triple-openapi v3.3.2](https://github.com/apache/dubbo-go/releases/tag/tools/protoc-gen-triple-openapi/v3.3.2)
- [imports-formatter v1.0.11](https://github.com/apache/dubbo-go/releases/tag/tools/imports-formatter/v1.0.11)

安装 `dubbogo-cli` 后，可运行 `dubbogo-cli install all` 安装配套的代码生成器和格式化工具。各工具 README 中提供了从源码安装的命令。

## 生态系统

- [dubbo-go-samples](https://github.com/apache/dubbo-go-samples)
Expand Down
Loading