Jarboot 是一个强大的Java进程管理、诊断的平台，.rar

# Jarboot ❤️  [](https://github.com/majianzheng/jarboot/actions/workflows/codeql-analysis.yml)  [](https://travis-ci.com/majianzheng/jarboot) [](https://codecov.io/gh/majianzheng/jarboot)  [](http://isitmaintained.com/project/majianzheng/jarboot "Average time to resolve an issue") [](http://isitmaintained.com/project/majianzheng/jarboot "Percentage of issues still open") [](https://www.yuque.com/jarboot/usage/quick-start)  <code>Jarboot</code> is a platform for Java process startup, shutdown, management and diagnosis. It can manage, guard, monitor and diagnose local and remote Java processes. In the test environment and daily built integrated environment, a series of jar files such as compilation output can be put into the agreed directory. <code>Jarboot</code> provides a friendly browser UI interface and HTTP interface to manage its start, stop and status monitoring, and execute commands to debug the target process. [中文说明/Chinese Documentation](README_CN.md) 📚 Document: https://www.yuque.com/jarboot 🍏 Best practices 🔥 : [Jarboot with Spring Cloud Alibaba Example](https://github.com/majianzheng/jarboot-with-spring-cloud-alibaba-example) ⭐️ 🐳 Extensible: Support both <code>JDK SPI</code> and <code>Spring SPI</code>, support plugins develop.  ## Background and objectives <code>Jarboot</code> uses Java agent and <code>ASM</code> technology to inject code into the target java process, which is non-invasive. The injected code is only used for command interaction with jarboot's service. Some commands modify the bytecode of the class for class enhancement. A command system similar to <code>Arthas</code> is added, such as acquiring JVM information, monitoring thread status, acquiring thread stack information, etc. - 🌈 Browser interface management, one click start, stop, do not have to manually execute one by one. - 🔥 Support start and stop priority configuration<sup id="a2">[[1]](#f1)</sup>, and default parallel start. - ⭐ Process daemon. If the service exits abnormally after opening, it will be automatically started and notified. - ☀️ Support file update monitoring, and restart automatically if jar file is updated after opening.<sup id="a3">[[2]](#f2)</sup> - 🚀 Debug command execution, remote debugging multiple Java processes at the same time, the interface is more friendly. - 💎 Support user-define command by <code>SPI</code>, support develop plugins.  ### Architecture brief introduction Detailed architecture design [view](jarboot-server/README.md) Front-end interface adopts <code>React</code> technology, scaffold uses <code>UmiJs</code>, component library uses <code>UmiJs</code> built-in <code>antd</code>. The back-end service is mainly implemented by <code>SpringBoot</code>, which provides HTTP interface and static resource broker. The process information is pushed through <code>websocket</code> to the front-end interface in real time, and a long connection is maintained with the started java process to monitor its status. ## Install or build ### Download the zip package to install or using docker. - <a href="https://github.com/majianzheng/jarboot/releases" target="_blank">Download from Github</a> - 🐳 Docker Hub: <https://registry.hub.docker.com/r/mazheng0908/jarboot> Use <code>docker</code> ```bash sudo docker run -itd --name jarboot -p 9899:9899 mazheng0908/jarboot ``` ### Code build method Ignore this when using zip package or <code>docker</code>. Build the jarboot code. ```bash #At first build ui $ cd jarboot-ui #First time, execute yarn or npm install $ yarn #execute compile, yarn build or npm run build, execute yarn start or npm run start at development mode. $ yarn build #Switch to the code root directory and compile the Java code $ cd ../ $ mvn clean install ``` ### Start <code>jarboot</code> server Ignore this when using <code>docker</code>. ```bash #Execute startup.sh to start, use startup.cmd when in windows OS. $ sh startup.sh ``` ### Browser access <http://127.0.0.1:9899> Enter the login page. Initial username: <code>jarboot</code>, default password: <code>jarboot</code>  ## SPI Extension, support both JDK and Spring SPI Use SPI extension can implement your own command, define a command how to execute. And，also can notify stated event to Jarboot server , don't need to wait no console time. ### SpringBoot Application 1. Import <code>spring-boot-starter-jarboot</code> dependency ```xml <dependency> <groupId>io.github.majianzheng</groupId> <artifactId>spring-boot-starter-jarboot</artifactId> <version>${jarboot.version}</version> </dependency> ``` 2. Implement <code>CommandProcessor</code>SPI interface Also, you can use <code>@Bean</code> in the method.<br> It will use bean name as the command name if not annotated by <code>@Name</code>. ```java @Name("spring.command.name") @Summary("The command summary") @Description("The command usage detail") @Component public class DemoServiceImpl implements DemoService, CommandProcessor { @Override public String process(CommandSession session, String[] args) { return "Spring boot Demo user-defined command using Spring SPI"; } //implement other method... } ``` It will add two new spring debug command <code>spring.bean</code> and <code>spring.env</code> after imported <code>spring-boot-starter-jarboot</code> dependence. ```shell #spring.bean usage: $ spring.bean [-b <name>] [-d] #Examples: # Get all bean names $ spring.bean # Get bean info $ spring.bean -b beanName # Get bean detail definition $ spring.bean -b beanName -d #sping.env usage: $ spring.env <name> #Examples: $ spring.env spring.application.name ``` ### None SpringBoot Application Demonstrate how to use ordinary non springboot applications. #### How to create user-defined command 1. Import jarboot api dependency ```xml <dependency> <groupId>io.github.majianzheng</groupId> <artifactId>jarboot-api</artifactId> <scope>provided</scope> <version>${jarboot.version}</version> </dependency> ``` 2. Implement spi interface ```java /** * Use Name to define the command name */ @Name("demo") @Summary("The command summary") @Description("The command usage detail") public class DemoCommandProcessor implements CommandProcessor { @Override public String process(CommandSession session, String[] args) { return "demo SPI command result."; } } ``` 3. Create spi define file Then create a file in <code>resources</code>/<code>META-INF</code>/<code>services</code> named <code>com.mz.jarboot.api.cmd.spi.CommandProcessor</code> the content is class full name. #### Proactive notification of startup completion ```java public class DemoApplication { public static void main(String[] args) { // do something try { //Notify completion JarbootFactory.createAgentService().setStarted(