2
Copyright 2010-2011 United States Government as represented by the
3
Administrator of the National Aeronautics and Space Administration.
6
Licensed under the Apache License, Version 2.0 (the "License"); you may
7
not use this file except in compliance with the License. You may obtain
8
a copy of the License at
10
http://www.apache.org/licenses/LICENSE-2.0
12
Unless required by applicable law or agreed to in writing, software
13
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
14
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
15
License for the specific language governing permissions and limitations
21
VLAN Network Mode is the default mode for Nova. It provides a private network
22
segment for each project's instances that can be accessed via a dedicated
23
VPN connection from the Internet.
25
In this mode, each project gets its own VLAN, Linux networking bridge, and subnet. The subnets are specified by the network administrator, and are assigned dynamically to a project when required. A DHCP Server is started for each VLAN to pass out IP addresses to VM instances from the subnet assigned to the project. All instances belonging to one project are bridged into the same VLAN for that project. The Linux networking bridges and VLANs are created by Nova when required, described in more detail in Nova VLAN Network Management Implementation.
28
(this text revised above)
29
Because the flat network and flat DhCP network are simple to understand and yet do not scale well enough for real-world cloud systems, this section focuses on the VLAN network implementation by the VLAN Network Manager.
32
In the VLAN network mode, all the VM instances of a project are connected together in a VLAN with the specified private subnet. Each running VM instance is assigned an IP address within the given private subnet.
34
.. image:: /images/Novadiagram.png
37
While network traffic between VM instances belonging to the same VLAN is always open, Nova can enforce isolation of network traffic between different projects by enforcing one VLAN per project.
39
In addition, the network administrator can specify a pool of public IP addresses that users may allocate and then assign to VMs, either at boot or dynamically at run-time. This capability is similar to Amazon's 'elastic IPs'. A public IP address may be associated with a running instances, allowing the VM instance to be accessed from the public network. The public IP addresses are accessible from the network host and NATed to the private IP address of the project.
41
.. todo:: Describe how a public IP address could be associated with a project (a VLAN)
43
This is the default networking mode and supports the most features. For multiple machine installation, it requires a switch that supports host-managed vlan tagging. In this mode, nova will create a vlan and bridge for each project. The project gets a range of private ips that are only accessible from inside the vlan. In order for a user to access the instances in their project, a special vpn instance (code named :ref:`cloudpipe <cloudpipe>`) needs to be created. Nova generates a certificate and key for the user to access the vpn and starts the vpn automatically. More information on cloudpipe can be found :ref:`here <cloudpipe>`.
45
The following diagram illustrates how the communication that occurs between the vlan (the dashed box) and the public internet (represented by the two clouds)
47
.. image:: /images/cloudpipe.png
53
For our implementation of Nova, our goal is that each project is in a protected network segment. Here are the specifications we keep in mind for meeting this goal.
57
* no default inbound Internet access without public NAT
58
* limited (project-admin controllable) outbound Internet access
59
* limited (project-admin controllable) access to other project segments
60
* all connectivity to instance and cloud API is via VPN into the project segment
62
We also keep as a goal a common DMZ segment for support services, meaning these items are only visible from project segment:
70
We kept in mind some of these limitations:
72
* Projects / cluster limited to available VLANs in switching infrastructure
73
* Requires VPN for access to project segment
77
Currently Nova segregates project VLANs using 802.1q VLAN tagging in the
78
switching layer. Compute hosts create VLAN-specific interfaces and bridges
81
The network nodes act as default gateway for project networks and contain
82
all of the routing and firewall rules implementing security groups. The
83
network node also handles DHCP to provide instance IPs for each project.
85
VPN access is provided by running a small instance called CloudPipe
86
on the IP immediately following the gateway IP for each project. The
87
network node maps a dedicated public IP/port to the CloudPipe instance.
89
Compute nodes have per-VLAN interfaces and bridges created as required.
90
These do NOT have IP addresses in the host to protect host access.
91
Compute nodes have iptables/ebtables entries created per project and
92
instance to protect against IP/MAC address spoofing and ARP poisoning.
94
The network assignment to a project, and IP address assignment to a VM instance, are triggered when a user starts to run a VM instance. When running a VM instance, a user needs to specify a project for the instances, and the security groups (described in Security Groups) when the instance wants to join. If this is the first instance to be created for the project, then Nova (the cloud controller) needs to find a network controller to be the network host for the project; it then sets up a private network by finding an unused VLAN id, an unused subnet, and then the controller assigns them to the project, it also assigns a name to the project's Linux bridge (br100 stored in the Nova database), and allocating a private IP within the project's subnet for the new instance.
96
If the instance the user wants to start is not the project's first, a subnet and a VLAN must have already been assigned to the project; therefore the system needs only to find an available IP address within the subnet and assign it to the new starting instance. If there is no private IP available within the subnet, an exception will be raised to the cloud controller, and the VM creation cannot proceed.
99
External Infrastructure
100
-----------------------
102
Nova assumes the following is available:
106
* Internet connectivity
112
This example network configuration demonstrates most of the capabilities
113
of VLAN Mode. It splits administrative access to the nodes onto a dedicated
114
management network and uses dedicated network nodes to handle all
115
routing and gateway functions.
117
It uses a 10GB network for instance traffic and a 1GB network for management.
123
* All nodes have a minimum of two NICs for management and production.
127
* add additional NICs for bonding or HA/performance
129
* network nodes should have an additional NIC dedicated to public Internet traffic
130
* switch needs to support enough simultaneous VLANs for number of projects
131
* production network configured as 802.1q trunk on switch
137
The network node controls the project network configuration:
139
* assigns each project a VLAN and private IP range
140
* starts dnsmasq on project VLAN to serve private IP range
141
* configures iptables on network node for default project access
142
* launches CloudPipe instance and configures iptables access
144
When starting an instance the network node:
146
* sets up a VLAN interface and bridge on each host as required when an
147
instance is started on that host
148
* assigns private IP to instance
149
* generates MAC address for instance
150
* update dnsmasq with IP/MAC for instance
152
When starting an instance the compute node:
154
* sets up a VLAN interface and bridge on each host as required when an
155
instance is started on that host
161
* Assign VLANs in the switch:
163
* public Internet segment
168
* Assign a contiguous range of VLANs to Nova for project use.
169
* Configure management NIC ports as management VLAN access ports.
170
* Configure management VLAN with Internet access as required
171
* Configure production NIC ports as 802.1q trunk ports.
172
* Configure Nova (need to add specifics here)
176
* project network size
179
.. todo:: need specific Nova configuration added
added
removed
doc/source/adminguide/network.vlan.rst
