openstack/neutron
Code Issues Proposed changes

Change neutron CLI to openstack CLI in neutron doc

Browse Source 
neutron CLI is deprecated and will be removed in the future. Use
openstack CLI instead.

Change-Id: I00fa6ee2e2ac19627a172ff49a55fe664e4f5c43
Closes-Bug: 1749801
This commit is contained in:
yanpuqing 2018-06-06 06:11:58 -04:00
parent 837de1042e
commit 5aa8eb99c8
9 changed files with 518 additions and 389 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

103
doc/source/admin/config-bgp-dynamic-routing.rst
View File

@ -249,32 +249,33 @@ Create the provider and self-service networks
.. code-block:: console .. code-block:: console
$ neutron subnet-create --name provider --subnetpool provider \ $ openstack subnet create --subnet-pool provider \
--prefixlen 24 --allocation-pool start=203.0.113.11,end=203.0.113.254 \ --prefix-length 24 --gateway 203.0.113.1 --network provider \
--gateway 203.0.113.1 provider --allocation-pool start=203.0.113.11,end=203.0.113.254 provider
Created a new subnet: +-------------------+--------------------------------------+
+-------------------+---------------------------------------------------+ | Field | Value |
| Field | Value | +-------------------+--------------------------------------+
+-------------------+---------------------------------------------------+ | allocation_pools | 203.0.113.11-203.0.113.254 |
| allocation_pools | {"start": "203.0.113.11", "end": "203.0.113.254"} | | cidr | 203.0.113.0/24 |
| cidr | 203.0.113.0/24 | | created_at | 2016-03-17T23:17:16 |
| created_at | 2016-03-17T23:17:16 | | description | |
| description | | | dns_nameservers | |
| dns_nameservers | | | enable_dhcp | True |
| enable_dhcp | True | | gateway_ip | 203.0.113.1 |
| gateway_ip | 203.0.113.1 | | host_routes | |
| host_routes | | | id | 8ed65d41-2b2a-4f3a-9f92-45adb266e01a |
| id | 8ed65d41-2b2a-4f3a-9f92-45adb266e01a | | ip_version | 4 |
| ip_version | 4 | | ipv6_address_mode | None |
| ipv6_address_mode | | | ipv6_ra_mode | None |
| ipv6_ra_mode | | | name | provider |
| name | provider | | network_id | 68ec148c-181f-4656-8334-8f4eb148689d |
| network_id | 68ec148c-181f-4656-8334-8f4eb148689d | | project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d |
| subnetpool_id | 3771c0e7-7096-46d3-a3bd-699c58e70259 | | segment_id | None |
| tags | [] | | service_types | |
| tenant_id | b3ac05ef10bf441fbf4aa17f16ae1e6d | | subnetpool_id | 3771c0e7-7096-46d3-a3bd-699c58e70259 |
| updated_at | 2016-03-17T23:17:16 | | tags | |
+-------------------+---------------------------------------------------+ | updated_at | 2016-03-17T23:17:16 |
+-------------------+--------------------------------------+
.. note:: .. note::
@ -380,13 +381,12 @@ Create the provider and self-service networks
.. code-block:: console .. code-block:: console
$ neutron subnet-create --name selfservice1 --subnetpool selfservice \ $ openstack subnet create --network selfservice1 --subnet-pool selfservice \
--prefixlen 25 selfservice1 --prefix-length 25 selfservice1
Created a new subnet:
+-------------------+----------------------------------------------------+ +-------------------+----------------------------------------------------+
| Field | Value | | Field | Value |
+-------------------+----------------------------------------------------+ +-------------------+----------------------------------------------------+
| allocation_pools | {"start": "192.0.2.2", "end": "192.0.2.127"} | | allocation_pools | 192.0.2.2-192.0.2.127 |
| cidr | 192.0.2.0/25 | | cidr | 192.0.2.0/25 |
| created_at | 2016-03-17T23:20:20 | | created_at | 2016-03-17T23:20:20 |
| description | | | description | |
@ -400,6 +400,7 @@ Create the provider and self-service networks
| ipv6_ra_mode | | | ipv6_ra_mode | |
| name | selfservice1 | | name | selfservice1 |
| network_id | be79de1e-5f56-11e6-9dfb-233e41cec48c | | network_id | be79de1e-5f56-11e6-9dfb-233e41cec48c |
| project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d |
| revision_number | 1 | | revision_number | 1 |
| subnetpool_id | c7e9737a-cfd3-45b5-a861-d1cee1135a92 | | subnetpool_id | c7e9737a-cfd3-45b5-a861-d1cee1135a92 |
| tags | [] | | tags | [] |
@ -407,13 +408,12 @@ Create the provider and self-service networks
| updated_at | 2016-03-17T23:20:20 | | updated_at | 2016-03-17T23:20:20 |
+-------------------+----------------------------------------------------+ +-------------------+----------------------------------------------------+
$ neutron subnet-create --name selfservice2 --subnetpool selfservice \ $ openstack subnet create --network selfservice2 --subnet-pool selfservice \
--prefixlen 25 selfservice2 --prefix-length 25 selfservice2
Created a new subnet:
+-------------------+------------------------------------------------+ +-------------------+------------------------------------------------+
| Field | Value | | Field | Value |
+-------------------+------------------------------------------------+ +-------------------+------------------------------------------------+
| allocation_pools | {"start": "192.0.2.130", "end": "192.0.2.254"} | | allocation_pools | 192.0.2.130-192.0.2.254 |
| cidr | 192.0.2.128/25 | | cidr | 192.0.2.128/25 |
| created_at | 2016-03-17T23:20:20 | | created_at | 2016-03-17T23:20:20 |
| description | | | description | |
@ -427,6 +427,7 @@ Create the provider and self-service networks
| ipv6_ra_mode | | | ipv6_ra_mode | |
| name | selfservice2 | | name | selfservice2 |
| network_id | c1fd9846-5f56-11e6-a8ac-0f998d9cc0a2 | | network_id | c1fd9846-5f56-11e6-a8ac-0f998d9cc0a2 |
| project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d |
| revision_number | 1 | | revision_number | 1 |
| subnetpool_id | c7e9737a-cfd3-45b5-a861-d1cee1135a92 | | subnetpool_id | c7e9737a-cfd3-45b5-a861-d1cee1135a92 |
| tags | [] | | tags | [] |
@ -439,12 +440,11 @@ Create the provider and self-service networks
.. code-block:: console .. code-block:: console
$ neutron subnet-create --name subnet3 selfservice3 198.51.100.0/24 $ openstack subnet create --network selfservice3 --prefix 198.51.100.0/24 subnet3
Created a new subnet:
+-------------------+----------------------------------------------------+ +-------------------+----------------------------------------------------+
| Field | Value | | Field | Value |
+-------------------+----------------------------------------------------+ +-------------------+----------------------------------------------------+
| allocation_pools | {"start": "198.51.100.2", "end": "198.51.100.254"} | | allocation_pools | 198.51.100.2-198.51.100.254 |
| cidr | 198.51.100.0/24 | | cidr | 198.51.100.0/24 |
| created_at | 2016-03-17T23:20:20 | | created_at | 2016-03-17T23:20:20 |
| description | | | description | |
@ -458,6 +458,7 @@ Create the provider and self-service networks
| ipv6_ra_mode | | | ipv6_ra_mode | |
| name | selfservice3 | | name | selfservice3 |
| network_id | c283dc1c-5f56-11e6-bfb6-efc30e1eb73b | | network_id | c283dc1c-5f56-11e6-bfb6-efc30e1eb73b |
| project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d |
| revision_number | 1 | | revision_number | 1 |
| subnetpool_id | | | subnetpool_id | |
| tags | [] | | tags | [] |
@ -548,27 +549,21 @@ Create and configure the routers
.. code-block:: console .. code-block:: console
$ neutron router-interface-add router1 selfservice1 $ openstack router add subnet router1 selfservice1
Added interface 90e3880a-5f5c-11e6-914c-9f3e20c8c151 to router router1.
$ neutron router-interface-add router2 selfservice2 $ openstack router add subnet router2 selfservice2
Added interface 91628362-5f5c-11e6-826a-7322fb03a821 to router router2.
$ neutron router-interface-add router3 selfservice3 $ openstack router add subnet router3 selfservice3
Added interface 91d51044-5f5c-11e6-bf55-ffd180541cc2 to router router3.
#. Add the provider network as a gateway on each router. #. Add the provider network as a gateway on each router.
.. code-block:: console .. code-block:: console
$ neutron router-gateway-set router1 provider $ openstack router set --external-gateway provider router1
Set gateway for router router1
$ neutron router-gateway-set router2 provider $ openstack router set --external-gateway provider router2
Set gateway for router router2
$ neutron router-gateway-set router3 provider $ openstack router set --external-gateway provider router3
Set gateway for router router3
Create and configure the BGP speaker Create and configure the BGP speaker
------------------------------------ ------------------------------------
@ -815,13 +810,13 @@ assist with verifying operation of the BGP speaker.
.. code-block:: console .. code-block:: console
$ neutron port-list --device_owner="network:floatingip_agent_gateway" $ openstack port list --device-owner network:floatingip_agent_gateway
+--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+
| id | name | mac_address | fixed_ips | | ID | Name | MAC Address | Fixed IP Addresses |
+--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+
| 87cf2970-4970-462e-939e-00e808295dfa | | fa:16:3e:7c:68:e3 | {"subnet_id": "8ed65d41-2b2a-4f3a-9f92-45adb266e01a", "ip_address": "203.0.113.12"} | | 87cf2970-4970-462e-939e-00e808295dfa | | fa:16:3e:7c:68:e3 | ip_address='203.0.113.12', subnet_id='8ed65d41-2b2a-4f3a-9f92-45adb266e01a' |
| 8d218440-0d2e-49d0-8a7b-3266a6146dc1 | | fa:16:3e:9d:78:cf | {"subnet_id": "8ed65d41-2b2a-4f3a-9f92-45adb266e01a", "ip_address": "203.0.113.13"} | | 8d218440-0d2e-49d0-8a7b-3266a6146dc1 | | fa:16:3e:9d:78:cf | ip_address='203.0.113.13', subnet_id='8ed65d41-2b2a-4f3a-9f92-45adb266e01a' |
| 87cf2970-4970-462e-939e-00e802281dfa | | fa:16:3e:6b:18:e0 | {"subnet_id": "8ed65d41-2b2a-4f3a-9f92-45adb266e01a", "ip_address": "203.0.113.14"} | | 87cf2970-4970-462e-939e-00e802281dfa | | fa:16:3e:6b:18:e0 | ip_address='203.0.113.14', subnet_id='8ed65d41-2b2a-4f3a-9f92-45adb266e01a' |
+--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+
IPv6 IPv6

