Imagine if writing composable software services was as easy as writing a class in your favorite language with your favorite text editor. And sharing was as easy as running your main method.
It can be.
That’s the main idea behind Beer Garden. So much of software development is tangled in the weeds of standing up services, getting messages from one component to another, creating UIs, writing documentation, and concurrently supporting multiple versions. We want to change that.
Beer Garden makes it easy to turn your functions into REST interfaces that are ready for production use, in a way that’s accessible to anyone that can write a function. It creates all the boilerplate and infrastructure needed to turn that function into a type-safe, discoverable REST interface and an easy-to-use webform-based UI:
If this looks interesting and you’re ready to jump in then the Quickstart is for you!
On the other hand, if you’re still unsure of exactly what Beer Garden is and what it can do for you then take a look at What is Beer Garden? It has more overview information that can help you decide if Beer Garden is right for you.
Finally, if you’re looking for specific info, trying to figure out how to do something, or wondering if Beer Garden can do the neat thing you thought of the best place to look is the User Manual.
If you encounter issues or have suggestions on how to make Beer Garden even better, please feel free to submit an issue to the Issue Tracker.
Beer Garden is open-source, and in the spirit of open-source software everyone is encouraged to help improve this project. If you discover errors or omissions in the source code, documentation, or website content please don’t hesitate to submit an issue or open a merge request. New contributors are always welcome!
Check out the Contributing guide to get started.
Here are some ways you can contribute:
Use the pre-release (development) versions
Suggest new features
Write or edit the documentation
Write code - No patch is too small
A huge shout-out to the Asciidoctor Project. This website is built with AsciiDoctor and was heavily influenced by the Asciidoctor website. It really is the best way to write documentation and we highly recommend you check it out!
This website is hosted by GitHub Pages. It makes deployment easy and cheap. You can use it for blogs or documentation like this. Definitely take a look!
Free use of this software is granted under the terms of the MIT License. See the LICENSE file for details.