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:
Next Steps
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.
| We’re excited to announce Beer Garden v3 has been released! Check out the Application and Plugin upgrade guides if you’d like to learn more. |
Getting Help
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.
Contributing
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
-
Report bugs
-
Suggest new features
-
Write or edit the documentation
-
Write code - No patch is too small
Credits
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!
Copyright and Licensing
Free use of this software is granted under the terms of the MIT License. See the LICENSE file for details.