Sermant使用介绍

Sermant 是基于Java字节码增强技术的云原生无代理服务网格，通过 JavaAgent 对宿主应用进行非侵入式增强，以解决Java应用的微服务治理问题。Sermant的初衷是建立一个面向微服务治理的对开发态非侵入的解决方案生态，降低服务治理开发和使用的难度，通过抽象接口、功能整合、插件隔离等手段，达到简化开发、功能即插即用的效果。本文介绍Sermant目前包含的组件以及Sermant的编译打包。

架构简介

Sermant整体架构包括Sermant Agent、Sermant Backend、Sermant Injector、动态配置中心等组件。其中Sermant Agent是提供字节码增强基础能力及各类服务治理能力的核心组件，Sermant Backend、Sermant Injector、动态配置中心为Sermant提供其他能力的配套组件。

Sermant Agent

Sermant Agent为Sermant的核心组件，其中包含字节码增强基础能力框架及各类服务治理能力插件，Sermant Agent基于JavaAgent技术，支持Java 8及以上版本，当前已支持premain和agentmain两种方式启动。

更多Sermant Agent使用指南请参考Sermant Agent使用手册。

Sermant Backend

Sermant Backend为Sermant数据处理后端模块和前端信息展示模块，当前主要包括Sermant心跳信息的接收和展示等功能。Sermant Backend为Sermant的非必要组件，但是非常推荐用户部署Sermant Backend以获得Sermant的可观测性。

更多Sermant Backend使用指南请参考Sermant Backend使用手册。

Sermant Injector

Sermant支持在容器环境下通过Sermant Injector实现宿主应用自动挂载Sermant的快速部署方式，只需在应用部署的yaml中的labels添加sermant-injection: enabled即可实现该功能。Sermant Injector为Sermant非必要组件，推荐用户在容器环境中部署该组件以获得快速部署能力。当前Sermant Injector支持在k8s 1.15+ 版本部署。

更多Sermant Injector使用指南请参考Sermant Injector使用手册。

动态配置中心

动态配置作为Sermant提供的基础功能，该功能允许Sermant动态地从配置中心拉取配置以实现丰富多样的服务治理能力，例如标签路由、流控等。在开启该功能时，需要依赖动态配置中心，Sermant目前支持三种动态配置中心：Zookeeper (opens new window)、ServiceComb Kie (opens new window)、Nacos (opens new window)。如不开启Sermant动态配置能力，动态配置中心可无需部署。

更多动态配置中心使用指南请参考动态配置中心使用手册。

编译构建

编译打包Sermant Agent

Sermant项目基于Maven进行编译构建，其中包含以下几种profile，对应不同使用场景：

• agent: 编译打包核心功能和稳定插件
• release: 发布构建产物到中央仓库
• test: 编译打包所有项目模块

在Sermant项目根目录下执行以下maven命令，对Sermant工程使用agent进行打包：

mvn clean package -DskipTests -Pagent

命令执行完毕后，工程目录下将生成一个形如sermant-agent-x.x.x的文件夹和形如sermant-agent-x.x.x.tar.gz的压缩文件，后者为Sermant的产品包，前者则为产品包解压后的内容。

Sermant Agent产品目录说明

sermant-agent-x.x.x目录下包含以下内容

• agent: 包含sermant-agent相关内容
  • config: 包含Sermant配置文件
  • god：包含Sermant的核心接口包
  • core: 包含Sermant的核心框架包
  • implement: 包含Sermant核心功能实现包
  • common: 包含Sermant公共依赖包
  • pluginPackage: 包含各服务治理功能插件包以及配置文件等
  • sermant-agent.jar: Sermant入口包，premain和agentmain方式启动的入口
• server: 包含Sermant的服务端Sermant Backend。