88cd4f8504
Fixes bug 1045142. This patch adds 'local' as a new value for provider:network_type, supported by the openvswitch and linuxbridge plugins. Networks of this type provide connectivity through a bridge for VMs and agents local to the host, but no external connectivity. They do not require provider:physical_network or provider:segmentation_id values. These local networks are intended mainly to support single-box zero-configuration testing (including quantum gating), but may have other uses as well. For openvswitch, the new OVS.tenant_network_type configuration variable selects what type of networks are allocated as tenant (i.e. non-provider) networks. It defaults to 'local', but must be changed to 'vlan' or 'gre' for openvswitch tenant networks to have external connectivity. The default value is intended to support single-box zero-configuration testing without any need to allocate physical network resources or configure bridges, and without requiring the operating system to support OVS GRE tunneling. It can also be set to 'none' to completely disable creation of tenant networks. For linuxbridge, the new VLANS.tenant_network_type configuration variable works similarly, with a value of 'vlan' supporting tenant networks with external connectivity. With either plugin, administrators can create provider local networks by specifying "--provider:network_type local". Additionally, with openvswitch, provider GRE networks can now be created by specifying "--provider:network_type gre --provider:segmentation_id <tunnel-id>". A corresponding devstack patch is available at https://review.openstack.org/#/c/12456/. With this patch, the openvswitch and linuxbridge plugins are by default configured to support only local networks. A set of shell variables, documented in stack.sh, can be set in localrc to configure remote connectivity, including bridges/interfaces available for provider networks. Change-Id: I2812548326141d2212d04f34d5448fb974d298e0
86 lines
2.9 KiB
Python
86 lines
2.9 KiB
Python
# Copyright (c) 2012 OpenStack, LLC.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
# implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
from quantum.api.v2 import attributes
|
|
|
|
NETWORK_TYPE = 'provider:network_type'
|
|
PHYSICAL_NETWORK = 'provider:physical_network'
|
|
SEGMENTATION_ID = 'provider:segmentation_id'
|
|
|
|
NETWORK_TYPE_VALUES = ['flat', 'gre', 'local', 'vlan']
|
|
|
|
EXTENDED_ATTRIBUTES_2_0 = {
|
|
'networks': {
|
|
NETWORK_TYPE: {'allow_post': True, 'allow_put': True,
|
|
'validate': {'type:values': NETWORK_TYPE_VALUES},
|
|
'default': attributes.ATTR_NOT_SPECIFIED,
|
|
'is_visible': True},
|
|
PHYSICAL_NETWORK: {'allow_post': True, 'allow_put': True,
|
|
'default': attributes.ATTR_NOT_SPECIFIED,
|
|
'is_visible': True},
|
|
SEGMENTATION_ID: {'allow_post': True, 'allow_put': True,
|
|
'convert_to': int,
|
|
'default': attributes.ATTR_NOT_SPECIFIED,
|
|
'is_visible': True},
|
|
}
|
|
}
|
|
|
|
|
|
class Providernet(object):
|
|
"""Extension class supporting provider networks.
|
|
|
|
This class is used by quantum's extension framework to make
|
|
metadata about the provider network extension available to
|
|
clients. No new resources are defined by this extension. Instead,
|
|
the existing network resource's request and response messages are
|
|
extended with attributes in the provider namespace.
|
|
|
|
To create a provider VLAN network using the CLI with admin rights:
|
|
|
|
(shell) net-create --tenant_id <tenant-id> <net-name> \
|
|
--provider:network_type vlan \
|
|
--provider:physical_network <physical-net> \
|
|
--provider:segmentation_id <vlan-id>
|
|
|
|
With admin rights, network dictionaries returned from CLI commands
|
|
will also include provider attributes.
|
|
"""
|
|
|
|
@classmethod
|
|
def get_name(cls):
|
|
return "Provider Network"
|
|
|
|
@classmethod
|
|
def get_alias(cls):
|
|
return "provider"
|
|
|
|
@classmethod
|
|
def get_description(cls):
|
|
return "Expose mapping of virtual networks to physical networks"
|
|
|
|
@classmethod
|
|
def get_namespace(cls):
|
|
return "http://docs.openstack.org/ext/provider/api/v1.0"
|
|
|
|
@classmethod
|
|
def get_updated(cls):
|
|
return "2012-09-07T10:00:00-00:00"
|
|
|
|
def get_extended_resources(self, version):
|
|
if version == "2.0":
|
|
return EXTENDED_ATTRIBUTES_2_0
|
|
else:
|
|
return {}
|