Skip to content

Latest commit

 

History

History
31 lines (22 loc) · 2.33 KB

README.md

File metadata and controls

31 lines (22 loc) · 2.33 KB

RestComm Load Balancer Docker Image

RestComm is a next generation Cloud Communications Platform to rapidly build voice, video, and messaging applications, using mainstream development skills. Created by the people at Telestax.

Using the RestComm Load Balancer docker image makes running RestComm Load Balancer easy and intuitive and improve the easiness of creating Restcomm Clusters.

It uses the last successful build of the Restcomm Load Balancer project - https://github.com/RestComm/load-balancer

Environment variables:

  1. EXTERNAL_PORT - the SIP port used where clients should connect
  2. INTERNAL_PORT - the SIP port used where restcomm instances should connect
  3. INTERFACE - Interface to be used from LB. If not set "eth0" will be used. (optional).
  4. HOST_ADDRESS - (optional) bind address for app.
  5. LOG_LEVEL - log level for app
  6. CONFIG_URL - remote config url for app. Will be downloaded before start. Previous variables will be applied to it too

Config file:

By default app uses config file from docker container. Config file are localted by path /opt/loadbalancer/config. In the user guide you can see how to configurate load balancer through config file - Restcomm Load Balancer User Guide

Also you have 2 additional ways to specify config file:

  1. use CONFIG_URL: config file will be downloaded and processed on start
  2. attach volume with config: -v $PWD/config-lb-dir:/opt/loadbalancer/config

Test :

  1. Launch Docker Restcomm Load Balancer with command docker run --name=lb restcomm/load-balancer:latest
  2. Check the host address from the logs Setup host: 172.17.0.14
  3. Launch Docker Restcomm Core with command docker run -i --name=restcomm-lb -v /var/log/restcomm/:/var/log/restcomm/ -e STATIC_ADDRESS=192.168.1.12 -e USE_STANDARD_PORTS=false -e LOAD_BALANCERS=172.17.0.14 -e ENVCONFURL="https://raw.githubusercontent.com/RestComm/Restcomm-Docker/master/scripts/restcomm_env_locally.sh" -p 80:80 -p 443:443 -p 9990:9990 -p 5060:5060 -p 5061:5061 -p 5062:5062 -p 5063:5063 -p 5060:5060/udp -p 65000-65050:65000-65050/udp restcomm/restcomm:lb
  4. Register your Jitsi SIP client to use host address of the LB (ie 172.17.0.14 and port 5060 here) and place a call to sip:[email protected]