Skip to content

Commit 65d6563

Browse files
markus-hentschfkr
authored andcommitted
Add extension driver design considerations
Signed-off-by: Markus Hentsch <[email protected]>
1 parent a2ecb14 commit 65d6563

File tree

1 file changed

+26
-3
lines changed

1 file changed

+26
-3
lines changed

Standards/scs-01xx-v1-dns.md

Lines changed: 26 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,24 @@ Regardless of whether clients within the cloud infrastructure individually suppo
6363
As such, the implementation of local DNS recursors in the infrastructure can be very beneficial.
6464
This standard should consider mandating or at least recommending the use of local DNS recursors for SCS clouds to be configured as the default DNS servers for Neutron resources.
6565

66+
#### Extension driver choices
67+
68+
There is a hierarchy of DNS extensions in the Networking API in which they supersede one another in terms of functionality:
69+
70+
- dns-integration
71+
- dns-domain-ports (includes functionality of dns-integration)
72+
- subnet-dns-publish-fixed-ip (includes functionality of dns-integration and dns-domain-ports)
73+
- dns-integration-domain-keywords (includes functionality of all of the above)
74+
75+
For example, to get the "subnet-dns-publish-fixed-ip" functionality, either "subnet-dns-publish-fixed-ip" or "dns-integration-domain-keywords" (which includes the former) must be activate.
76+
77+
Note that each API extension has a corresponding backend driver functionality associated to it.
78+
The availability of each API extension depends on the backend configuration and implementation.
79+
80+
As a result, the DNS functionalities and behaviors available to the customer vary depending on the individual backend configuration of the Networking API.
81+
Mandating or recommending the integration of specific drivers/extensions can therefore be crucial to establish specific DNS functionality baselines.
82+
On the other hand, some functionality might not be desired in contrast, such as the ability to publish arbitrary DNS records for fixed IP addresses in Neutron networks.
83+
6684
## Open questions
6785

6886
RECOMMENDED
@@ -96,10 +114,15 @@ The *DNS server setting* refers to the following:
96114

97115
#### DNS Extensions
98116

99-
In the Neutron configuration, the `dns_domain_ports` extension driver MUST be enabled to offer the full range of DNS settings for both ports and networks.
100-
Due to it being the successor to the old `dns` extension driver, the `dns` driver MUST NOT be enabled and needs to be removed from the `extension_drivers` setting, if that entry exists.
117+
In the Neutron configuration, one of the following extension drivers MUST be enabled to offer the full range of DNS settings for both ports and networks:
118+
119+
- `dns_domain_ports`
120+
- `subnet_dns_publish_fixed_ip`
121+
- `dns_domain_keywords`
122+
123+
Due to them being the successor to the old `dns` extension driver, the `dns` driver MUST NOT be enabled and needs to be removed from the `extension_drivers` setting, if that entry exists.
101124

102-
The extension driver setting is part of the ML2 plugin configuration:
125+
The extension driver setting is part of the ML2 plugin configuration (example for `dns_domain_ports`):
103126

104127
```
105128
[ml2]

0 commit comments

Comments
 (0)