A library for plugging and unplugging virtual interfaces in OpenStack.
Project description
A library for plugging and unplugging virtual interfaces in OpenStack.
Features
A base VIF plugin class that supplies a plug() and unplug() interface
Versioned objects that represent a virtual interface and its components
Usage
The interface to the os_vif library is very simple. To begin using the library, first call the os_vif.initialize() function. This will load all installed plugins and register the object model:
import os_vif os_vif.initialize()
Once the os_vif library is initialized, there are only two other library functions: os_vif.plug() and os_vif.unplug(). Both methods accept a single argument of type os_vif.objects.VIF:
import uuid
from nova import objects as nova_objects
from os_vif import exception as vif_exc
from os_vif import objects as vif_objects
from os_vif import vnic_types
instance_uuid = 'd7a730ca-3c28-49c3-8f26-4662b909fe8a'
instance = nova_objects.Instance.get_by_uuid(instance_uuid)
instance_info = vif_objects.InstanceInfo(
uuid=instance.uuid,
name=instance.name,
project_id=instance.project_id)
subnet = vif_objects.Subnet(cidr='192.168.1.0/24')
subnets = vif_objects.SubnetList([subnet])
network = vif_objects.Network(label='tenantnet',
subnets=subnets,
multi_host=False,
should_provide_vlan=False,
should_provide_bridge=False)
vif_uuid = uuid.uuid4()
vif = vif_objects.VIFVHostUser(id=vif_uuid,
address=None,
network=network,
plugin='vhostuser',
path='/path/to/socket',
mode=vif_objects.fields.VIFVHostUserMode.SERVER)
# Now do the actual plug operations to connect the VIF to
# the backing network interface.
try:
os_vif.plug(vif)
except vif_exc.PlugException as err:
# Handle the failure...
# If you are removing a virtual machine and its interfaces,
# you would use the unplug() operation:
try:
os_vif.unplug(vif)
except vif_exc.UnplugException as err:
# Handle the failure...
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file os_vif-1.3.0.tar.gz.
File metadata
- Download URL: os_vif-1.3.0.tar.gz
- Upload date:
- Size: 44.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6c56f5c44c7fdbcb572cda2326344f03dcc6d00ede4779dc30d8275dbd9fe4f1 |
|
| MD5 | d7e2012118348b41e3d22bab6f6fcfd6 |
|
| BLAKE2b-256 | 40849d77e190c80e1883fabb75f3807bae415f194cdf56567c6b637dd8b1d404 |
Provenance
File details
Details for the file os_vif-1.3.0-py2-none-any.whl.
File metadata
- Download URL: os_vif-1.3.0-py2-none-any.whl
- Upload date:
- Size: 52.8 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 94aa0d2a798029bccd3ebff59bc457ec694ea503e46c771fc5fb9c66a07f169a |
|
| MD5 | 62c96a52ea26c5beb7cef2fb983a40c3 |
|
| BLAKE2b-256 | f8725224272dc25ce6918a76f3ac4d657a49f3d1605e72567abc0ff367420fe1 |
