# Sermant1
**Repository Path**: yami/sermant1
## Basic Information
- **Project Name**: Sermant1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: 0.8.x
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-18
- **Last Updated**: 2025-01-18
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
基于Java Agent的无代理服务网格解决方案
[简体中文](README-zh.md) | [English](README.md)
[](https://gitter.im/SermantUsers/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://www.apache.org/licenses/LICENSE-2.0.html)
[](https://github.com/huaweicloud/Sermant/actions?query=workflow:Java%20CI%20with%20Maven%20event:push%20branch:develop)
[](https://codecov.io/gh/huaweicloud/Sermant)
## Sermant
**Sermant**(也称之为Java-mesh)是基于Java Agent无代理的服务网格技术。其利用JavaAgent为宿主应用程序提供增强的服务治理功能,以解决大规模微服务体系结构中的服务治理问题。
Sermant的愿景还包括构建插件开发生态系统,以帮助开发人员更容易地开发服务治理功能,同时不干扰业务代码。Sermant架构描述如下。

根据上图,Sermant中Java Agent包含两层功能。
- 框架核心层。核心层提供Sermant的基本框架功能,以简化插件开发。该层的功能包括心跳、数据传输、动态配置等。
- 插件服务层。插件为宿主应用提供实际的治理服务。开发者可以直接利用框架核心服务开发简单插件,也可以开发插件自身的复杂服务治理功能来开发复杂插件。
Sermant中的Java Agent广泛采用类隔离技术,以消除框架代码、插件代码和宿主应用程序代码之间的类加载冲突。
使用Sermant的微服务架构具有以下三个组件,如下图所示。

- Sermant Java Agent:动态地为宿主应用程序提供服务治理能力。
- Sermant Backend:为Java Agent的上传数据提供连接和预处理服务。
- Dynamic configuration center:通过动态更新监听的Java Agent的配置来提供指令。Sermant项目不直接提供动态配置中心。这些项目目前支持servicecomb-kie等。
## 快速开始
### 下载或编译
点击[此处](https://github.com/huaweicloud/Sermant/releases)下载**Sermant**二进制包。如果您想自己编译项目,请遵循以下步骤。
执行*maven*命令来打包**Sermant**项目的 [demo module](sermant-example)。
```shell
mvn clean package -Dmaven.test.skip -Pexample
```
### 启动Sermant
启动 **Sermant** backend, **准备zookeeper**。
```shell
# Run under Linux
java -jar sermant-agent-x.x.x/server/sermant/sermant-backend-x.x.x.jar
```
```shell
# Run under Windows
java -jar sermant-agent-x.x.x\server\sermant\sermant-backend-x.x.x.jar
```
启动 **Sermant** demo 应用:
```shell
# Run under Linux
java -cp sermant-example/demo-application/target/demo-application.jar \
-javaagent:sermant-agent-x.x.x/agent/sermant-agent.jar=appName=test \
com.huawei.example.demo.DemoApplication
```
```shell
# Run under Windows
java -cp sermant-example\demo-application\target\demo-application.jar ^
-javaagent:sermant-agent-x.x.x\agent\sermant-agent.jar=appName=test ^
com.huawei.example.demo.DemoApplication
```
检查**Sermant**的运行状态。在本例中,打开浏览器并导航到URL“http://localhost:8900".

#### 有关详细信息,请参阅 [服务注册和发现快速开始说明](docs/QuickStart.md)。
## 插件功能列表
| 功能名称 | 阶段 | 微服务框架组件支持列表 |
|:-----|:-----|:-----|
| [限流降级](docs/user-guide/flowcontrol/flowcontrol-zh.md) | Beta | SpringBoot 1.2.x - 2.6.x
SpringWebMvc 4.1.3.RELEASE - 5.3.x
Dubbo 2.6.x-2.7.x |
| [服务注册](docs/user-guide/registry/document-zh.md) | GC | SpringBoot 1.5.x - 2.6.2
SpringCloud Edgware.SR2 - 2021.0.0
Dubbo 2.6.x-2.7.x |
| [服务双注册迁移](docs/user-guide/registry/spring-cloud-registry-migiration-zh.md) | GC | SpringBoot 1.5.x - 2.6.2
SpringCloud Edgware.SR2 - 2021.0.0
Dubbo 2.6.x-2.7.x |
| [负载均衡](docs/user-guide/loadbalancer/document-zh.md) | Beta | SpringBoot 1.5.x - 2.6.2
SpringCloud Edgware.SR2 - 2021.0.0 |
| [标签路由](docs/user-guide/router/document-zh.md) | Beta | SpringBoot 1.5.x - 2.6.2
SpringCloud Edgware.SR2 - 2021.0.0
Dubbo 2.6.x-2.7.x |
| [优雅上下线](docs/user-guide/graceful/document-zh.md) | Beta | SpringBoot 1.5.x - 2.6.2
SpringCloud Edgware.SR2 - 2021.0.0 |
| [动态配置](docs/user-guide/dynamic-config/document-zh.md) | Beta | SpringBoot 1.5.x - 2.6.2
spring-cloud-starter-alibaba-nacos-config 1.5.0.RELEASE+
spring-cloud-starter-zookeeper-config 1.2.0.RELEASE+ |
| [服务监控](docs/user-guide/server-monitor/document-zh.md) | Alpha | All |
## 更多文档
请参阅 [Sermant 开发和使用介绍](docs/README.md)
## License
Sermant 采用 [Apache 2.0 License.](/LICENSE)
## 贡献指南
请阅读[贡献指南](CONTRIBUTING.md)以了解如何贡献项目。
## 声明
- [Apache/Servicecomb-java-chassis](https://github.com/apache/servicecomb-java-chassis):Sermant引用了Apache Servicecomb项目中的服务治理算法。
- [Apache/Servicecomb-kie](https://github.com/apache/servicecomb-kie): Sermant使用servicecomb-kie作为默认的动态配置中心。
- [Apache/SkyWalking](https://skywalking.apache.org/): 本项目中的插件架构参考了Apache Skywalking。Sermant中的部分框架代码是基于Apache Skywalking项目构建的。
- [Alibaba/Sentinel](https://github.com/alibaba/Sentinel): Sermant的流量控制插件是基于阿里巴巴Sentinel项目构建的。