Browse Source

Doc about zmq in ccp

Change-Id: I8a59813224ac384294a74b749d097bae2a595cfe
changes/14/440714/5
Andrey Pavlov 2 years ago
parent
commit
2ef42923e4
3 changed files with 112 additions and 0 deletions
  1. 1
    0
      doc/source/index.rst
  2. 57
    0
      doc/source/zmq.rst
  3. 54
    0
      etc/topology-with-zmq-example.yaml

+ 1
- 0
doc/source/index.rst View File

@@ -32,6 +32,7 @@ Advanced topics
32 32
    using_calico_instead_of_ovs
33 33
    using_odl_instead_of_ovs
34 34
    ironic
35
+   zmq
35 36
    known_issues
36 37
    neutron_configuration
37 38
 

+ 57
- 0
doc/source/zmq.rst View File

@@ -0,0 +1,57 @@
1
+.. _zmq:
2
+
3
+============
4
+ZeroMQ Guide
5
+============
6
+
7
+This guide provides information about how to enable zmq in the CCP.
8
+
9
+To use zmq as an rpc backend the following steps are required:
10
+
11
+1. `fuel-ccp-zmq` repository should be added to the repositories list:
12
+
13
+::
14
+
15
+    repositories:
16
+      repos:
17
+        - git_url: https://git.openstack.org/openstack/fuel-ccp-zmq
18
+          name: fuel-ccp-zmq
19
+
20
+2. `zmq-proxy` and `redis` images should be built:
21
+
22
+::
23
+
24
+    ccp build -c zmq-proxy redis
25
+
26
+3. `rpc` service should be configured to use zmq:
27
+
28
+::
29
+
30
+    services:
31
+      rpc:
32
+        service_def: zmq-proxy
33
+
34
+4. `rpc` and `redis` services should be added to topology. Example of such
35
+   topology provided in :file:`fuel-ccp/etc/topology-with-zmq-example.yaml`
36
+
37
+5. `configs` should be extended with the following values:
38
+
39
+::
40
+
41
+    configs:
42
+      messaging:
43
+        backend:
44
+          rpc: zmq
45
+
46
+Pretty much the same steps required to enable zmq as a notifications backend:
47
+
48
+::
49
+
50
+    services:
51
+      notifications:
52
+        service_def: zmq-proxy
53
+
54
+    configs:
55
+      messaging:
56
+        backend:
57
+          notifications: zmq

+ 54
- 0
etc/topology-with-zmq-example.yaml View File

@@ -0,0 +1,54 @@
1
+services:
2
+  database:
3
+    service_def: galera
4
+  rpc:
5
+    service_def: zmq-proxy
6
+  notifications:
7
+    service_def: zmq-proxy
8
+
9
+nodes:
10
+  node1:
11
+    roles:
12
+      - db
13
+      - messaging
14
+      - controller
15
+      - openvswitch
16
+  node[2-3]:
17
+    roles:
18
+      - db
19
+      - messaging
20
+      - compute
21
+      - openvswitch
22
+roles:
23
+  db:
24
+    - database
25
+  messaging:
26
+    - rpc
27
+    - notifications
28
+    - redis
29
+  controller:
30
+    - etcd
31
+    - glance-api
32
+    - glance-registry
33
+    - heat-api-cfn
34
+    - heat-api
35
+    - heat-engine
36
+    - horizon
37
+    - keystone
38
+    - memcached
39
+    - neutron-dhcp-agent
40
+    - neutron-l3-agent
41
+    - neutron-metadata-agent
42
+    - neutron-server
43
+    - nova-api
44
+    - nova-conductor
45
+    - nova-consoleauth
46
+    - nova-novncproxy
47
+    - nova-scheduler
48
+  compute:
49
+    - nova-compute
50
+    - nova-libvirt
51
+  openvswitch:
52
+    - neutron-openvswitch-agent
53
+    - openvswitch-db
54
+    - openvswitch-vswitchd

Loading…
Cancel
Save