docker-junebug

Dockerfile for running Junebug with Nginx.

Details:

Base image: praekeltfoundation/vumi

Two images are available:

praekeltfoundation/junebug:latest: based on Debian Jessie
praekeltfoundation/junebug:alpine: based on Alpine Linux 3.6

The latest stable versions of Junebug and Nginx are installed in these images.

Configuration:

Configuration can be done using environment variables or command-line options. Use of environment variables and command-line options can be mixed, but using an environment variable at the same time as it's equivalent command-line option can result in unexpected behaviour.

Two environment variables should always be set to enable HTTP basic auth for the Junebug API on the /jb/ path:

AUTH_USERNAME
AUTH_PASSWORD

Command-line options

Most of Junebug's command-line options can be passed to the container at startup. For example:

docker run \
  -e AUTH_USERNAME=user -e AUTH_PASSWORD=secret \
  praekeltfoundation/junebug \
    --redis-host redis0.internal \
    --redis-db 2 \
    --amqp-host rabbitmq0.internal \
    --amqp-vhost /junebug \
    --amqp-user rabbit \
    --amqp-password carrot

The following command-line options are always set by the entrypoint script:

--logging-path is set to . to ensure Junebug logs to stdout/stderr.
--plugins is provided to set up the Nginx plugin.
--channels is provided to set up the following default channels:
- whatsapp:vxyowsup.whatsapp.WhatsAppTransport
- vumigo:vumi.transports.vumi_bridge.GoConversationTransport
- dmark_ussd:vumi.transports.dmark.DmarkUssdTransport
- aat_ussd:vxaat.AatUssdTransport

Environment variables

Several environment variables can be adjusted to configure Junebug. These variables map to command-line options in the entrypoint script as follows:

Environment variable	Command-line option	Default value
`JUNEBUG_INTERFACE`	`--interface`
`JUNEBUG_PORT`	`--port`	`8080`
`REDIS_HOST`	`--redis-host`
`REDIS_PORT`	`--redis-port`	`6379`
`REDIS_DB`	`--redis-db`	`1`
`AMQP_HOST`	`--amqp-host`
`AMQP_PORT`	`--amqp-port`	`5679`
`AMQP_VHOST`	`--amqp-vhost`	`guest`
`AMQP_USER`	`--amqp-user`	`guest`
`AMQP_PASSWORD`	`--amqp-password`	`guest`
`RABBITMQ_MANAGEMENT_INTERFACE`	`--rabbitmq-management-interface`
`SENTRY_DSN`	`--sentry-dsn`
`ALLOW_EXPIRED_REPLIES`	`--allow-expired-replies`

For the Redis and AMQP configuration, it is necessary to set the _HOST variables before the other environment variables will be considered.

Similarly, the JUNEBUG_INTERFACE variable must be set before the JUNEBUG_PORT variable is used. However, it is not recommended that you change the --interface or --port options as all communication with Junebug should be performed via the Nginx instance in the container.

Usage:

License

qoda/docker-junebug

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages