bgio/bartender repository overview

⁠Description

This image contains the beergarden backend and local plugin manager.

⁠Supported Tags

The bgio/bartender image currently supports the following tag famillies. See the 'Tags' tab for specific supported <versions>.

• latest, <version> (master/Dockerfile)⁠
• latest-python2, <version>-python2 (master/Dockerfile)⁠

⁠Running

$ docker run -p 2337:2337 bgio/bartender

⁠Configuration

We use yapconf⁠ for configuration, so you can either pass new values as environment variables with the BG_ prefix: $ docker run -e "BG_DB_HOST=mongohost" bgio/bartender

Or pass the new configuration values as command arguments: $ docker run bgio/bartender --db-host mongohost

Or you can mount a new configuration file and tell bartender about it: $ docker run -v /my/new/config.json:/config.json bgio/bartender -c /config.json

Note that if you go the configuration file route the values found there will always take precedence over environment variables.

To get a list of all possible configuration options just run the image with the --help flag: $ docker run bgio/bartender --help

⁠Networking

Bartender needs connectivity to several other services (brew-view⁠, rabbitmq⁠ and mongo⁠). The easiest way to run is to use the docker-compose file⁠ to stand up everything at once.

If you'd rather run bartender by itself an easy solution is to run the other services on the docker host. Then use the host network to allow the container to find the services it needs on localhost, which is where it'll look for them by default.

$ docker run --network="host" bgio/bartender (This assumes you have brew-view, mongod, and rabbitmq running on standard ports)

If you want to use a more complicated network you'll need to tell bartender where to find everything it needs (check out the compose file⁠ for an idea of what configuration options need to be set).

⁠Contact

Feel free to reach out to us on Gitter⁠!