Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/2600hz/docker
https://github.com/2600hz/docker
Last synced: 4 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/2600hz/docker
- Owner: 2600hz
- Created: 2016-11-29T18:49:45.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2019-05-22T23:28:09.000Z (over 5 years ago)
- Last Synced: 2024-08-02T12:50:54.673Z (3 months ago)
- Language: Shell
- Size: 349 KB
- Stars: 25
- Watchers: 34
- Forks: 29
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-starred - 2600hz/docker - (others)
README
Kazoo as docker containers
==========================
Preface
=======
This is development environment, it provides all Kazoo components alongside with source code,
and a way to modify it on each step. If you're interested in just running Kazoo in Docker environment
please check [production images](https://github.com/jamhed/kazoo-docker).
Notes
=====
* All components depends on base-os image (debian jessie)
* BigCouch is replaced by CouchDB 2.0
* Containers are big (as they contains complete source code and build tools)
Init
====
You need to have Docker version at least 1.9.0 (as this setup relies on docker network heavily).
```sh
build.sh
run.sh
hosts.sh >> /etc/hosts
```
You need to append /etc/hosts file to access Monster UI by URL http://monster-ui.kazoo:3000, and in turn it needs access to http://kazoo.kazoo:8000.
Please note each container run.sh and build.sh scripts should be run inside their respective folders.
After start
===========
To initialize the system after clean start (with empty database) there is after-start.sh script that:
1. Creates a master account admin with password admin
2. Adds freeswitch node to Kazoo
3. Registers sound prompts
4. Registers Monster-UI 'apps'
In order to make it work you need to wait some time after Kazoo container starts (while it creates databases).
Kazoo builds
============
```sh
cd kazoo
./build.sh [REPO]
```
Default REPO is https://github.com/2600hz/kazoo.git if omitted.
It automatically checks and caches builds for the latest commit. When latest commit hash changes
only necessary steps are performed to update the image (git pull/make install actually),
utilizing the docker caching ability.
Kazoo Erlang console
====================
```sh
docker exec -ti kazoo.kazoo ./run.sh remote_console
# or
cd kazoo ; ./console
```
Kazoo sup
=========
```sh
cd kazoo
# Running apps
./sup kapps_controller running_apps
# Add Freeswitch node
./sup ecallmgr_maintenance add_fs_node [email protected]
# Get freeswitch nodes (should be [<<"[email protected]">>])
./sup ecallmgr_config get fs_nodes
# Add admin user
./sup crossbar_maintenance create_account admin_name kamailio.kazoo admin admin
# Import Kazoo voice prompts
./sup kazoo_media_maintenance import_prompts /home/user/kazoo-sounds/kazoo-core/en/us en-us
# Check RabbitMQ
./sup kazoo_amqp_maintenance connection_summary
```
Sanity check
============
## Check Kazoo status (this is probably what you should see)
```sh
$ docker exec kazoo.kazoo sup kz_nodes status
Node : [email protected]
Version : 4.0.0 - 18
Memory Usage : 190.55MB
Processes : 1816
Ports : 52
Zone : local
Broker : amqp://rabbitmq.kazoo:5672
WhApps : blackhole(4m19s) callflow(4m19s) cdr(4m19s) conference(4m19s)
crossbar(4m19s) doodle(4m18s) ecallmgr(4m18s) fax(4m18s)
hangups(3m58s) hotornot(3m58s) jonny5(3m58s) kazoo_globals(4m20s)
konami(3m58s) media_mgr(3m58s) milliwatt(3m58s) omnipresence(3m58s)
pivot(3m58s) registrar(3m58s) reorder(3m58s) runtime_tools
stepswitch(3m58s) sysconf(4m19s) teletype(3m58s) trunkstore(3m58s)
webhooks(3m58s)
Channels : 0
Registrations : 0
Media Servers : [email protected] (3m51s)
Node : [email protected]
Version : 5.0.0-dev4
Memory Usage : 14.27MB
Processes : 0
Ports : 0
Zone : local
Broker : amqp://rabbitmq.kazoo:5672
WhApps : kamailio(17m37s)
```
## Check Kazoo knows about Kamailio instance
```sh
$ docker exec kazoo.kazoo sup ecallmgr_maintenance acl_summary
+--------------------------------+-------------------+---------------+-------+------------------+----------------------------------+
| Name | CIDR | List | Type | Authorizing Type | ID |
+================================+===================+===============+=======+==================+==================================+
| kamailio.kazoo | 172.18.0.5/32 | authoritative | allow | system_config | |
+--------------------------------+-------------------+---------------+-------+------------------+----------------------------------+
```
## Check Kamailio has FreeSwitch as dispatcher
```sh
$ docker exec kamailio.kazoo kamcmd dispatcher.list | grep URI
URI: sip:freeswitch.kazoo:11000
```
Monster-UI
==========
How to register Monster-UI apps.
1. You need to have monster-ui and kazoo images running
2. You need to copy apps from monster-ui to kazoo
3. You need to 'register' these apps
```sh
docker cp monster-ui.kazoo:/usr/share/nginx/html/dist/apps apps
docker cp apps kazoo.kazoo:/home/user
rm -rf apps
cd kazoo
./sup crossbar_maintenance init_apps /home/user/apps http://kazoo.kazoo:8000/v2
```
Clustering
==========
You can setup a Kazoo cluster, please see [cluster](cluster) folder. Here is how:
```sh
cd cluster
./run.sh
./after-start.sh
```
The setup comprises 3 networks: kazoo, zone1 and zone2. Hosts from zone1 and zone2 can communicate to network kazoo only.
In zone1 and zone2 there are kazoo instance and freeswitch instance, and in kazoo network there are monster-ui, rabbitmq, couchdb
and kamailio hosts.
You should run after-start.sh only after kazoo finishes database update.
Environment variables
=====================
The intent is to specify docker build flags e.g. to pass --no-cache to forcefully rebuild.
```
BUILD_FLAGS -- flags to pass to build command for every image
```
Development
===========
Intended workflow:
1. edit source code
2. commit
3. rebuild and re-run container on commit (either locally or remotely)
TODO
====
* Add haproxy to setup (balance the load between two or more instances of kazoo)
* Inter-container file exchange for sup (monster-ui apps, kazoo-sounds)