enunciate icon indicating copy to clipboard operation
enunciate copied to clipboard

Spring Boot 2.x Actuator Endpoints

Open mgardiner opened this issue 6 years ago • 4 comments

Update Enunciate to support documenting Spring Boot's 2.x Actuator endpoints.

See https://docs.spring.io/spring-boot/docs/2.0.1.RELEASE/reference/htmlsingle/#production-ready-endpoints

mgardiner avatar Apr 24 '18 18:04 mgardiner

IMHO that's already documented: https://docs.spring.io/spring-boot/docs/2.0.x/actuator-api/html/ @mgardiner what would like to achieve exactly?

panchenko avatar Apr 25 '18 06:04 panchenko

@panchenko, the idea is to have Enunciate "automatically" generate HTML documentation for the Spring Boot actuators that have been enabled within a Spring Boot application to provide visibility into which Spring Boot actuators have been made public.

For example, lets say I wish to only enable the /actuator/info and /actuator/healthcheck Spring Boot actuator endpoints for my application; I would expect Enunciate to detect that during build time and generate the appropriate API documentation along with all my other REST APIs that I have written.

mgardiner avatar Apr 25 '18 14:04 mgardiner

Enunciate is indeed executed during build time, but you can change endpoint configuration after that. There is some mismatch here.

panchenko avatar Apr 25 '18 14:04 panchenko

I agree there is some mismatch in that it is possible to override which actuator endpoints are enabled or not but to do so requires access to the server / Docker instance which in our case we don't allow in our production instances.

mgardiner avatar Apr 25 '18 15:04 mgardiner