bgio/example-plugins repository overview

⁠Description

This image contains multiple plugins that show different parts of Beer-garden functionality.

⁠Supported Tags

The bgio/example-plugins image currently supports the following tags:

• latest, (master/Dockerfile)⁠

⁠Running

The image has several example plugins that can be run as modules. For most of the plugins you just need to tell docker which one to use (along with the standard remote plugin connection information):

$ docker run bgio/example-plugins echo --bg-host localhost

These are the installed plugins:

• complex*
• concurrent-sleeper
• custom-display
• dynamic
• echo
• echo-sleeper
• error
• sleeper

*The complex plugin is slightly different - it requires its own command line arguments. Start that one up like this, passing any configuration options after the plugin CLI parameters: $ docker run bgio/example-plugins complex c1 c1-host c1-port --bg-host localhost

For an easy way to run all the example plugins check out the compose file⁠.

⁠Configuration

The plugins use yapconf⁠ for configuration, so you can either pass new values as environment variables with the BG_ prefix: $ docker run -e "BG_HOST=localhost" bgio/example-plugins echo

Or pass the new configuration values as command arguments after the plugin name: $ docker run bgio/example-plugins echo --bg-host localhost

To get a list of all possible configuration options just run the image with any plugins and the --help flag: $ docker run bgio/example-plugins echo --help

⁠Networking

The plugins need to be able to make an connection to [brew-view] and [rabbitmq]. See the Beer-garden documentation if you need help configuring Beer-garden.

⁠Contact

Feel free to reach out to us on Gitter⁠!