2장. Spring Boot 2.x용 Fuse 콘솔에 액세스

프로세스

1. Fuse 애플리케이션의 pom.xml 파일에 다음 종속성을 추가합니다.

   <dependency>
     <groupId>io.hawt</groupId>
     <artifactId>hawtio-springboot</artifactId>
   </dependency>

   Maven BOM에서 제공하므로 정확한 버전을 지정할 필요가 없습니다.

2. src/main/resources/application.properties 파일을 편집합니다.

   1. 다음 속성을 설정합니다.

      • management.endpoints.web.exposure.include=hawtio,jolokia
      • hawtio.authenticationEnabled=false
      • management.endpoint.hawtio.enabled=true
      • management.endpoint.jolokia.enabled=true

   2. 필요한 경우 management.endpoints.web.base-path 속성을 설정합니다.

      기본적으로 Spring Boot 2.x의 URL에는 관리 끝점의 컨텍스트 경로(/actuator)가 포함됩니다. 예를 들면 다음과 같습니다.

      http://localhost:10001/actuator/hawtio/index.html

      이 기본 URL을 변경하려면 다음과 같이 management.endpoints.web.base-path 속성을 설정합니다.http://localhost:10001/hawtio

      management.endpoints.web.base-path=/

      application.properties 설정은 다음 예와 유사해야 합니다.

      # ports
      
      server.port=8080
      
      management.server.port=10001
      
      # enable management endpoints for healthchecks and hawtio
      
      management.endpoints.enabled-by-default = false
      
      management.endpoint.hawtio.enabled = true
      
      management.endpoint.jolokia.enabled = true
      
      management.endpoints.health.enabled = true
      
      management.health.defaults.enabled=false
      
      camel.health.enabled=false
      
      camel.health.indicator.enabled=true
      
      management.endpoints.web.exposure.include=hawtio,jolokia
      
      hawtio.authenticationEnabled=false
      
      # change the URL so that it does not include the actuator folder
      
      management.endpoints.web.base-path=/

      참고

      기본적으로 Spring Boot에서 Fuse Console에 대한 인증은 비활성화되어 있습니다. 선택적으로 Fuse Console 배포와 관련된 코드를 작성하여 인증을 활성화할 수 있습니다. 지침에 사용할 수 있는 예는 다음과 같습니다.

      https://github.com/hawtio/hawtio/tree/master/examples/springboot-authentication

3. Fuse 애플리케이션을 실행합니다.

   mvn spring-boot:run

4. Fuse Console URL의 포트 번호를 확인하려면 src/main/resources/application.properties 파일에 설정된 값을 확인하여 management.server.port 값을 가져옵니다. 예를 들면 다음과 같습니다.

   management.server.port   = 10001

5. 브라우저에서 Fuse 콘솔을 열려면 nnnnn 이 management.server.port 속성의 값인 다음 URL 구문을 사용합니다.

   http://localhost:nnnnn/actuator/hawtio

   예를 들어 management.server.port 속성 값이 10001 이고 management.endpoints.web.base-path 속성을 설정하지 않은 경우 URL은 다음과 같습니다.

   http://localhost:10001/actuator/hawtio/index.html