Browse Source

Add docs on Neutron DVR support

Change-Id: Ie549944a6fde877b19e1739355664fe5177b89cc
Oleg Bondarev 2 years ago
parent
commit
100032e260
3 changed files with 118 additions and 0 deletions
  1. 117
    0
      doc/source/enable_neutron_dvr.rst
  2. 1
    0
      doc/source/index.rst
  3. BIN
      doc/source/neutron_with_dvr.png

+ 117
- 0
doc/source/enable_neutron_dvr.rst View File

@@ -0,0 +1,117 @@
1
+.. _enable_neutron_dvr:
2
+
3
+=============================================
4
+Enable Distributed Virtual Routing in Neutron
5
+=============================================
6
+
7
+This guide provides an instruction for enabling DVR support in a
8
+CCP deployment.
9
+
10
+.. NOTE:: DVR mode applies only for Neutron reference implementation with
11
+   ML2/OpenVSwitch plugin. In order to determine distributed routing
12
+   capabilities of other plugins/drivers please refer to their corresponding
13
+   documentation.
14
+
15
+Introduction
16
+============
17
+
18
+DVR
19
+---
20
+
21
+* Distributes L3 Routers across compute nodes when required by VMs
22
+* L3 and Metadata Agents are running on each and every compute node
23
+* Inter-subnets traffic is no longer affected by performance of one
24
+  node with l3 agent
25
+* Traffic for VMs with floating IP is no longer affected by performance
26
+  of one node with l3 agent
27
+* Removal of single l3 agent node as single-point-of-failure for all
28
+  inter-tenant traffic and Floating IP traffic
29
+
30
+.. image:: neutron_with_dvr.png
31
+     :height: 230 px
32
+     :width: 600 px
33
+
34
+Sample CCP configuration
35
+========================
36
+
37
+ccp.yaml may look like:
38
+
39
+::
40
+
41
+    builder:
42
+      push: True
43
+    registry:
44
+      address: "127.0.0.1:31500"
45
+    repositories:
46
+      skip_empty: True
47
+    services:
48
+      database:
49
+        service_def: galera
50
+      rpc:
51
+        service_def: rabbitmq
52
+      notifications:
53
+        service_def: rabbitmq
54
+    nodes:
55
+      node1:
56
+        roles:
57
+          - db
58
+          - messaging
59
+          - controller
60
+          - openvswitch
61
+      node[2-3]:
62
+        roles:
63
+          - db
64
+          - messaging
65
+          - compute
66
+          - openvswitch
67
+    roles:
68
+      db:
69
+        - database
70
+      messaging:
71
+        - rpc
72
+        - notifications
73
+      controller:
74
+        - etcd
75
+        - glance-api
76
+        - glance-registry
77
+        - heat-api-cfn
78
+        - heat-api
79
+        - heat-engine
80
+        - horizon
81
+        - keystone
82
+        - memcached
83
+        - neutron-dhcp-agent
84
+        - neutron-l3-agent
85
+        - neutron-metadata-agent
86
+        - neutron-server
87
+        - nova-api
88
+        - nova-conductor
89
+        - nova-consoleauth
90
+        - nova-novncproxy
91
+        - nova-scheduler
92
+      compute:
93
+        - nova-compute
94
+        - nova-libvirt
95
+        - neutron-l3-agent-compute
96
+        - neutron-metadata-agent
97
+      openvswitch:
98
+        - neutron-openvswitch-agent
99
+        - openvswitch-db
100
+        - openvswitch-vswitchd
101
+    configs:
102
+        private_interface: ens7
103
+        public_interface: ens7
104
+        neutron:
105
+          dvr: True
106
+          physnets:
107
+            - name: "physnet1"
108
+              bridge_name: "br-ex"
109
+              interface: "ens3"
110
+              flat: true
111
+              vlan_range: false
112
+
113
+Compute node now has 2 additional roles:
114
+neutron-l3-agent-compute and neutron-metadata-agent.
115
+
116
+.. NOTE:: For Floating IPs to work properly, DVR requires each compute node
117
+   to have access to the external net.

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

@@ -30,6 +30,7 @@ Advanced topics
30 30
    ceph
31 31
    ceph_cluster
32 32
    enable_sriov
33
+   enable_neutron_dvr
33 34
    using_calico_instead_of_ovs
34 35
    using_odl_instead_of_ovs
35 36
    ironic

BIN
doc/source/neutron_with_dvr.png View File


Loading…
Cancel
Save