服务治理标准

English | 简体中文

---

README：

• 服务治理标准
  • 介绍
  • 服务治理标准
  • 服务治理接口
  • 如何构建
    • 如何使用

介绍

服务治理标准

北极星服务治理标准遵循下一代架构基金会所制定的服务治理标准，在此之上进行了扩展：

	Latest Release
Serivce Management Specification
namespace	v1
service	v1
logical service	logical service and environment binding
instance	v1
health check	v1
Traffic Mangement Specification
router	v1
load balancer	v1
limiter	v1
Fault Tolerance Specification
circuit breaker	v1
fault detector	v1
retry	v1
Access Control Specification
authentication	v1
anthorization	v1
AI Native Specification
mcp server	v1
Configuration Specification
config template	pole-mustache-v1
Thin SDK Specification
target envelope	TargetEnvelope v1

服务治理接口

	Latest Release
Serivce Management Specification
namespace	v1
service	v1
instance	v1
health check	v1
Traffic Mangement Specification
router	v1
load balancer	v1
limiter	v1
Fault Tolerance Specification
circuit breaker	v1
fault detector	v1
Access Control Specification
authentication	v1
AI Native Specification
mcp server	v1

如何构建

• Java语言

Java 的生成工程在 /source/java/pole-specification 下，使用 Maven 构建：

cd source/java/pole-specification
mvn clean verify

• Go语言

Go的编译相关工程在/source/go下，通过以下命令可以构建

cd source/go
rm -rf api
bash build.sh

• Rust语言

Rust的编译相关工程在/source/rust/pole-specification，通过以下命令可以构建

cd source/rust
bash build.sh

• Node.js、Python、C++ 与 C#

Node.js npm 包、Python PyPI 包、C++ CMake 源码包和 C# NuGet 包均从 api/ 自动生成。 构建、使用及发布配置见 多语言 gRPC 生成包。

如何使用

• Java语言，只需要添加pole-specification的依赖即可完成。

<dependency>
    <groupId>io.github.lattice-hub</groupId>
    <artifactId>pole-specification</artifactId>
    <!-- 版本号可换成最新版本号-->
    <version>0.1.0-ALPHA.44</version>
</dependency>

• Go语言，修改go.mod，添加github.com/pole-io/specification的依赖。

require github.com/pole-io/specification v1.3.0

• Rust语言，修改cargo.toml，添加pole-specification的依赖。

[dependencies]
pole-specification = "1.3"