Configuring
Contributing
Configuring Bondy on Docker
In order to configure Bondy when using Docker you will have two options:
- 1.
- 2.
Mounting a volume with the config files
First, you will need to create your config files in a local directory e.g.
~/tmp/bondy/etc and map it to the bondy/etc directory exposed by the docker image.Then, you will need to create a at least a minimal configuration for Bondy in that directory. The following are the snippets for a minimal configuration enabling anonymous clients to establish a session in a realm called
com.myapp.test and also in the com.leapsight.bondy realm a.k.a. the administrative realm.bondy.conf
security_config.json
1
distributed_cookie = bondy
2
nodename = [email protected]
3
aae.data_exchange_timeout = 1m
4
aae.enabled = on
5
security.allow_anonymous_user = on
6
security.automatically_create_realms = off
7
security.config_file = $(platform_etc_dir)/security_config.json
Copied!
1
[
2
{
3
"uri" : "com.myapp.test",
4
"description" : "A test realm",
5
"authmethods" : ["wampcra", "ticket", "anonymous"],
6
"security_enabled" : true,
7
"users" : [],
8
"sources" : [
9
{
10
"usernames" : "all",
11
"authmethod" : "password",
12
"cidr" : "0.0.0.0/0",
13
"meta" : {
14
"description" : "Allows all users from any network authenticate using password credentials."
15
}
16
},
17
{
18
"usernames" : ["anonymous"],
19
"authmethod" : "trust",
20
"cidr" : "0.0.0.0/0",
21
"meta" : {
22
"description" : "Allows all users from any network authenticate as anonymous."
23
}
24
}
25
],
26
"grants" : [
27
{
28
"permissions" : [
29
"wamp.register",
30
"wamp.unregister",
31
"wamp.subscribe",
32
"wamp.unsubscribe",
33
"wamp.call",
34
"wamp.cancel",
35
"wamp.publish"
36
],
37
"uri" : "*",
38
"roles" : ["anonymous"]
39
}
40
]
41
},
42
{
43
"uri" : "com.leapsight.bondy",
44
"authmethods" : ["wampcra", "ticket", "anonymous"],
45
"security_enabled" : true,
46
"users" : [
47
],
48
"groups" : [
49
{
50
"name" : "administrators",
51
"groups" : [],
52
"meta" : {
53
"description": "The administrators of Bondy."
54
}
55
}
56
],
57
"sources" : [
58
{
59
"usernames" : "all",
60
"authmethod" : "password",
61
"cidr" : "0.0.0.0/0",
62
"meta" : {
63
"description" : "Allows all users from any network authenticate using password credentials."
64
}
65
},
66
{
67
"usernames" : ["anonymous"],
68
"authmethod" : "trust",
69
"cidr" : "0.0.0.0/0",
70
"meta" : {
71
"description" : "Allows all users from any network authenticate as anonymous."
72
}
73
}
74
],
75
"grants" : [
76
{
77
"permissions" : [
78
"wamp.register",
79
"wamp.unregister",
80
"wamp.subscribe",
81
"wamp.unsubscribe",
82
"wamp.call",
83
"wamp.cancel",
84
"wamp.publish"
85
],
86
"uri" : "*",
87
"roles" : "all"
88
},
89
{
90
"permissions" : [
91
"wamp.register",
92
"wamp.unregister",
93
"wamp.subscribe",
94
"wamp.unsubscribe",
95
"wamp.call",
96
"wamp.cancel",
97
"wamp.publish"
98
],
99
"uri" : "*",
100
"roles" : ["anonymous"]
101
}
102
]
103
}
104
]
Copied!
Finally, you can run the docker image by mounting the local directory as the
/bondy/etc volume adding the option -v ~/tmp/bondy/etc:/bondy/etc as shown in the following example:1
docker run \
2
-p 18080:18080 \
3
-p 18081:18081 \
4
-p 18082:18082 \
5
-p 18086:18086 \
6
--name bondy1 \
7
-v ~/tmp/bondy/etc:/bondy/etc \
8
-d leapsight/bondy:0.8.6
Copied!
Creating your own docker image
Another way to configure Bondy which might allow for further DevOps customisation is to create your own custom docker image from the official images.
The following example shows how to do it.
Dockerfile
1
FROM leapsight/bondy:0.8.6 AS builder
2
​
3
COPY etc/security_config.json /bondy/etc/security_config.json
4
COPY etc/bondy.conf /bondy/etc/bondy.conf
5
​
Copied!
Lines
3 and 4 copy two configuration files from your custom image subdirectory/etc to the /bondy/etc/ directory. OS Environment Variable substitution
The chances are that you will need to get some of the configuration values from OS environment variables.
Bondy Docker image allows you to define those variables using the unix shell convention syntax e.g.
${VariableName}, as shown in the following snippet.1
nodename = ${BONDY_NODENAME}
2
distributed_cookie = ${BONDY_COOKIE}
Copied!
Using the example above, the only modification required for Bondy Docker to substitute those variables with the OS environment counterparts is to add a
.template extension to every configuration file containing variables. 1
FROM leapsight/bondy:0.8.6 AS builder
2
​
3
COPY etc/security_config.json /bondy/etc/security_config.json.template
4
COPY etc/bondy.conf /bondy/etc/bondy.conf.template
Copied!
Bondy Docker image will make the substitution automatically and place the resulting files in the same directory with the
.template extension removed before calling the bondy executable.Notice that variable substitution will fail if the environment does not have a value set for a variable found in the
.template files. This will cause the Docker image to fail.​
Last modified 2yr ago