SpringBootAdmin使用

SpringBootAdmin用来管理和监控SpringBoot应用程序，它利用spring-boot-starter-actuator提供的功能，将各个微服务的状态整合到一起，并提供良好的界面查看支持。SpringBootAdmin分为server端和client端，server端可查看各个微服务的状态，client端将微服务注册到server端。github源码地址：https://github.com/codecentric/spring-boot-admin

1、服务端基本配置

1）pom.xml依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-server</artifactId>
    <version>2.2.1</version>
</dependency>
<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-server-ui</artifactId>
    <version>2.2.1</version>
</dependency>

2）application.properties配置

server.port=8001
spring.application.name=admin-server

3）SpringBoot启动类添加@EnableAdminServer注解

@EnableAdminServer
@SpringBootApplication
public class AdminServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(AdminServerApplication.class, args);
    }
}

2、客户端基本配置

1）pom.xml依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-starter-client</artifactId>
    <version>2.2.1</version>
</dependency>

2）application.properties配置

server.port=8002
spring.application.name=admin-client
spring.boot.admin.client.url=http://127.0.0.1:8001
management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=ALWAYS

3）客户端不需要做任何代码修改

3、查看SpringBootAdmin效果

1）启动服务端和客户端后，访问http://127.0.0.1:8001，就可以查看所有注册的实例

2）点击具体实例就可以查看到当前实例的具体运行状态，在该界面可查看应用实例的健康状态、线程、内存使用、GC时间

3、启用认证

SpringBootAdmin的认证系统由spring-security管理。

1）服务端pom.xml文件增加spring-security依赖，改为：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-server</artifactId>
    <version>2.2.1</version>
</dependency>
<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-server-ui</artifactId>
    <version>2.2.1</version>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>

2）服务端application.properties增加security用户和密码配置信息，修改为：

server.port=8001
spring.application.name=admin-server
spring.security.user.name=admin
spring.security.user.password=abc123

3）服务端增加Java代码，配置spring-security

package com.zhi.demo.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.web.csrf.CookieCsrfTokenRepository;

import de.codecentric.boot.admin.server.config.AdminServerProperties;

/**
 * 配置security验证页面指向SpringBootAdmin提供的UI界面
 * 
 * @author zhi.leaf
 * @since 2020年1月20日17:44:25
 *
 */
@Configuration
public class SecuritySecureConfig extends WebSecurityConfigurerAdapter {

    private final String contextPath;

    public SecuritySecureConfig(AdminServerProperties adminServerProperties) {
        this.contextPath = adminServerProperties.getContextPath();
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        // 跨域设置，SpringBootAdmin客户端通过instances注册，见InstancesController
        http.csrf().csrfTokenRepository(CookieCsrfTokenRepository.withHttpOnlyFalse())
                .ignoringAntMatchers(contextPath + "/instances");

        http.authorizeRequests().antMatchers(contextPath + "/assets/**").permitAll(); // 静态资源
        http.authorizeRequests().anyRequest().authenticated(); // 所有请求必须通过认证

        // 整合spring-boot-admin-server-ui
        http.formLogin().loginPage("/login").permitAll();
        http.logout().logoutUrl("/logout").logoutSuccessUrl("/login");

        // 启用basic认证，SpringBootAdmin客户端使用的是basic认证
        http.httpBasic();
    }
}

4）客户端application.properties也增加用户和密码信息，和服务端保持一致，改为

server.port=8002
spring.application.name=admin-client
spring.boot.admin.client.url=http://127.0.0.1:8001
spring.boot.admin.client.username=admin
spring.boot.admin.client.password=abc123

5）重启服务端和客户端后，http://127.0.0.1:8001/，将会出现登录界面

猜你喜欢