bgio/brew-view repository overview

⁠Description

This image contains the beergarden REST API and Angular application.

⁠Supported Tags

bgio/brew-view 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/brew-view

⁠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/brew-view

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

Or you can mount a new configuration file and tell brew-view about it: $ docker run -v /my/new/config.json:/config.json bgio/brew-view -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/brew-view --help

⁠Networking

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

If you'd rather run brew-view by itself an easy solution is to run rabbitmq and mongo 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/brew-view (This assumes you have mongod and rabbitmq running on standard ports)

If you want to use a more complicated network you'll need to tell brew-view 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⁠!