414
doc/source/admin/config-dns-int-ext-serv.rst
View File

@ -127,27 +127,39 @@ Following is an example of these steps:
$ neutron net-update 38c5e950-b450-4c30-83d4-ee181c28aad3 --dns_domain example.org. $ neutron net-update 38c5e950-b450-4c30-83d4-ee181c28aad3 --dns_domain example.org.
Updated network: 38c5e950-b450-4c30-83d4-ee181c28aad3 Updated network: 38c5e950-b450-4c30-83d4-ee181c28aad3
$ neutron net-show 38c5e950-b450-4c30-83d4-ee181c28aad3 $ openstack network show 38c5e950-b450-4c30-83d4-ee181c28aad3
+-------------------------+--------------------------------------+ +---------------------------+--------------------------------------+
| Field | Value | | Field | Value |
+-------------------------+--------------------------------------+ +---------------------------+--------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| availability_zone_hints | | | availability_zone_hints | |
| availability_zones | nova | | availability_zones | nova |
| dns_domain | example.org. | | created_at | 2016-05-04T19:27:34Z |
| id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | | description | |
| mtu | 1450 | | dns_domain | example.org. |
| name | private | | id | 38c5e950-b450-4c30-83d4-ee181c28aad3 |
| port_security_enabled | True | | ipv4_address_scope | None |
| revision_number | 1 | | ipv6_address_scope | None |
| router:external | False | | is_default | None |
| shared | False | | is_vlan_transparent | None |
| status | ACTIVE | | mtu | 1450 |
| subnets | 43414c53-62ae-49bc-aa6c-c9dd7705818a | | name | private |
| | 5b9282a1-0be1-4ade-b478-7868ad2a16ff | | port_security_enabled | True |
| tags | [] | | project_id | d5660cb1e6934612a01b4fb2fb630725 |
| tenant_id | d5660cb1e6934612a01b4fb2fb630725 | | provider:network_type | vlan |
+-------------------------+--------------------------------------+ | provider:physical_network | None |
| provider:segmentation_id | 24 |
| qos_policy_id | None |
| revision_number | 1 |
| router:external | Internal |
| segments | None |
| shared | False |
| status | ACTIVE |
| subnets | 43414c53-62ae-49bc-aa6c-c9dd7705818a |
| | 5b9282a1-0be1-4ade-b478-7868ad2a16ff |
| tags | |
| updated_at | 2016-05-04T19:27:34Z |
+---------------------------+--------------------------------------+
$ openstack server create --image cirros --flavor 42 \ $ openstack server create --image cirros --flavor 42 \
--nic net-id=38c5e950-b450-4c30-83d4-ee181c28aad3 my_vm --nic net-id=38c5e950-b450-4c30-83d4-ee181c28aad3 my_vm
@ -190,40 +202,51 @@ Following is an example of these steps:
| 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 | my_vm | ACTIVE | - | Running | private=fda4:653e:71b0:0:f816:3eff:fe16:b5f2, 192.0.2.15 | cirros | | 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 | my_vm | ACTIVE | - | Running | private=fda4:653e:71b0:0:f816:3eff:fe16:b5f2, 192.0.2.15 | cirros |
+--------------------------------------+-------+--------+------------+-------------+----------------------------------------------------------+------------+ +--------------------------------------+-------+--------+------------+-------------+----------------------------------------------------------+------------+
$ neutron port-list --device_id 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 $ openstack port list --device-id 43f328bb-b2d1-4cf1-a36f-3b2593397cb1
+--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+--------+
| id | name | mac_address | fixed_ips | | ID | Name | MAC Address | Fixed IP Addresses | Status |
+--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+--------+
| da0b1f75-c895-460f-9fc1-4d6ec84cf85f | | fa:16:3e:16:b5:f2 | {"subnet_id": "5b9282a1-0be1-4ade-b478-7868ad2a16ff", "ip_address": "192.0.2.15"} | | da0b1f75-c895-460f-9fc1-4d6ec84cf85f | | fa:16:3e:16:b5:f2 | ip_address='192.0.2.15', subnet_id='5b9282a1-0be1-4ade-b478-7868ad2a16ff' | ACTIVE |
| | | | {"subnet_id": "43414c53-62ae-49bc-aa6c-c9dd7705818a", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe16:b5f2"} | | | | | ip_address='fda4:653e:71b0:0:f816:3eff:fe16:b5f2', subnet_id='43414c53-62ae-49bc-aa6c-c9dd7705818a' | |
+--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+--------+
$ neutron port-show da0b1f75-c895-460f-9fc1-4d6ec84cf85f $ openstack port show da0b1f75-c895-460f-9fc1-4d6ec84cf85f
+-----------------------+-------------------------------------------------------------------------------------------------------------+ +-----------------------+------------------------------------------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-----------------------+-------------------------------------------------------------------------------------------------------------+ +-----------------------+------------------------------------------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| allowed_address_pairs | | | allowed_address_pairs | |
| binding:vnic_type | normal | | binding_host_id | vultr.guest |
| device_id | 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 | | binding_profile | |
| device_owner | compute:None | | binding_vif_details | datapath_type='system', ovs_hybrid_plug='True', port_filter='True' |
| dns_assignment | {"hostname": "my-vm", "ip_address": "192.0.2.15", "fqdn": "my-vm.example.org."} | | binding_vif_type | ovs |
| | {"hostname": "my-vm", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe16:b5f2", "fqdn": "my-vm.example.org."} | | binding_vnic_type | normal |
| dns_name | my-vm | | created_at | 2016-02-15T19:27:34Z |
| extra_dhcp_opts | | | data_plane_status | None |
| fixed_ips | {"subnet_id": "5b9282a1-0be1-4ade-b478-7868ad2a16ff", "ip_address": "192.0.2.15"} | | description | |
| | {"subnet_id": "43414c53-62ae-49bc-aa6c-c9dd7705818a", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe16:b5f2"} | | device_id | 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 |
| id | da0b1f75-c895-460f-9fc1-4d6ec84cf85f | | device_owner | compute:None |
| mac_address | fa:16:3e:16:b5:f2 | | dns_assignment | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='192.0.2.15' |
| name | | | | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='fda4:653e:71b0:0:f816:3eff:fe16:b5f2' |
| network_id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | | dns_domain | example.org. |
| port_security_enabled | True | | dns_name | my-vm |
| revision_number | 1 | | extra_dhcp_opts | |
| security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | | fixed_ips | ip_address='192.0.2.15', subnet_id='5b9282a1-0be1-4ade-b478-7868ad2a16ff' |
| status | ACTIVE | | | ip_address='fda4:653e:71b0:0:f816:3eff:fe16:b5f2', subnet_id='43414c53-62ae-49bc-aa6c-c9dd7705818a' |
| tags | [] | | id | da0b1f75-c895-460f-9fc1-4d6ec84cf85f |
| tenant_id | d5660cb1e6934612a01b4fb2fb630725 | | mac_address | fa:16:3e:16:b5:f2 |
+-----------------------+-------------------------------------------------------------------------------------------------------------+ | name | |
| network_id | 38c5e950-b450-4c30-83d4-ee181c28aad3 |
| port_security_enabled | True |
| project_id | d5660cb1e6934612a01b4fb2fb630725 |
| qos_policy_id | None |
| revision_number | 1 |
| security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 |
| status | ACTIVE |
| tags | |
| trunk_details | None |
| updated_at | 2016-02-15T19:27:34Z |
+-----------------------+------------------------------------------------------------------------------------------------------------+
$ openstack recordset list example.org. $ openstack recordset list example.org.
+--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+ +--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+
@ -233,24 +256,29 @@ Following is an example of these steps:
| e7c05a5d-83a0-4fe5-8bd5-ab058a3326aa | example.org. | SOA | ns1.devstack.org. malavall.us.ibm.com. 1513767794 3532 600 86400 3600 | ACTIVE | NONE | | e7c05a5d-83a0-4fe5-8bd5-ab058a3326aa | example.org. | SOA | ns1.devstack.org. malavall.us.ibm.com. 1513767794 3532 600 86400 3600 | ACTIVE | NONE |
+--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+ +--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+
$ neutron floatingip-create 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a \ $ openstack floating ip create 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a \
--port_id da0b1f75-c895-460f-9fc1-4d6ec84cf85f --port da0b1f75-c895-460f-9fc1-4d6ec84cf85f
Created a new floatingip:
+---------------------+--------------------------------------+ +---------------------+--------------------------------------+
| Field | Value | | Field | Value |
+---------------------+--------------------------------------+ +---------------------+--------------------------------------+
| created_at | 2016-02-15T20:27:34Z |
| description | |
| dns_domain | | | dns_domain | |
| dns_name | | | dns_name | |
| fixed_ip_address | 192.0.2.15 | | fixed_ip_address | 192.0.2.15 |
| floating_ip_address | 198.51.100.4 | | floating_ip_address | 198.51.100.4 |
| floating_network_id | 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a | | floating_network_id | 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a |
| id | e78f6eb1-a35f-4a90-941d-87c888d5fcc7 | | id | e78f6eb1-a35f-4a90-941d-87c888d5fcc7 |
| name | 198.51.100.4 |
| port_id | da0b1f75-c895-460f-9fc1-4d6ec84cf85f | | port_id | da0b1f75-c895-460f-9fc1-4d6ec84cf85f |
| project_id | d5660cb1e6934612a01b4fb2fb630725 |
| qos_policy_id | None |
| revision_number | 1 | | revision_number | 1 |
| router_id | 970ebe83-c4a3-4642-810e-43ab7b0c2b5f | | router_id | 970ebe83-c4a3-4642-810e-43ab7b0c2b5f |
| status | DOWN | | status | DOWN |
| subnet_id | None |
| tags | [] | | tags | [] |
| tenant_id | d5660cb1e6934612a01b4fb2fb630725 | | updated_at | 2016-02-15T20:27:34Z |
+---------------------+--------------------------------------+ +---------------------+--------------------------------------+
$ openstack recordset list example.org. $ openstack recordset list example.org.
@ -295,27 +323,38 @@ allocated for the instance:
.. code-block:: console .. code-block:: console
$ neutron net-show 38c5e950-b450-4c30-83d4-ee181c28aad3 $ openstack network show 38c5e950-b450-4c30-83d4-ee181c28aad3
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| availability_zone_hints | | | availability_zone_hints | |
| availability_zones | nova | | availability_zones | nova |
| dns_domain | example.org. | | created_at | 2016-05-04T19:27:34Z |
| id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | | description | |
| mtu | 1450 | | dns_domain | example.org. |
| name | private | | id | 38c5e950-b450-4c30-83d4-ee181c28aad3 |
| port_security_enabled | True | | ipv4_address_scope | None |
| revision_number | 1 | | ipv6_address_scope | None |
| router:external | False | | is_default | None |
| shared | False | | is_vlan_transparent | None |
| status | ACTIVE | | mtu | 1450 |
| subnets | 43414c53-62ae-49bc-aa6c-c9dd7705818a | | name | private |
| | 5b9282a1-0be1-4ade-b478-7868ad2a16ff | | port_security_enabled | True |
| tags | [] | | project_id | d5660cb1e6934612a01b4fb2fb630725 |
| tenant_id | d5660cb1e6934612a01b4fb2fb630725 | | provider:network_type | vlan |
+-------------------------+--------------------------------------+ | provider:physical_network | None |
| provider:segmentation_id | 24 |
| qos_policy_id | None |
| revision_number | 1 |
| router:external | Internal |
| segments | None |
| shared | False |
| status | ACTIVE |
| subnets | 43414c53-62ae-49bc-aa6c-c9dd7705818a, 5b9282a1-0be1-4ade-b478-7868ad2a16ff |
| tags | |
| updated_at | 2016-05-04T19:27:34Z |
+---------------------------+----------------------------------------------------------------------------+
$ openstack server create --image cirros --flavor 42 \ $ openstack server create --image cirros --flavor 42 \
--nic net-id=38c5e950-b450-4c30-83d4-ee181c28aad3 my_vm --nic net-id=38c5e950-b450-4c30-83d4-ee181c28aad3 my_vm
@ -358,40 +397,51 @@ allocated for the instance:
| 71fb4ac8-eed8-4644-8113-0641962bb125 | my_vm | ACTIVE | - | Running | private=fda4:653e:71b0:0:f816:3eff:fe24:8614, 192.0.2.16 | cirros | | 71fb4ac8-eed8-4644-8113-0641962bb125 | my_vm | ACTIVE | - | Running | private=fda4:653e:71b0:0:f816:3eff:fe24:8614, 192.0.2.16 | cirros |
+--------------------------------------+-------+--------+------------+-------------+----------------------------------------------------------+------------+ +--------------------------------------+-------+--------+------------+-------------+----------------------------------------------------------+------------+
$ neutron port-list --device_id 71fb4ac8-eed8-4644-8113-0641962bb125 $ openstack port list --device-id 71fb4ac8-eed8-4644-8113-0641962bb125
+--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+-----------------------------------------------------------------------------------------------------+--------+
| id | name | mac_address | fixed_ips | | ID | Name | MAC Address | Fixed IP Addresses | Status |
+--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+-----------------------------------------------------------------------------------------------------+--------+
| 1e7033fb-8e9d-458b-89ed-8312cafcfdcb | | fa:16:3e:24:86:14 | {"subnet_id": "5b9282a1-0be1-4ade-b478-7868ad2a16ff", "ip_address": "192.0.2.16"} | | 1e7033fb-8e9d-458b-89ed-8312cafcfdcb | | fa:16:3e:24:86:14 | ip_address='192.0.2.16', subnet_id='5b9282a1-0be1-4ade-b478-7868ad2a16ff' | ACTIVE |
| | | | {"subnet_id": "43414c53-62ae-49bc-aa6c-c9dd7705818a", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe24:8614"} | | | | | ip_address='fda4:653e:71b0:0:f816:3eff:fe24:8614', subnet_id='43414c53-62ae-49bc-aa6c-c9dd7705818a' | |
+--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+-----------------------------------------------------------------------------------------------------+--------+
$ neutron port-show 1e7033fb-8e9d-458b-89ed-8312cafcfdcb $ openstack port show 1e7033fb-8e9d-458b-89ed-8312cafcfdcb
+-----------------------+-------------------------------------------------------------------------------------------------------------+ +-----------------------+------------------------------------------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-----------------------+-------------------------------------------------------------------------------------------------------------+ +-----------------------+------------------------------------------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| allowed_address_pairs | | | allowed_address_pairs | |
| binding:vnic_type | normal | | binding_host_id | vultr.guest |
| device_id | 71fb4ac8-eed8-4644-8113-0641962bb125 | | binding_profile | |
| device_owner | compute:None | | binding_vif_details | datapath_type='system', ovs_hybrid_plug='True', port_filter='True' |
| dns_assignment | {"hostname": "my-vm", "ip_address": "192.0.2.16", "fqdn": "my-vm.example.org."} | | binding_vif_type | ovs |
| | {"hostname": "my-vm", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe24:8614", "fqdn": "my-vm.example.org."} | | binding_vnic_type | normal |
| dns_name | my-vm | | created_at | 2016-02-15T19:42:44Z |
| extra_dhcp_opts | | | data_plane_status | None |
| fixed_ips | {"subnet_id": "5b9282a1-0be1-4ade-b478-7868ad2a16ff", "ip_address": "192.0.2.16"} | | description | |
| | {"subnet_id": "43414c53-62ae-49bc-aa6c-c9dd7705818a", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe24:8614"} | | device_id | 71fb4ac8-eed8-4644-8113-0641962bb125 |
| id | 1e7033fb-8e9d-458b-89ed-8312cafcfdcb | | device_owner | compute:None |
| mac_address | fa:16:3e:24:86:14 | | dns_assignment | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='192.0.2.16' |
| name | | | | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='fda4:653e:71b0:0:f816:3eff:fe24:8614' |
| network_id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | | dns_domain | example.org. |
| port_security_enabled | True | | dns_name | my-vm |
| revision_number | 1 | | extra_dhcp_opts | |
| security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | | fixed_ips | ip_address='192.0.2.16', subnet_id='5b9282a1-0be1-4ade-b478-7868ad2a16ff' |
| status | ACTIVE | | | ip_address='fda4:653e:71b0:0:f816:3eff:fe24:8614', subnet_id='43414c53-62ae-49bc-aa6c-c9dd7705818a' |
| tags | [] | | id | 1e7033fb-8e9d-458b-89ed-8312cafcfdcb |
| tenant_id | d5660cb1e6934612a01b4fb2fb630725 | | mac_address | fa:16:3e:24:86:14 |
+-----------------------+-------------------------------------------------------------------------------------------------------------+ | name | |
| network_id | 38c5e950-b450-4c30-83d4-ee181c28aad3 |
| port_security_enabled | True |
| project_id | d5660cb1e6934612a01b4fb2fb630725 |
| qos_policy_id | None |
| revision_number | 1 |
| security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 |
| status | ACTIVE |
| tags | |
| trunk_details | None |
| updated_at | 2016-02-15T19:42:44Z |
+-----------------------+------------------------------------------------------------------------------------------------------------+
$ openstack recordset list example.org. $ openstack recordset list example.org.
+--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+ +--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+
@ -483,46 +533,51 @@ external DNS service. This is an example:
.. code-block:: console .. code-block:: console
$ neutron net-list $ openstack network list
+--------------------------------------+----------+----------------------------------------------------------+ +--------------------------------------+----------+-----------------------------------------------------------------------------+
| id | name | subnets | | ID | Name | Subnets |
+--------------------------------------+----------+----------------------------------------------------------+ +--------------------------------------+----------+-----------------------------------------------------------------------------+
| 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a | public | a67cfdf7-9d5d-406f-8a19-3f38e4fc3e74 | | 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a | public | a67cfdf7-9d5d-406f-8a19-3f38e4fc3e74, cbd8c6dc-ca81-457e-9c5d-f8ece7ef67f8 |
| | | cbd8c6dc-ca81-457e-9c5d-f8ece7ef67f8 | | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | external | 277eca5d-9869-474b-960e-6da5951d09f7, eab47748-3f0a-4775-a09f-b0c24bb64bc4 |
| 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | external | 277eca5d-9869-474b-960e-6da5951d09f7 203.0.113.0/24 | | bf2802a0-99a0-4e8c-91e4-107d03f158ea | my-net | 6141b474-56cd-430f-b731-71660bb79b79 |
| | | eab47748-3f0a-4775-a09f-b0c24bb64bc4 2001:db8:10::/64 | | 38c5e950-b450-4c30-83d4-ee181c28aad3 | private | 43414c53-62ae-49bc-aa6c-c9dd7705818a, 5b9282a1-0be1-4ade-b478-7868ad2a16ff |
| bf2802a0-99a0-4e8c-91e4-107d03f158ea | my-net | 6141b474-56cd-430f-b731-71660bb79b79 192.0.2.64/26 | +--------------------------------------+----------+-----------------------------------------------------------------------------+
| 38c5e950-b450-4c30-83d4-ee181c28aad3 | private | 43414c53-62ae-49bc-aa6c-c9dd7705818a fda4:653e:71b0::/64 |
| | | 5b9282a1-0be1-4ade-b478-7868ad2a16ff 192.0.2.0/26 |
+--------------------------------------+----------+----------------------------------------------------------+
$ neutron net-update 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 --dns_domain example.org. $ neutron net-update 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 --dns_domain example.org.
Updated network: 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 Updated network: 37aaff3a-6047-45ac-bf4f-a825e56fd2b3
$ neutron net-show 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 $ openstack network show 37aaff3a-6047-45ac-bf4f-a825e56fd2b3
+---------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+---------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| availability_zone_hints | | | availability_zone_hints | |
| availability_zones | nova | | availability_zones | nova |
| dns_domain | example.org. | | created_at | 2016-02-14T19:42:44Z |
| id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | | description | |
| mtu | 1450 | | dns_domain | example.org. |
| name | external | | id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 |
| port_security_enabled | True | | ipv4_address_scope | None |
| provider:network_type | vlan | | ipv6_address_scope | None |
| provider:physical_network | | | is_default | None |
| provider:segmentation_id | 2016 | | is_vlan_transparent | None |
| revision_number | 4 | | mtu | 1450 |
| router:external | False | | name | external |
| shared | True | | port_security_enabled | True |
| status | ACTIVE | | project_id | 04fc2f83966245dba907efb783f8eab9 |
| subnets | eab47748-3f0a-4775-a09f-b0c24bb64bc4 | | provider:network_type | vlan |
| | 277eca5d-9869-474b-960e-6da5951d09f7 | | provider:physical_network | None |
| tags | [] | | provider:segmentation_id | 2016 |
| tenant_id | 04fc2f83966245dba907efb783f8eab9 | | qos_policy_id | None |
+---------------------------+--------------------------------------+ | revision_number | 4 |
| router:external | Internal |
| segments | None |
| shared | True |
| status | ACTIVE |
| subnets | eab47748-3f0a-4775-a09f-b0c24bb64bc4, 277eca5d-9869-474b-960e-6da5951d09f7 |
| tags | |
| updated_at | 2016-02-15T13:42:44Z |
+---------------------------+----------------------------------------------------------------------------+
$ openstack recordset list example.org. $ openstack recordset list example.org.
+--------------------------------------+--------------+------+-----------------------------------------------------------------------+--------+--------+ +--------------------------------------+--------------+------+-----------------------------------------------------------------------+--------+--------+
@ -532,32 +587,43 @@ external DNS service. This is an example:
| e7c05a5d-83a0-4fe5-8bd5-ab058a3326aa | example.org. | SOA | ns1.devstack.org. malavall.us.ibm.com. 1513767619 3532 600 86400 3600 | ACTIVE | NONE | | e7c05a5d-83a0-4fe5-8bd5-ab058a3326aa | example.org. | SOA | ns1.devstack.org. malavall.us.ibm.com. 1513767619 3532 600 86400 3600 | ACTIVE | NONE |
+--------------------------------------+--------------+------+-----------------------------------------------------------------------+--------+--------+ +--------------------------------------+--------------+------+-----------------------------------------------------------------------+--------+--------+
$ neutron port-create 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 --dns_name my-vm $ openstack port create --network 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 --dns-name my-vm test
Created a new port: +-----------------------+-------------------------------------------------------------------------------+
+-----------------------+---------------------------------------------------------------------------------------+ | Field | Value |
| Field | Value | +-----------------------+-------------------------------------------------------------------------------+
+-----------------------+---------------------------------------------------------------------------------------+ | admin_state_up | UP |
| admin_state_up | True | | allowed_address_pairs | |
| allowed_address_pairs | | | binding_host_id | |
| binding:vnic_type | normal | | binding_profile | |
| device_id | | | binding_vif_details | |
| device_owner | | | binding_vif_type | unbound |
| dns_assignment | {"hostname": "my-vm", "ip_address": "203.0.113.9", "fqdn": "my-vm.example.org."} | | binding_vnic_type | normal |
| | {"hostname": "my-vm", "ip_address": "2001:db8:10::9", "fqdn": "my-vm.example.org."} | | created_at | 2016-02-15T16:42:44Z |
| dns_name | my-vm | | data_plane_status | None |
| fixed_ips | {"subnet_id": "277eca5d-9869-474b-960e-6da5951d09f7", "ip_address": "203.0.113.9"} | | description | |
| | {"subnet_id": "eab47748-3f0a-4775-a09f-b0c24bb64bc4", "ip_address": "2001:db8:10::9"} | | device_id | |
| id | 04be331b-dc5e-410a-9103-9c8983aeb186 | | device_owner | |
| mac_address | fa:16:3e:0f:4b:e4 | | dns_assignment | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='203.0.113.9' |
| name | | | | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='2001:db8:10::9' |
| network_id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | | dns_domain | None |
| port_security_enabled | True | | dns_name | my-vm |
| revision_number | 1 | | extra_dhcp_opts | |
| security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | | fixed_ips | ip_address='203.0.113.9', subnet_id='277eca5d-9869-474b-960e-6da5951d09f7' |
| status | DOWN | | | ip_address='2001:db8:10::9', subnet_id=‘eab47748-3f0a-4775-a09f-b0c24bb64bc4’ |
| tags | [] | | id | 04be331b-dc5e-410a-9103-9c8983aeb186 |
| tenant_id | d5660cb1e6934612a01b4fb2fb630725 | | mac_address | fa:16:3e:0f:4b:e4 |
+-----------------------+---------------------------------------------------------------------------------------+ | name | test |
| network_id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 |
| port_security_enabled | True |
| project_id | d5660cb1e6934612a01b4fb2fb630725 |
| qos_policy_id | None |
| revision_number | 1 |
| security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 |
| status | DOWN |
| tags | |
| trunk_details | None |
| updated_at | 2016-02-15T16:42:44Z |
+-----------------------+-------------------------------------------------------------------------------+
$ openstack recordset list example.org. $ openstack recordset list example.org.
+--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+ +--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+

135
doc/source/admin/config-dns-int.rst
View File

@ -93,29 +93,41 @@ in its ``dns_name`` attribute.
.. code-block:: console .. code-block:: console
$ neutron port-create my-net --dns-name my-port $ openstack port create --network my-net --dns-name my-port test
Created a new port: +-----------------------+-------------------------------------------------------------------------------+
+-----------------------+-------------------------------------------------------------------------------------+ | Field | Value |
| Field | Value | +-----------------------+-------------------------------------------------------------------------------+
+-----------------------+-------------------------------------------------------------------------------------+ | admin_state_up | UP |
| admin_state_up | True | | allowed_address_pairs | |
| allowed_address_pairs | | | binding_host_id | |
| binding:vnic_type | normal | | binding_profile | |
| device_id | | | binding_vif_details | |
| device_owner | | | binding_vif_type | unbound |
| dns_assignment | {"hostname": "my-port", "ip_address": "192.0.2.67", "fqdn": "my-port.example.org."} | | binding_vnic_type | normal |
| dns_name | my-port | | created_at | 2016-02-05T21:35:04Z |
| fixed_ips | {"subnet_id":"6141b474-56cd-430f-b731-71660bb79b79", "ip_address": "192.0.2.67"} | | data_plane_status | None |
| id | fb3c10f4-017e-420c-9be1-8f8c557ae21f | | description | |
| mac_address | fa:16:3e:aa:9b:e1 | | device_id | |
| name | | | device_owner | |
| network_id | bf2802a0-99a0-4e8c-91e4-107d03f158ea | | dns_assignment | fqdn='my-port.example.org.', hostname='my-port', ip_address='192.0.2.67' |
| port_security_enabled | True | | dns_domain | None |
| revision_number | 1 | | dns_name | my-port |
| security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | | extra_dhcp_opts | |
| status | DOWN | | fixed_ips | ip_address='192.0.2.67', subnet_id='6141b474-56cd-430f-b731-71660bb79b79' |
| tenant_id | d5660cb1e6934612a01b4fb2fb630725 | | id | fb3c10f4-017e-420c-9be1-8f8c557ae21f |
+-----------------------+-------------------------------------------------------------------------------------+ | mac_address | fa:16:3e:aa:9b:e1 |
| name | test |
| network_id | bf2802a0-99a0-4e8c-91e4-107d03f158ea |
| port_security_enabled | True |
| project_id | d5660cb1e6934612a01b4fb2fb630725 |
| qos_policy_id | None |
| revision_number | 1 |
| security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 |
| status | DOWN |
| tags | |
| trunk_details | None |
| updated_at | 2016-02-05T21:35:04Z |
+-----------------------+-------------------------------------------------------------------------------+
When this functionality is enabled, it is leveraged by the Compute service when When this functionality is enabled, it is leveraged by the Compute service when
creating instances. When allocating ports for an instance during boot, the creating instances. When allocating ports for an instance during boot, the
@ -164,40 +176,51 @@ The following is an example of an instance creation, showing how its
| user_id | 8bb6e578cba24e7db9d3810633124525 | | user_id | 8bb6e578cba24e7db9d3810633124525 |
+--------------------------------------+----------------------------------------------------------------+ +--------------------------------------+----------------------------------------------------------------+
$ neutron port-list --device_id 66c13cb4-3002-4ab3-8400-7efc2659c363 $ openstack port list --device-id 66c13cb4-3002-4ab3-8400-7efc2659c363
+--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+--------+
| id | name | mac_address | fixed_ips | | ID | Name | MAC Address | Fixed IP Addresses | Status |
+--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+--------+
| b3ecc464-1263-44a7-8c38-2d8a52751773 | | fa:16:3e:a8:ce:b8 | {"subnet_id": "277eca5d-9869-474b-960e-6da5951d09f7", "ip_address": "203.0.113.8"} | | b3ecc464-1263-44a7-8c38-2d8a52751773 | | fa:16:3e:a8:ce:b8 | ip_address='203.0.113.8', subnet_id='277eca5d-9869-474b-960e-6da5951d09f7' | ACTIVE |
| | | | {"subnet_id": "eab47748-3f0a-4775-a09f-b0c24bb64bc4", "ip_address":"2001:db8:10::8"} | | | | | ip_address='2001:db8:10::8', subnet_id='eab47748-3f0a-4775-a09f-b0c24bb64bc4' | |
+--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+ +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+--------+
$ neutron port-show b3ecc464-1263-44a7-8c38-2d8a52751773 $ openstack port show b3ecc464-1263-44a7-8c38-2d8a52751773
+-----------------------+---------------------------------------------------------------------------------------+ +-----------------------+------------------------------------------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-----------------------+---------------------------------------------------------------------------------------+ +-----------------------+------------------------------------------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| allowed_address_pairs | | | allowed_address_pairs | |
| binding:vnic_type | normal | | binding_host_id | vultr.guest |
| device_id | 66c13cb4-3002-4ab3-8400-7efc2659c363 | | binding_profile | |
| device_owner | compute:None | | binding_vif_details | datapath_type='system', ovs_hybrid_plug='True', port_filter='True' |
| dns_assignment | {"hostname": "my-vm", "ip_address": "203.0.113.8", "fqdn": "my-vm.example.org."} | | binding_vif_type | ovs |
| | {"hostname": "my-vm", "ip_address": "2001:db8:10::8", "fqdn": "my-vm.example.org."} | | binding_vnic_type | normal |
| dns_name | my-vm | | created_at | 2016-02-05T21:35:04Z |
| extra_dhcp_opts | | | data_plane_status | None |
| fixed_ips | {"subnet_id": "277eca5d-9869-474b-960e-6da5951d09f7", "ip_address": "203.0.113.8"} | | description | |
| | {"subnet_id": "eab47748-3f0a-4775-a09f-b0c24bb64bc4", "ip_address": "2001:db8:10::8"} | | device_id | 66c13cb4-3002-4ab3-8400-7efc2659c363 |
| id | b3ecc464-1263-44a7-8c38-2d8a52751773 | | device_owner | compute:None |
| mac_address | fa:16:3e:a8:ce:b8 | | dns_assignment | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='203.0.113.8' |
| name | | | | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='2001:db8:10::8' |
| network_id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | | dns_domain | example.org. |
| port_security_enabled | True | | dns_name | my-vm |
| revision_number | 1 | | extra_dhcp_opts | |
| security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | | fixed_ips | ip_address='203.0.113.8', subnet_id='277eca5d-9869-474b-960e-6da5951d09f7' |
| status | ACTIVE | | | ip_address='2001:db8:10::8', subnet_id='eab47748-3f0a-4775-a09f-b0c24bb64bc4' |
| tags | [] | | id | b3ecc464-1263-44a7-8c38-2d8a52751773 |
| tenant_id | d5660cb1e6934612a01b4fb2fb630725 | | mac_address | fa:16:3e:a8:ce:b8 |
+-----------------------+---------------------------------------------------------------------------------------+ | name | |
| network_id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 |
| port_security_enabled | True |
| project_id | d5660cb1e6934612a01b4fb2fb630725 |
| qos_policy_id | None |
| revision_number | 1 |
| security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 |
| status | ACTIVE |
| tags | |
| trunk_details | None |
| updated_at | 2016-02-05T21:35:04Z |
+-----------------------+------------------------------------------------------------------------------------------------------------+
In the above example notice that: In the above example notice that:

4
doc/source/admin/config-dvr-ha-snat.rst
View File

@ -72,13 +72,13 @@ Controller node configuration
(DVR HA). (DVR HA).
The same can explicitly be accomplished by a user with administrative The same can explicitly be accomplished by a user with administrative
credentials setting the flags in the :command:`neutron router-create` credentials setting the flags in the :command:`openstack router create`
command: command:
.. code-block:: console .. code-block:: console
$ neutron router-create name-of-router --distributed=True --ha=True $ openstack router create name-of-router --distributed --ha
.. note:: .. note::

2
doc/source/admin/config-rbac.rst
View File

@ -259,7 +259,7 @@ command:
+-------------------------------+-------------+--------------------------------+ +-------------------------------+-------------+--------------------------------+
Use the :command:`neutron rbac-show` command to see the details: Use the :command:`openstack network rbac show` command to see the details:
.. code-block:: console .. code-block:: console

6
doc/source/admin/config-service-subnets.rst
View File

@ -258,7 +258,7 @@ This example uses again the private network, ``demo-net1``
.. code-block:: console .. code-block:: console
$ neutron router-gateway-set demo-router demo-ext-net $ openstack router set --external-gateway demo-ext-net demo-router
#. Launch an instance on a private network and retrieve the neutron #. Launch an instance on a private network and retrieve the neutron
port ID that was allocated. As above, use the ``cirros`` port ID that was allocated. As above, use the ``cirros``
@ -306,7 +306,7 @@ This example uses again the private network, ``demo-net1``
.. code-block:: console .. code-block:: console
$ neutron port-show f148ffeb-3c26-4067-bc5f-5c3dfddae2f5 $ openstack port show f148ffeb-3c26-4067-bc5f-5c3dfddae2f5
+-----------------------+--------------------------------------------------------------------------+ +-----------------------+--------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-----------------------+--------------------------------------------------------------------------+ +-----------------------+--------------------------------------------------------------------------+
@ -329,7 +329,7 @@ This example uses again the private network, ``demo-net1``
.. code-block:: console .. code-block:: console
$ neutron port-show a2d1e756-8ae1-4f96-9aa1-e7ea16a6a68a $ openstack port show a2d1e756-8ae1-4f96-9aa1-e7ea16a6a68a
+-----------------------+--------------------------------------------------------------------------+ +-----------------------+--------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-----------------------+--------------------------------------------------------------------------+ +-----------------------+--------------------------------------------------------------------------+

237
doc/source/admin/ops-resource-tags.rst
View File

@ -112,106 +112,153 @@ Add a tag to a resource:
.. code-block:: console .. code-block:: console
$ neutron tag-add --resource-type network --resource ab442634-1cc9-49e5-bd49-0dac9c811f69 --tag red $ openstack network set --tag red ab442634-1cc9-49e5-bd49-0dac9c811f69
$ neutron net-show net $ openstack network show net
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| availability_zone_hints | | | availability_zone_hints | |
| availability_zones | | | availability_zones | nova |
| id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | | created_at | 2018-07-11T09:44:50Z |
| ipv4_address_scope | | | description | |
| ipv6_address_scope | | | dns_domain | None |
| mtu | 1450 | | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 |
| name | net | | ipv4_address_scope | None |
| port_security_enabled | True | | ipv6_address_scope | None |
| router:external | False | | is_default | None |
| shared | False | | is_vlan_transparent | None |
| status | ACTIVE | | mtu | 1450 |
| subnets | | | name | net |
| tags | red | | port_security_enabled | True |
| tenant_id | e6710680bfd14555891f265644e1dd5c | | project_id | e6710680bfd14555891f265644e1dd5c |
+-------------------------+--------------------------------------+ | provider:network_type | vxlan |
| provider:physical_network | None |
| provider:segmentation_id | 1047 |
| qos_policy_id | None |
| revision_number | 5 |
| router:external | Internal |
| segments | None |
| shared | False |
| status | ACTIVE |
| subnets | |
| tags | red |
| updated_at | 2018-07-16T06:22:01Z |
+---------------------------+----------------------------------------------------------------------------+
Remove a tag from a resource: Remove a tag from a resource:
.. code-block:: console .. code-block:: console
$ neutron tag-remove --resource-type network --resource ab442634-1cc9-49e5-bd49-0dac9c811f69 --tag red $ openstack network unset --tag red ab442634-1cc9-49e5-bd49-0dac9c811f69
$ neutron net-show net $ openstack network show net
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| availability_zone_hints | | | availability_zone_hints | |
| availability_zones | | | availability_zones | nova |
| id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | | created_at | 2018-07-11T09:44:50Z |
| ipv4_address_scope | | | description | |
| ipv6_address_scope | | | dns_domain | None |
| mtu | 1450 | | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 |
| name | net | | ipv4_address_scope | None |
| port_security_enabled | True | | ipv6_address_scope | None |
| router:external | False | | is_default | None |
| shared | False | | is_vlan_transparent | None |
| status | ACTIVE | | mtu | 1450 |
| subnets | | | name | net |
| tags | | | port_security_enabled | True |
| tenant_id | e6710680bfd14555891f265644e1dd5c | | project_id | e6710680bfd14555891f265644e1dd5c |
+-------------------------+--------------------------------------+ | provider:network_type | vxlan |
| provider:physical_network | None |
| provider:segmentation_id | 1047 |
| qos_policy_id | None |
| revision_number | 5 |
| router:external | Internal |
| segments | None |
| shared | False |
| status | ACTIVE |
| subnets | |
| tags | |
| updated_at | 2018-07-16T06:32:11Z |
+---------------------------+----------------------------------------------------------------------------+
Replace all tags on the resource: Replace all tags on the resource:
.. code-block:: console .. code-block:: console
$ neutron tag-replace --resource-type network --resource ab442634-1cc9-49e5-bd49-0dac9c811f69 --tag red --tag blue $ openstack network set --tag red --tag blue ab442634-1cc9-49e5-bd49-0dac9c811f69
$ neutron net-show net $ openstack network show net
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| availability_zone_hints | | | availability_zone_hints | |
| availability_zones | | | availability_zones | nova |
| id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | | created_at | 2018-07-11T09:44:50Z |
| ipv4_address_scope | | | description | |
| ipv6_address_scope | | | dns_domain | None |
| mtu | 1450 | | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 |
| name | net | | ipv4_address_scope | None |
| port_security_enabled | True | | ipv6_address_scope | None |
| router:external | False | | is_default | None |
| shared | False | | is_vlan_transparent | None |
| status | ACTIVE | | mtu | 1450 |
| subnets | | | name | net |
| tags | red | | port_security_enabled | True |
| | blue | | project_id | e6710680bfd14555891f265644e1dd5c |
| tenant_id | e6710680bfd14555891f265644e1dd5c | | provider:network_type | vxlan |
+-------------------------+--------------------------------------+ | provider:physical_network | None |
| provider:segmentation_id | 1047 |
| qos_policy_id | None |
| revision_number | 5 |
| router:external | Internal |
| segments | None |
| shared | False |
| status | ACTIVE |
| subnets | |
| tags | blue, red |
| updated_at | 2018-07-16T06:50:19Z |
+---------------------------+----------------------------------------------------------------------------+
Clear tags from a resource: Clear tags from a resource:
.. code-block:: console .. code-block:: console
$ neutron tag-remove --resource-type network --resource ab442634-1cc9-49e5-bd49-0dac9c811f69 --all $ openstack network unset --all-tag ab442634-1cc9-49e5-bd49-0dac9c811f69
$ neutron net-show net $ openstack network show net
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| Field | Value | | Field | Value |
+-------------------------+--------------------------------------+ +---------------------------+----------------------------------------------------------------------------+
| admin_state_up | True | | admin_state_up | UP |
| availability_zone_hints | | | availability_zone_hints | |
| availability_zones | | | availability_zones | nova |
| id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | | created_at | 2018-07-11T09:44:50Z |
| ipv4_address_scope | | | description | |
| ipv6_address_scope | | | dns_domain | None |
| mtu | 1450 | | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 |
| name | net | | ipv4_address_scope | None |
| port_security_enabled | True | | ipv6_address_scope | None |
| router:external | False | | is_default | None |
| shared | False | | is_vlan_transparent | None |
| status | ACTIVE | | mtu | 1450 |
| subnets | | | name | net |
| tags | | | port_security_enabled | True |
| tenant_id | e6710680bfd14555891f265644e1dd5c | | project_id | e6710680bfd14555891f265644e1dd5c |
+-------------------------+--------------------------------------+ | provider:network_type | vxlan |
| provider:physical_network | None |
| provider:segmentation_id | 1047 |
| qos_policy_id | None |
| revision_number | 5 |
| router:external | Internal |
| segments | None |
| shared | False |
| status | ACTIVE |
| subnets | |
| tags | |
| updated_at | 2018-07-16T07:03:02Z |
+---------------------------+----------------------------------------------------------------------------+
Get list of resources with tag filters from networks. The networks are: Get list of resources with tag filters from networks. The networks are:
test-net1 with "red" tag, test-net2 with "red" and "blue" tags, test-net3 with test-net1 with "red" tag, test-net2 with "red" and "blue" tags, test-net3 with
@ -221,21 +268,21 @@ Get list of resources with ``tags`` filter:
.. code-block:: console .. code-block:: console
$ neutron net-list --tags red,blue $ openstack network list --tags red,blue
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
| id | name | subnets | | ID | Name | Subnets |
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
| 8ca3b9ed-f578-45fa-8c44-c53f13aec05a | test-net3 | | | 8ca3b9ed-f578-45fa-8c44-c53f13aec05a | test-net3 | |
| e736e63d-42e4-4f4c-836c-6ad286ffd68a | test-net2 | | | e736e63d-42e4-4f4c-836c-6ad286ffd68a | test-net2 | |
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
Get list of resources with ``tags-any`` filter: Get list of resources with ``any-tags`` filter:
.. code-block:: console .. code-block:: console
$ neutron net-list --tags-any red,blue $ openstack network list --any-tags red,blue
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
| id | name | subnets | | ID | Name | Subnets |
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
| 30491224-3855-431f-a688-fb29df004d82 | test-net1 | | | 30491224-3855-431f-a688-fb29df004d82 | test-net1 | |
| 8ca3b9ed-f578-45fa-8c44-c53f13aec05a | test-net3 | | | 8ca3b9ed-f578-45fa-8c44-c53f13aec05a | test-net3 | |
@ -246,21 +293,21 @@ Get list of resources with ``not-tags`` filter:
.. code-block:: console .. code-block:: console
$ neutron net-list --not-tags red,blue $ openstack network list --not-tags red,blue
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
| id | name | subnets | | ID | Name | Subnets |
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
| 30491224-3855-431f-a688-fb29df004d82 | test-net1 | | | 30491224-3855-431f-a688-fb29df004d82 | test-net1 | |
| cdb3ed08-ca63-4090-ba12-30b366372993 | test-net4 | | | cdb3ed08-ca63-4090-ba12-30b366372993 | test-net4 | |
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
Get list of resources with ``not-tags-any`` filter: Get list of resources with ``not-any-tags`` filter:
.. code-block:: console .. code-block:: console
$ neutron net-list --not-tags-any red,blue $ openstack network list --not-any-tags red,blue
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
| id | name | subnets | | ID | Name | Subnets |
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+
| cdb3ed08-ca63-4090-ba12-30b366372993 | test-net4 | | | cdb3ed08-ca63-4090-ba12-30b366372993 | test-net4 | |
+--------------------------------------+-----------+---------+ +--------------------------------------+-----------+---------+

3
doc/source/admin/shared/deploy-ha-vrrp-initialnetworks.txt
View File

@ -92,5 +92,4 @@ on that router.
.. code-block:: console .. code-block:: console
$ neutron router-gateway-set router2 provider1 $ openstack router set --external-gateway provider1 router2
Set gateway for router router2

3
doc/source/admin/shared/deploy-selfservice-initialnetworks.txt
View File

@ -105,5 +105,4 @@ NAT for IPv4 network traffic and directly routes IPv6 network traffic.
.. code-block:: console .. code-block:: console
$ neutron router-gateway-set router1 provider1 $ openstack router set --external-gateway provider1 router1
Set gateway for router router1