Dockerfile for running Junebug with Nginx.

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 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

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

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

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.

• Set up Junebug in Mission Control
• Create a Vumi Bridge channel