Update dns_assignment attribute documentation
After the implementation of [1], the calculation of the port's
dns_assignment attribute changed for some use cases of the Neutron
integration with an external DNS service. This change updates the
documentation accordingly
[1] https://specs.openstack.org/openstack/neutron-specs/specs/victoria/port_dns_assignment.html
Partial-Bug: #1956632
Change-Id: I1c8c6850faa7741afabe31889cdad0228a366310
(cherry picked from commit 94b961f179)
This commit is contained in:
Miguel Lavalle
Miguel Lavalle
parent
c79398a446
commit
1727d0c26c
@ -927,3 +927,85 @@ meet the following requirements:
|
|||||||
This usually implies that these use cases only work for networks specifically
|
This usually implies that these use cases only work for networks specifically
|
||||||
created for this purpose by an admin, they do not work for networks
|
created for this purpose by an admin, they do not work for networks
|
||||||
which tenants can create on their own.
|
which tenants can create on their own.
|
||||||
|
|
||||||
|
.. _config-dns-int-ext-dns-assignment:
|
||||||
|
|
||||||
|
The port's ``dns_assignment`` attribute with use case 3
|
||||||
|
-------------------------------------------------------
|
||||||
|
|
||||||
|
The ``dns_assignment`` attribute is not calculated as described in
|
||||||
|
:ref:`config-dns-int` when a port is created under use case 3. Instead of
|
||||||
|
concatenating the port's ``dns_name`` with the value configured
|
||||||
|
in the ``dns_domain`` parameter in ``neutron.conf``, the ``dns_name`` is
|
||||||
|
concatenated with the ``dns_domain`` of either the port or the network,
|
||||||
|
depending on whether the use case is 3a, 3b or 3c. For example:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ openstack network show external -c dns_domain -f value
|
||||||
|
dns-domain-1.org.
|
||||||
|
$ cat /etc/neutron/neutron.conf | grep dns_domain
|
||||||
|
dns_domain = my-domain.org
|
||||||
|
$ openstack recordset list dns-domain-1.org.
|
||||||
|
+--------------------------------------+-------------------+------+-----------------------------------------------------------------------+--------+--------+
|
||||||
|
| id | name | type | records | status | action |
|
||||||
|
+--------------------------------------+-------------------+------+-----------------------------------------------------------------------+--------+--------+
|
||||||
|
| 2b3e9ea4-8035-4595-955d-ec8c55816111 | dns-domain-1.org. | SOA | ns1.devstack.org. mlavalle.redhat.com. 1642583355 3517 600 86400 3600 | ACTIVE | NONE |
|
||||||
|
| 801dd911-43e6-430a-a80b-ea09af76a9a4 | dns-domain-1.org. | NS | ns1.devstack.org. | ACTIVE | NONE |
|
||||||
|
+--------------------------------------+-------------------+------+-----------------------------------------------------------------------+--------+--------+
|
||||||
|
$ openstack port create --dns-name a-port --network external a_port
|
||||||
|
+-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
|
| Field | Value |
|
||||||
|
+-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
|
| admin_state_up | UP |
|
||||||
|
| allowed_address_pairs | |
|
||||||
|
| binding_host_id | None |
|
||||||
|
| binding_profile | None |
|
||||||
|
| binding_vif_details | None |
|
||||||
|
| binding_vif_type | None |
|
||||||
|
| binding_vnic_type | normal |
|
||||||
|
| created_at | 2022-01-19T09:15:34Z |
|
||||||
|
| data_plane_status | None |
|
||||||
|
| description | |
|
||||||
|
| device_id | |
|
||||||
|
| device_owner | |
|
||||||
|
| device_profile | None |
|
||||||
|
| dns_assignment | fqdn='a-port.dns-domain-1.org.', hostname='a-port', ip_address='172.31.251.113' |
|
||||||
|
| | fqdn='a-port.dns-domain-1.org.', hostname='a-port', ip_address='fd5e:7a6b:1a62::a3' |
|
||||||
|
| dns_domain | |
|
||||||
|
| dns_name | a-port |
|
||||||
|
| extra_dhcp_opts | |
|
||||||
|
| fixed_ips | ip_address='172.31.251.113', subnet_id='6795a775-4a76-49b0-bac6-ba8a8b62bd22' |
|
||||||
|
| | ip_address='fd5e:7a6b:1a62::a3', subnet_id='97b719f8-2307-4162-bf08-523d9c0fc6a9' |
|
||||||
|
| id | 080f01e7-78b9-43ed-a807-1e0d59099bed |
|
||||||
|
| ip_allocation | None |
|
||||||
|
| location | Munch({'cloud': '', 'region_name': 'RegionOne', 'zone': None, 'project': Munch({'id': 'afc55714081b4ef29f99ec128cb1fa30', 'name': 'demo', 'domain_id': 'default', 'domain_name': None})}) |
|
||||||
|
| mac_address | fa:16:3e:4d:fa:33 |
|
||||||
|
| name | a_port |
|
||||||
|
| network_id | 2d696f10-97a4-454c-a411-ea8d4d685636 |
|
||||||
|
| numa_affinity_policy | None |
|
||||||
|
| port_security_enabled | True |
|
||||||
|
| project_id | afc55714081b4ef29f99ec128cb1fa30 |
|
||||||
|
| propagate_uplink_status | None |
|
||||||
|
| qos_network_policy_id | None |
|
||||||
|
| qos_policy_id | None |
|
||||||
|
| resource_request | None |
|
||||||
|
| revision_number | 1 |
|
||||||
|
| security_group_ids | 1a350403-cad3-4a2d-b30a-73815bd96e0f |
|
||||||
|
| status | DOWN |
|
||||||
|
| tags | |
|
||||||
|
| trunk_details | None |
|
||||||
|
| updated_at | 2022-01-19T09:15:34Z |
|
||||||
|
+-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
|
$ openstack recordset list dns-domain-1.org.
|
||||||
|
+--------------------------------------+--------------------------+------+-----------------------------------------------------------------------+--------+--------+
|
||||||
|
| id | name | type | records | status | action |
|
||||||
|
+--------------------------------------+--------------------------+------+-----------------------------------------------------------------------+--------+--------+
|
||||||
|
| 2b3e9ea4-8035-4595-955d-ec8c55816111 | dns-domain-1.org. | SOA | ns1.devstack.org. mlavalle.redhat.com. 1642583736 3517 600 86400 3600 | ACTIVE | NONE |
|
||||||
|
| 801dd911-43e6-430a-a80b-ea09af76a9a4 | dns-domain-1.org. | NS | ns1.devstack.org. | ACTIVE | NONE |
|
||||||
|
| 61597628-dafe-4aba-8e30-1d45b4e59874 | a-port.dns-domain-1.org. | AAAA | fd5e:7a6b:1a62::a3 | ACTIVE | NONE |
|
||||||
|
| 83fe489f-2ebc-4911-a67e-bef688833f31 | a-port.dns-domain-1.org. | A | 172.31.251.113 | ACTIVE | NONE |
|
||||||
|
+--------------------------------------+--------------------------+------+-----------------------------------------------------------------------+--------+--------+
|
||||||
|
|
||||||
|
In this manner, the ``FQDN`` in the ``dns_assignment`` attribute is compatible
|
||||||
|
with what is being published by the external DNS service.
|
||||||
|
|||||||
@ -235,3 +235,9 @@ In the above example notice that:
|
|||||||
must be equal to the value that Compute service will assign to the instance's
|
must be equal to the value that Compute service will assign to the instance's
|
||||||
``hostname``, in this example ``my-vm``. Otherwise, the instance boot will
|
``hostname``, in this example ``my-vm``. Otherwise, the instance boot will
|
||||||
fail.
|
fail.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
When the Networking service integration with an external DNS service is
|
||||||
|
enabled, a port's FQDN in the ``dns_assignment`` attribute will not be
|
||||||
|
calculated as described above in some well defined cases. For a description
|
||||||
|
of these cases please see :ref:`config-dns-int-ext-dns-assignment`.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user