Self-documenting services: generating a microservice canvas
Contact me for information about consulting and training at your company.
The MEAP for Microservices Patterns 2nd edition is now available
Until July 25th, enroll for $95 in my virtual bootcamp, distributed data patterns in a microservice architecture
The microservice canvas is a great way to document a service. One drawback, however, is that like all forms of documentation, it often becomes out of date.
To solve this problem, I’ve created the Microservice Canvas Tools project.
This project keeps the canvas up to date by dynamically generating a microservice canvas for a running service using a combination of reflection/introspection and explicit metadata.
It exposes a service’s canvas via the /canvas.adoc, /canvas.html, /canvas.yml, and /canvas.json endpoints.
The project is still very much work in progress but please take a look and let me know what you think.
- Read my Microservices patterns book
- Read or watch my O’Reilly Software Architecture conference keynote
- Talk to me about my microservices consulting and training services including how I can help you create a microservices migration roadmap for your organization
- Learn more about microservices at adopt.microservices.io
Premium content now available for paid subscribers at 
