d74b0c17d4
Now novaclient version is v2[1], but in this document, it is currently v1.1 [1] https://github.com/openstack/python-novaclient/commit/ 0a60aae852d2688861d0b4ba097a1a00529f0611 Change-Id: I618d846089bd9381533eab7b4a36d434fad38e73
612 lines
16 KiB
ReStructuredText
612 lines
16 KiB
ReStructuredText
==========
|
|
Networking
|
|
==========
|
|
|
|
To use the information in this section, you should have a general
|
|
understanding of OpenStack Networking, OpenStack Compute, and the
|
|
integration between the two. You should also have access to a plug-in
|
|
that implements the Networking API v2.0.
|
|
|
|
.. _set-environment-variables:
|
|
|
|
Set environment variables
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Make sure that you set the relevant environment variables.
|
|
|
|
As an example, see the sample shell file that sets these variables to
|
|
get credentials:
|
|
|
|
.. code-block:: bash
|
|
|
|
export OS_USERNAME="admin"
|
|
export OS_PASSWORD="password"
|
|
export OS_TENANT_NAME="admin"
|
|
export OS_AUTH_URL="http://IPADDRESS/v2.0"
|
|
|
|
.. _get-credentials:
|
|
|
|
Get credentials
|
|
~~~~~~~~~~~~~~~
|
|
|
|
The examples in this section use the ``get_credentials`` method:
|
|
|
|
.. code-block:: python
|
|
|
|
def get_credentials():
|
|
d = {}
|
|
d['username'] = os.environ['OS_USERNAME']
|
|
d['password'] = os.environ['OS_PASSWORD']
|
|
d['auth_url'] = os.environ['OS_AUTH_URL']
|
|
d['tenant_name'] = os.environ['OS_TENANT_NAME']
|
|
return d
|
|
|
|
This code resides in the ``credentials.py`` file, which all samples
|
|
import.
|
|
|
|
Use the ``get_credentials()`` method to populate and get a dictionary:
|
|
|
|
.. code-block:: python
|
|
|
|
credentials = get_credentials()
|
|
|
|
.. _get-nova-credentials:
|
|
|
|
Get Nova credentials
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The examples in this section use the ``get_nova_credentials`` method:
|
|
|
|
.. code-block:: python
|
|
|
|
def get_nova_credentials():
|
|
d = {}
|
|
d['username'] = os.environ['OS_USERNAME']
|
|
d['api_key'] = os.environ['OS_PASSWORD']
|
|
d['auth_url'] = os.environ['OS_AUTH_URL']
|
|
d['project_id'] = os.environ['OS_TENANT_NAME']
|
|
return d
|
|
|
|
This code resides in the ``credentials.py`` file, which all samples
|
|
import.
|
|
|
|
Use the ``get_nova_credentials()`` method to populate and get a
|
|
dictionary:
|
|
|
|
.. code-block:: python
|
|
|
|
nova_credentials = get_nova_credentials()
|
|
|
|
.. _print-values:
|
|
|
|
Print values
|
|
~~~~~~~~~~~~
|
|
|
|
The examples in this section use the ``print_values`` and
|
|
``print_values_server`` methods:
|
|
|
|
.. code-block:: python
|
|
|
|
def print_values(val, type):
|
|
if type == 'ports':
|
|
val_list = val['ports']
|
|
if type == 'networks':
|
|
val_list = val['networks']
|
|
if type == 'routers':
|
|
val_list = val['routers']
|
|
for p in val_list:
|
|
for k, v in p.items():
|
|
print("%s : %s" % (k, v))
|
|
print('\n')
|
|
|
|
|
|
def print_values_server(val, server_id, type):
|
|
if type == 'ports':
|
|
val_list = val['ports']
|
|
|
|
if type == 'networks':
|
|
val_list = val['networks']
|
|
for p in val_list:
|
|
bool = False
|
|
for k, v in p.items():
|
|
if k == 'device_id' and v == server_id:
|
|
bool = True
|
|
if bool:
|
|
for k, v in p.items():
|
|
print("%s : %s" % (k, v))
|
|
print('\n')
|
|
|
|
This code resides in the ``utils.py`` file, which all samples import.
|
|
|
|
.. _create-network:
|
|
|
|
Create network
|
|
~~~~~~~~~~~~~~
|
|
|
|
The following program creates a network:
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
|
|
network_name = 'sample_network'
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
try:
|
|
body_sample = {'network': {'name': network_name,
|
|
'admin_state_up': True}}
|
|
|
|
netw = neutron.create_network(body=body_sample)
|
|
net_dict = netw['network']
|
|
network_id = net_dict['id']
|
|
print('Network %s created' % network_id)
|
|
|
|
body_create_subnet = {'subnets': [{'cidr': '192.168.199.0/24',
|
|
'ip_version': 4, 'network_id': network_id}]}
|
|
|
|
subnet = neutron.create_subnet(body=body_create_subnet)
|
|
print('Created subnet %s' % subnet)
|
|
finally:
|
|
print("Execution completed")
|
|
|
|
.. _list-network:
|
|
|
|
List networks
|
|
~~~~~~~~~~~~~
|
|
|
|
The following program lists networks:
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
from utils import print_values
|
|
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
netw = neutron.list_networks()
|
|
|
|
print_values(netw, 'networks')
|
|
|
|
For ``print_values``, see :ref:`Print values <print-values>`.
|
|
|
|
.. _create-ports:
|
|
|
|
Create ports
|
|
~~~~~~~~~~~~
|
|
|
|
The following program creates a port:
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
import novaclient.v2.client as nvclient
|
|
from credentials import get_credentials
|
|
from credentials import get_nova_credentials
|
|
|
|
credentials = get_nova_credentials()
|
|
nova_client = nvclient.Client(**credentials)
|
|
|
|
# Replace with server_id and network_id from your environment
|
|
|
|
server_id = '9a52795a-a70d-49a8-a5d0-5b38d78bd12d'
|
|
network_id = 'ce5d204a-93f5-43ef-bd89-3ab99ad09a9a'
|
|
server_detail = nova_client.servers.get(server_id)
|
|
print(server_detail.id)
|
|
|
|
if server_detail != None:
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
|
|
body_value = {
|
|
"port": {
|
|
"admin_state_up": True,
|
|
"device_id": server_id,
|
|
"name": "port1",
|
|
"network_id": network_id
|
|
}
|
|
}
|
|
response = neutron.create_port(body=body_value)
|
|
print(response)
|
|
|
|
For ``get_nova_credentials``, see :ref:`Get Nova credentials
|
|
<get-nova-credentials>`.
|
|
|
|
For ``get_credentials``, see :ref:`Get credentials <get-credentials>`.
|
|
|
|
.. _list-ports:
|
|
|
|
List ports
|
|
~~~~~~~~~~
|
|
|
|
The following program lists ports:
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
from utils import print_values
|
|
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
ports = neutron.list_ports()
|
|
print_values(ports, 'ports')
|
|
|
|
For ``get_credentials`` see :ref:`Get credentials <get-credentials>`.
|
|
|
|
For ``print_values``, see :ref:`Print values <print-values>`.
|
|
|
|
.. _list-server-ports:
|
|
|
|
List server ports
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
The following program lists the ports for a server:
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
import novaclient.v2.client as nvclient
|
|
from credentials import get_credentials
|
|
from credentials import get_nova_credentials
|
|
from utils import print_values_server
|
|
|
|
credentials = get_nova_credentials()
|
|
nova_client = nvclient.Client(**credentials)
|
|
|
|
# change these values according to your environment
|
|
|
|
server_id = '9a52795a-a70d-49a8-a5d0-5b38d78bd12d'
|
|
network_id = 'ce5d204a-93f5-43ef-bd89-3ab99ad09a9a'
|
|
server_detail = nova_client.servers.get(server_id)
|
|
print(server_detail.id)
|
|
|
|
if server_detail is not None:
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
ports = neutron.list_ports()
|
|
|
|
print_values_server(ports, server_id, 'ports')
|
|
body_value = {'port': {
|
|
'admin_state_up': True,
|
|
'device_id': server_id,
|
|
'name': 'port1',
|
|
'network_id': network_id,
|
|
}}
|
|
|
|
response = neutron.create_port(body=body_value)
|
|
print(response)
|
|
|
|
.. _create-port-add-port-subnet:
|
|
|
|
Create router and add port to subnet
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This example queries OpenStack Networking to create a router and add a
|
|
port to a subnet.
|
|
|
|
|
|
#. Import the following modules:
|
|
|
|
.. code-block:: python
|
|
|
|
from neutronclient.v2_0 import client
|
|
import novaclient.v2.client as nvclient
|
|
from credentials import get_credentials
|
|
from credentials import get_nova_credentials
|
|
from utils import print_values_server
|
|
|
|
#. Get Nova Credentials. See :ref:'Get Nova credentials
|
|
<get-nova-credentials>'.
|
|
|
|
#. Instantiate the ``nova_client`` client object by using the
|
|
``credentials`` dictionary object:
|
|
|
|
.. code-block:: python
|
|
|
|
nova_client = nvclient.Client(**credentials)
|
|
|
|
#. Create a router and add a port to the subnet:
|
|
|
|
.. code-block:: python
|
|
|
|
# Replace with network_id from your environment
|
|
|
|
network_id = '81bf592a-9e3f-4f84-a839-ae87df188dc1'
|
|
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
neutron.format = json
|
|
request = {'router': {'name': 'router name',
|
|
'admin_state_up': True}}
|
|
|
|
router = neutron.create_router(request)
|
|
router_id = router['router']['id']
|
|
# for example: '72cf1682-60a8-4890-b0ed-6bad7d9f5466'
|
|
router = neutron.show_router(router_id)
|
|
print(router)
|
|
body_value = {'port': {
|
|
'admin_state_up': True,
|
|
'device_id': router_id,
|
|
'name': 'port1',
|
|
'network_id': network_id,
|
|
}}
|
|
|
|
response = neutron.create_port(body=body_value)
|
|
print(response)
|
|
print("Execution Completed")
|
|
|
|
Create router: complete code listing example
|
|
--------------------------------------------
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
import novaclient.v2.client as nvclient
|
|
from credentials import get_credentials
|
|
from credentials import get_nova_credentials
|
|
from utils import print_values_server
|
|
|
|
credentials = get_nova_credentials()
|
|
nova_client = nvclient.Client(**credentials)
|
|
|
|
# Replace with network_id from your environment
|
|
|
|
network_id = '81bf592a-9e3f-4f84-a839-ae87df188dc1'
|
|
try:
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
neutron.format = 'json'
|
|
request = {'router': {'name': 'router name',
|
|
'admin_state_up': True}}
|
|
router = neutron.create_router(request)
|
|
router_id = router['router']['id']
|
|
# for example: '72cf1682-60a8-4890-b0ed-6bad7d9f5466'
|
|
router = neutron.show_router(router_id)
|
|
print(router)
|
|
body_value = {'port': {
|
|
'admin_state_up': True,
|
|
'device_id': router_id,
|
|
'name': 'port1',
|
|
'network_id': network_id,
|
|
}}
|
|
|
|
response = neutron.create_port(body=body_value)
|
|
print(response)
|
|
finally:
|
|
print("Execution completed")
|
|
|
|
.. _delete-network:
|
|
|
|
Delete a network
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
This example queries OpenStack Networking to delete a network.
|
|
|
|
To delete a network:
|
|
|
|
#. Import the following modules:
|
|
|
|
.. code-block:: python
|
|
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
|
|
#. Get credentials. See :ref:`Get Nova credentials <get-nova-credentials>`.
|
|
|
|
#. Instantiate the ``neutron`` client object by using the ``credentials``
|
|
dictionary object:
|
|
|
|
.. code-block:: python
|
|
|
|
neutron = client.Client(**credentials)
|
|
|
|
#. Delete the network:
|
|
|
|
.. code-block:: python
|
|
|
|
body_sample = {'network': {'name': network_name,
|
|
'admin_state_up': True}}
|
|
|
|
netw = neutron.create_network(body=body_sample)
|
|
net_dict = netw['network']
|
|
network_id = net_dict['id']
|
|
print('Network %s created' % network_id)
|
|
|
|
body_create_subnet = {'subnets': [{'cidr': '192.168.199.0/24',
|
|
'ip_version': 4, 'network_id': network_id}]}
|
|
|
|
subnet = neutron.create_subnet(body=body_create_subnet)
|
|
print('Created subnet %s' % subnet)
|
|
|
|
neutron.delete_network(network_id)
|
|
print('Deleted Network %s' % network_id)
|
|
|
|
print("Execution completed")
|
|
|
|
Delete network: complete code listing example
|
|
---------------------------------------------
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
|
|
network_name = 'temp_network'
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
try:
|
|
body_sample = {'network': {'name': network_name,
|
|
'admin_state_up': True}}
|
|
|
|
netw = neutron.create_network(body=body_sample)
|
|
net_dict = netw['network']
|
|
network_id = net_dict['id']
|
|
print('Network %s created' % network_id)
|
|
|
|
body_create_subnet = {'subnets': [{'cidr': '192.168.199.0/24',
|
|
'ip_version': 4, 'network_id': network_id}]}
|
|
|
|
subnet = neutron.create_subnet(body=body_create_subnet)
|
|
print('Created subnet %s' % subnet)
|
|
|
|
neutron.delete_network(network_id)
|
|
print('Deleted Network %s' % network_id)
|
|
finally:
|
|
print("Execution Completed")
|
|
|
|
.. _list-routers:
|
|
|
|
List routers
|
|
~~~~~~~~~~~~
|
|
|
|
This example queries OpenStack Networking to list all routers.
|
|
|
|
#. Import the following modules:
|
|
|
|
.. code-block:: python
|
|
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
from utils import print_values
|
|
|
|
#. Get credentials. See :ref:`Get Nova credentials <get-nova-credentials>`.
|
|
|
|
#. Instantiate the ``neutron`` client object by using the ``credentials``
|
|
dictionary object:
|
|
|
|
.. code-block:: python
|
|
|
|
neutron = client.Client(**credentials)
|
|
|
|
#. List the routers:
|
|
|
|
.. code-block:: python
|
|
|
|
routers_list = neutron.list_routers(retrieve_all=True)
|
|
print_values(routers_list, 'routers')
|
|
print("Execution completed")
|
|
|
|
For ``print_values``, see :ref:`Print values <print-values>`.
|
|
|
|
List routers: complete code listing example
|
|
-------------------------------------------
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
from utils import print_values
|
|
|
|
try:
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
routers_list = neutron.list_routers(retrieve_all=True)
|
|
print_values(routers_list, 'routers')
|
|
finally:
|
|
print("Execution completed")
|
|
|
|
.. _list-security-groups:
|
|
|
|
List security groups
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This example queries OpenStack Networking to list security groups.
|
|
|
|
#. Import the following modules:
|
|
|
|
.. code-block:: python
|
|
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
from utils import print_values
|
|
|
|
#. Get credentials. See :ref:`Get credentials <get-credentials>`.
|
|
|
|
#. Instantiate the ``neutron`` client object by using the ``credentials``
|
|
dictionary object:
|
|
|
|
.. code-block:: python
|
|
|
|
neutron = client.Client(**credentials)
|
|
|
|
#. List Security groups
|
|
|
|
.. code-block:: python
|
|
|
|
sg = neutron.list_security_groups()
|
|
print(sg)
|
|
|
|
List security groups: complete code listing example
|
|
---------------------------------------------------
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
from utils import print_values
|
|
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
sg = neutron.list_security_groups()
|
|
print(sg)
|
|
|
|
.. note::
|
|
|
|
OpenStack Networking security groups are case-sensitive while the
|
|
nova-network security groups are case-insensitive.
|
|
|
|
List subnets
|
|
~~~~~~~~~~~~
|
|
|
|
This example queries OpenStack Networking to list subnets.
|
|
|
|
#. Import the following modules:
|
|
|
|
.. code-block:: python
|
|
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
from utils import print_values
|
|
|
|
#. Get credentials. See :ref:'Get credentials <get-credentials>'.
|
|
|
|
#. Instantiate the ``neutron`` client object by using the ``credentials``
|
|
dictionary object:
|
|
|
|
.. code-block:: python
|
|
|
|
neutron = client.Client(**credentials)
|
|
|
|
#. List subnets:
|
|
|
|
.. code-block:: python
|
|
|
|
subnets = neutron.list_subnets()
|
|
print(subnets)
|
|
|
|
List subnets: complete code listing example
|
|
-------------------------------------------
|
|
|
|
.. code-block:: python
|
|
|
|
#!/usr/bin/env python
|
|
from neutronclient.v2_0 import client
|
|
from credentials import get_credentials
|
|
from utils import print_values
|
|
|
|
credentials = get_credentials()
|
|
neutron = client.Client(**credentials)
|
|
subnets = neutron.list_subnets()
|
|
print(subnets)
|