OpenStack trên Kubernetes với Genestack – Phần 15: DNS-as-a-Service với Designate và BIND9
Bài này thêm DNS-as-a-Service cho cloud: người dùng tự tạo zone, recordset qua API, và Neutron tự tạo bản ghi A/PTR cho floating IP, cho port của VM. Service trong OpenStack là Designate (service type dns), backend là BIND9.
Genestack chỉ cài Designate. Genestack không cài DNS server. Bạn tự dựng BIND9, đưa key rndc cho Designate, và mở đường để BIND9 kéo zone từ designate-mdns. Bài đi qua đủ ba phần đó trên lab (release-2026.2.0.2, OpenStack 2025.1), kèm những chỗ cấu hình mặc định của Genestack chưa chạy được với BIND9.
Designate hoạt động thế nào
| Thành phần | Chạy ở đâu | Việc |
|---|---|---|
designate-api | Pod | API v2, port 9001 |
designate-central | Pod | Ghi zone/recordset vào database, kiểm tra quota, quyền |
designate-worker | Pod | Gọi backend: chạy rndc addzone/delzone tới BIND9, rồi chờ BIND9 có serial mới |
designate-producer | Pod | Tác vụ định kỳ: tăng serial, dọn zone bị xoá |
designate-mdns | Pod | “Mini DNS”: là primary của mọi zone. Gửi NOTIFY, trả lời AXFR cho BIND9 |
| BIND9 | Ngoài Kubernetes | Secondary của mọi zone, trả lời truy vấn DNS của người dùng |
Luồng khi tạo một zone:
centrallưu zone,workerchạyrndc addzonetrên BIND9. Zone được thêm dạngtype slave,masterslà địa chỉ củadesignate-mdns.- BIND9 kéo zone từ
mdnsbằng AXFR. - Mỗi lần recordset đổi,
mdnsgửi NOTIFY, BIND9 kéo lại zone. workerhỏi SOA trên BIND9. Khi serial khớp, zone chuyển sangACTIVE.
Các kết nối cần mở:
| Từ | Tới | Port | Việc |
|---|---|---|---|
Pod designate-worker | BIND9 | TCP 953 | rndc |
Pod designate-worker | BIND9 | UDP/TCP 53 | Kiểm tra serial |
Pod designate-mdns | BIND9 | UDP 53 | NOTIFY |
| BIND9 | designate-mdns | TCP/UDP 5354 | AXFR, SOA |
| Người dùng | BIND9 | UDP/TCP 53 | Truy vấn DNS |
Kết nối thứ tư là chỗ khó nhất: BIND9 nằm ngoài cluster nhưng phải gọi được vào pod mdns. Chart tạo Service minidns kiểu NodePort với port ngẫu nhiên trong dải 30000–32767, không dùng được làm masters một cách ổn định. Bài này tạo thêm một Service LoadBalancer qua MetalLB, IP cố định, port 5354.
Thông số của lab
| Biến | Giá trị trong lab | Ghi chú |
|---|---|---|
BIND_IP | 10.0.0.53 | IP thứ hai của deployer. 10.0.0.10:53 đã bị dnsmasq của lab giữ |
MDNS_VIP | 10.0.0.215 | IP trống trong pool MetalLB primary (10.0.0.208/28) |
NODE_CIDR | 10.0.0.0/24 | Dải IP node. Pod ra ngoài được SNAT thành IP node (natOutgoing của kube-ovn) |
NS_NAME | ns1.gslab.example. | Tên NS ghi vào mọi zone |
| Zone thử | demo.gslab.example. |
Kiểm tra MDNS_VIP chưa ai dùng:
1
kubectl get svc -A -o jsonpath='{range .items[*]}{.status.loadBalancer.ingress[0].ip}{"\n"}{end}' | sort -u
Production nên dùng ít nhất hai máy BIND9 riêng. Mỗi máy là một nameserver và một target trong pool. Bài làm với một máy trước, rồi thêm máy thứ hai (10.0.0.93) ở phần Mở rộng lên hai BIND9.
Bước 1 – Thêm IP cho BIND9 trên deployer
Port của deployer trên DFW3 có port security, nên phải cho phép IP mới trước. Chạy trên máy có openrc của DFW3:
1
openstack port set deployer-host-gslab --allowed-address ip-address=10.0.0.53
Trên deployer, thêm IP vào enp3s0:
1
2
3
4
5
6
7
8
9
10
11
cat > /etc/netplan/60-bind9-ip.yaml <<'EOF'
network:
version: 2
ethernets:
enp3s0:
addresses: [10.0.0.53/32]
EOF
chmod 600 /etc/netplan/60-bind9-ip.yaml
netplan apply
ip -4 a show enp3s0
ip route | grep 10.0.0.0/24
IP mới phải là /32, không phải /24. Với /24, kernel coi 10.0.0.53 là địa chỉ chính, 10.0.0.10 thành secondary, và route 10.0.0.0/24 đổi sang src 10.0.0.53. Từ đó mọi kết nối từ deployer tới các node đều đi ra bằng IP mới. Security group default của lab chỉ mở TCP giữa các máy theo remote-group, và remote-group chỉ chứa IP cố định của port, không chứa allowed-address-pair. Kết quả: ping vẫn thông (ICMP mở cho mọi nguồn), nhưng kubectl tới 10.0.0.11:6443 bị treo. Với /32, route vẫn là src 10.0.0.10. IP mới chỉ dùng để nhận kết nối tới BIND9, và các kết nối BIND9 tự mở ra (AXFR) đi bằng 10.0.0.10.
Kiểm tra cả hai chiều:
1
2
kubectl get nodes
ssh -n 10.0.0.11 'timeout 5 bash -c "echo > /dev/tcp/10.0.0.53/22" && echo ok'
Đừng đặt transfer-source hay notify-source của BIND9 thành 10.0.0.53: gói đi ra từ IP này tới node sẽ bị security group chặn.
dnsmasq của lab có listen-address=10.0.0.10 và bind-interfaces, nên không chiếm IP mới.
Bước 2 – Cài BIND9
1
apt-get install -y bind9 bind9-utils
Tạo key riêng cho Designate. Không dùng chung rndc-key mặc định của máy:
1
2
3
tsig-keygen -a hmac-sha256 designate > /etc/bind/designate.key
chown root:bind /etc/bind/designate.key
chmod 640 /etc/bind/designate.key
/etc/bind/named.conf.options:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
options {
directory "/var/cache/bind";
listen-on port 53 { 127.0.0.1; 10.0.0.53; };
listen-on-v6 { none; };
// Chỉ authoritative, không làm resolver
recursion no;
allow-query { any; };
allow-transfer { none; };
// NOTIFY từ pod mdns đi qua SNAT, tới với IP của node
allow-notify { 10.0.0.0/24; };
// Cho phép rndc addzone/delzone
allow-new-zones yes;
dnssec-validation no;
minimal-responses yes;
};
/etc/bind/named.conf.local:
1
2
3
4
5
6
7
include "/etc/bind/rndc.key";
include "/etc/bind/designate.key";
controls {
inet 127.0.0.1 port 953 allow { 127.0.0.1; } keys { "rndc-key"; };
inet 10.0.0.53 port 953 allow { 10.0.0.0/24; } keys { "designate"; };
};
Khi đã có khối controls, BIND9 không tự bật rndc local nữa, nên phải khai báo lại dòng 127.0.0.1 với rndc-key.
1
2
3
4
5
6
named-checkconf
systemctl restart named
systemctl enable named
ss -lntup | grep named
rndc status | head -3
rndc -s 10.0.0.53 -k /etc/bind/designate.key status | head -3
Zone do rndc addzone thêm vào được lưu trong /var/cache/bind/_default.nzd. Restart BIND9 không mất zone.
Bước 3 – Đưa key cho Designate
Tên Secret và tên file trong Secret phải đúng là rndc-key-secret và rndc.key:
1
2
kubectl -n openstack create secret generic rndc-key-secret \
--from-file=rndc.key=/etc/bind/designate.key
Bước 4 – Override cho Designate
Base override của release-2026.2.0.2 chưa chạy được với BIND9:
| Vấn đề | Hậu quả | Sửa |
|---|---|---|
Pool mặc định là pdns4, IP 127.0.0.1 | Không có backend thật | Ghi đè conf.pools |
Không mount rndc.key vào pod | rndc không có key | Thêm pod.mounts cho worker |
Chart mount emptyDir đè lên /etc/designate, che mất rootwrap.conf | rndc (chạy qua sudo designate-rootwrap) lỗi | root_helper trỏ tới /etc/designate-rootwrap.conf, có trong image từ cuối 09/2026 (genestack#1827) |
Image designate_service_cleaner là kernelpanic53/rackerlabs-designate:2026-master của một tài khoản Docker Hub cá nhân | Rủi ro supply chain. Lệnh designate-manage service clean chỉ có từ 2025.2 | Tắt cron job trên 2025.1 |
Không có endpoint public cho dns trong global_overrides | Endpoint public sai | Đặt endpoints.dns |
Tạo /etc/genestack/helm-configs/designate/designate-bind9-overrides.yaml:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
manifests:
# 2025.1 chưa có "designate-manage service clean".
# Từ 2025.2: bật lại và dùng image ghcr.io/rackerlabs/genestack-images/designate:<version>-latest
cron_job_service_cleaner: false
network:
mdns:
node_port:
# Dùng Service LoadBalancer ở bước 5 thay cho NodePort ngẫu nhiên
enabled: false
pod:
mounts:
designate_worker:
init_container: null
designate_worker:
volumeMounts:
- name: rndc-key
mountPath: /etc/designate/rndc.key
subPath: rndc.key
readOnly: true
volumes:
- name: rndc-key
secret:
secretName: rndc-key-secret
conf:
designate:
DEFAULT:
root_helper: sudo designate-rootwrap /etc/designate-rootwrap.conf
pools: |
- name: default
description: BIND9 pool
attributes: {}
ns_records:
- hostname: ns1.gslab.example.
priority: 1
nameservers:
- host: 10.0.0.53
port: 53
targets:
- type: bind9
description: BIND9 on gslab-deployer
masters:
- host: 10.0.0.215
port: 5354
options:
host: 10.0.0.53
port: 53
rndc_host: 10.0.0.53
rndc_port: 953
rndc_key_file: /etc/designate/rndc.key
endpoints:
dns:
host_fqdn_override:
public:
tls: {}
host: designate.api.openstack.example.com
port:
api:
public: 443
scheme:
public: https
Ghi chú về conf.pools:
- Init container của
designate-workerdựngpools.yamlbằngeval "echo \"...\""rồi chạydesignate-manage pool update. Không dùng dấu",$hay backtick trong khối này. - Tên pool
defaultkhông đổi được sau khi đã có zone. - Production có nhiều BIND9: thêm mỗi máy một mục trong
nameserversvà một mục trongtargets.
Mount chỉ cần cho designate-worker, vì backend chạy trong worker. Base override của Genestack main mount key vào mọi pod; cách nào cũng chạy được.
Bước 5 – Service LoadBalancer cho mdns
Thêm Service vào kustomize overlay của Designate, để nó được cài cùng Helm release. Tạo /etc/genestack/kustomize/designate/overlay/designate-mdns-lb.yaml:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
apiVersion: v1
kind: Service
metadata:
name: designate-mdns-lb
namespace: openstack
annotations:
metallb.io/address-pool: primary
metallb.io/loadBalancerIPs: 10.0.0.215
spec:
type: LoadBalancer
selector:
release_group: designate
application: designate
component: mdns
ports:
- name: mdns-tcp
port: 5354
targetPort: 5354
protocol: TCP
- name: mdns-udp
port: 5354
targetPort: 5354
protocol: UDP
Thêm file vào /etc/genestack/kustomize/designate/overlay/kustomization.yaml:
1
2
3
4
5
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ../base
- designate-mdns-lb.yaml
Bước 6 – Cài Designate
1
2
3
/opt/genestack/bin/install-designate.sh
kubectl -n openstack get pods -l application=designate
kubectl -n openstack get svc designate-mdns-lb minidns
designate-mdns-lb phải có EXTERNAL-IP là 10.0.0.215, và minidns là ClusterIP.
Kiểm tra pool và rndc
Pool được nạp trong init container của worker:
1
2
kubectl -n openstack logs deploy/designate-worker -c designate-worker-init | tail -5
os dns service list
Gọi rndc từ trong pod worker, đúng như cách worker gọi. Lệnh này kiểm tra cùng lúc key, rootwrap và đường mạng tới BIND9:
1
2
3
4
5
kubectl -n openstack exec deploy/designate-worker -c designate-worker -- \
ls -l /etc/designate/rndc.key /etc/designate-rootwrap.conf
kubectl -n openstack exec deploy/designate-worker -c designate-worker -- \
sudo designate-rootwrap /etc/designate-rootwrap.conf \
rndc -s 10.0.0.53 -p 953 -k /etc/designate/rndc.key status
Kiểm tra BIND9 gọi được mdns:
1
dig @10.0.0.215 -p 5354 example.invalid. SOA
mdns trả lời REFUSED hoặc NOTAUTH cho zone chưa có là đúng. Lỗi timed out nghĩa là đường tới VIP chưa thông.
Tạo zone và recordset
1
2
os zone create --email admin@gslab.example demo.gslab.example.
os zone list -c name -c status -c action
Chờ zone chuyển từ PENDING sang ACTIVE, thường dưới 30 giây. Trên deployer, xem BIND9 nhận zone:
1
journalctl -u named --since "5 min ago" | grep -E "addzone|demo.gslab|transfer|notify"
Thêm một bản ghi rồi truy vấn thẳng BIND9:
1
2
3
4
os recordset create demo.gslab.example. www --type A --record 192.0.2.10
dig @10.0.0.53 www.demo.gslab.example. +short
dig @10.0.0.53 demo.gslab.example. SOA +short
os zone show demo.gslab.example. -c serial
Serial trên BIND9 phải bằng serial của Designate.
Endpoint public
Listener designate-https và HTTPRoute custom-designate-gateway-route đã có từ lúc cài Gateway (Phần 4a). Kiểm tra catalog và gọi qua gateway:
1
2
os endpoint list --service dns -c Interface -c URL
curl -sk https://designate.api.openstack.example.com/ | head -c 200; echo
Nếu máy client chưa phân giải được designate.api.openstack.example.com, thêm tên này vào DNS của lab (dnsmasq trên deployer) hoặc /etc/hosts, trỏ về IP gateway 10.0.0.200.
Bước 7 – Tích hợp với Neutron
Neutron gọi Designate để tạo bản ghi khi người dùng gán tên cho floating IP hoặc port. Chart Neutron tự xử lý phần thông tin đăng nhập khi external_dns_driver: designate:
- Job
ks-usertạo userneutron_designatetrong projectservice, mật khẩu lấy từ Secretdesignate-admin(install-neutron.shđã truyền sẵn). - Secret
neutron-ks-etccó thêm fileneutron_designate.confchứa section[designate]với user, project, mật khẩu. File này được nạp sauneutron.conf.
Vì vậy không cần chép mật khẩu vào override như tài liệu của Genestack. Nhưng phải ghi rõ auth_url và auth_type. File neutron_designate.conf không có hai khoá này. Khi auth_url để trống, template của chart tự điền vào đó URL của Designate API (http://designate-api.openstack.svc.cluster.local:9001/) thay vì URL của Keystone. Khi đó Neutron vẫn tạo được bản ghi A, vì bước này dùng token của người dùng. Nhưng bước đăng nhập bằng user neutron_designate hỏng, và lệnh trả về 500. Log của neutron-server có dòng:
1
keystoneauth1.exceptions.discovery.DiscoveryFailure: Cannot use v2 authentication with domain scope
Floating IP và bản ghi A vẫn được tạo dù lệnh báo lỗi. Hãy xoá chúng trước khi thử lại, nếu không lần sau sẽ gặp A Floating IP record for fip1 ... already exists.
Tạo /etc/genestack/helm-configs/neutron/neutron-designate-overrides.yaml:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
conf:
neutron:
DEFAULT:
# Domain cho DNS nội bộ của Neutron. Phải là FQDN có dấu chấm cuối.
# Không dùng cluster.local: trùng domain của Kubernetes.
dns_domain: gslab.internal.
external_dns_driver: designate
designate:
# Chart tự đặt auth_url = endpoint của Designate nếu để trống, nên phải ghi rõ Keystone
auth_type: password
auth_url: http://keystone-api.openstack.svc.cluster.local:5000/v3
url: http://designate-api.openstack.svc.cluster.local:9001/v2
allow_reverse_dns_lookup: true
ipv4_ptr_zone_prefix_size: 24
ipv6_ptr_zone_prefix_size: 116
plugins:
ml2_conf:
ml2:
# Giữ nguyên danh sách của base (port_security,qos,fwaas_v2), thêm hai driver DNS
extension_drivers: "port_security,qos,fwaas_v2,dns_domain_ports,subnet_dns_publish_fixed_ip"
extension_drivers là một chuỗi: giá trị trong file của bạn thay hẳn giá trị của base. Trước khi ghi, kiểm tra lại danh sách của base trên phiên bản bạn đang chạy:
1
grep -n extension_drivers /opt/genestack/base-helm-configs/neutron/neutron-helm-overrides.yaml
Cài lại Neutron và kiểm tra cấu hình đã vào pod:
1
2
3
4
5
6
7
8
9
/opt/genestack/bin/install-neutron.sh
kubectl -n openstack exec deploy/neutron-server -c neutron-server -- \
sh -c 'ls /etc/neutron/neutron.conf.d/; grep -v password /etc/neutron/neutron.conf.d/neutron_designate.conf'
# auth_url phải là Keystone (:5000/v3), không phải designate-api
kubectl -n openstack exec deploy/neutron-server -c neutron-server -- \
sh -c 'sed -n "/^\[designate\]/,/^\[/p" /etc/neutron/neutron.conf | grep -E "auth_(url|type)"'
kubectl -n openstack exec deploy/neutron-server -c neutron-server -- \
grep -E '^(external_dns_driver|dns_domain|extension_drivers)' /etc/neutron/neutron.conf /etc/neutron/plugins/ml2/ml2_conf.ini
os user show neutron_designate --domain service -c name -c enabled
Thử ba trường hợp
Zone phải có sẵn và thuộc project của người dùng. Neutron không tự tạo zone thuận; nó chỉ tự tạo zone ngược (PTR), trong project của neutron_designate.
1. Floating IP có tên riêng. Tên và domain đặt thẳng trên floating IP:
1
2
3
os floating ip create public --dns-domain demo.gslab.example. --dns-name fip1
os recordset list demo.gslab.example. -c name -c type -c records
dig @10.0.0.53 fip1.demo.gslab.example. +short
2. Floating IP của VM. Network có dns_domain, port của VM có dns_name (Nova đặt bằng hostname của VM). Khi gán floating IP, bản ghi được tạo theo tên VM:
1
2
3
4
5
6
os network set test-net --dns-domain demo.gslab.example.
os server create vm-dns1 --image "Cirros 0.6.2 64-bit" --flavor m1.tiny --network test-net --wait
os port show $(os port list --server vm-dns1 -c ID -f value) -c dns_name -c dns_assignment
FIP=$(os floating ip create public -f value -c floating_ip_address)
os server add floating ip vm-dns1 "$FIP"
dig @10.0.0.53 vm-dns1.demo.gslab.example. +short
3. Fixed IP. Bật dns_publish_fixed_ip trên subnet để publish cả IP riêng của VM. Network vẫn phải có dns_domain như ở trường hợp 2. Neutron lấy zone từ dns_domain của port, hoặc của network nếu port không có:
1
2
3
4
5
os network set test-net --dns-domain demo.gslab.example. # nếu chưa làm ở trường hợp 2
os subnet set test-subnet --dns-publish-fixed-ip
os server create vm-dns2 --image "Cirros 0.6.2 64-bit" --flavor m1.tiny --network test-net --wait
os port show $(os port list --server vm-dns2 -c ID -f value) -c dns_assignment
dig @10.0.0.53 vm-dns2.demo.gslab.example. +short
dns_assignment phải là vm-dns2.demo.gslab.example.. Nếu nó là vm-dns2.gslab.internal., thì network chưa có dns_domain. Tên đó lấy từ dns_domain mặc định của Neutron, chỉ dùng cho DNS nội bộ, và không bản ghi nào được tạo trong Designate.
Neutron chỉ publish khi tạo hoặc cập nhật port. Đặt dns_domain cho network sau khi VM đã chạy không làm port cũ được publish. Với port đã có, đặt dns_domain trực tiếp lên port (cần extension driver dns_domain_ports):
1
os port set $(os port list --server vm-dns2 -c ID -f value) --dns-domain demo.gslab.example.
Bản ghi ngược của fixed IP nằm trong zone 0.16.172.in-addr.arpa., cũng được tạo tự động.
Bản ghi ngược của floating IP nằm trong zone 10.168.192.in-addr.arpa.:
1
2
os zone list --all-projects -c name -c project_id -c status
dig @10.0.0.53 -x "$FIP" +short
Xoá VM, nhả floating IP rồi kiểm tra các bản ghi A và PTR cũng bị xoá.
Mở rộng lên hai BIND9
Một BIND9 là một điểm lỗi duy nhất: máy đó tắt thì mọi zone ngừng trả lời. Phần này thêm máy thứ hai, ns2, IP 10.0.0.93. Với Designate, mỗi máy BIND9 cần hai mục trong pool:
| Mục trong pool | Designate dùng để | Mỗi BIND9 cần |
|---|---|---|
nameservers | Hỏi SOA, kiểm tra serial đã cập nhật | Một mục |
targets | Chạy rndc addzone/delzone | Một mục, rndc_host riêng |
ns_records | Ghi bản ghi NS vào mọi zone | Một tên (ns1, ns2) |
Hai BIND9 không truyền zone cho nhau. Mỗi máy là secondary độc lập, cùng kéo zone từ VIP của mdns.
Chuẩn bị ns2
ns2 là một VM riêng, có IP cố định 10.0.0.93 trên port của chính nó. Vì vậy không cần IP /32 hay allowed-address-pair như trên deployer. Port của VM phải nằm trong security group default của lab: rule remote-group cho node gọi được TCP 953 và 53 của nó.
Cài BIND9 như ở bước 2, với hai khác biệt:
- Dùng chung key
designate. Chép/etc/bind/designate.keytừ ns1 sang, không tạo key mới. Cả hai target dùng cùng file/etc/designate/rndc.keytrong pod, nên không phải đổi Secret. - IP trong
listen-onvàcontrolslà10.0.0.93.
1
2
3
4
5
# Trên deployer (ns1)
scp /etc/bind/designate.key 10.0.0.93:/etc/bind/designate.key
# Trên ns2, sau khi apt-get install bind9 bind9-utils
chown root:bind /etc/bind/designate.key && chmod 640 /etc/bind/designate.key
named.conf.options trên ns2 giống ns1, chỉ đổi dòng:
1
listen-on port 53 { 127.0.0.1; 10.0.0.93; };
named.conf.local trên ns2 giống ns1, chỉ đổi dòng:
1
inet 10.0.0.93 port 953 allow { 10.0.0.0/24; } keys { "designate"; };
1
named-checkconf && systemctl restart named && systemctl enable named
Kiểm tra từ pod worker, trước khi sửa pool:
1
2
3
kubectl -n openstack exec deploy/designate-worker -c designate-worker -- \
sudo designate-rootwrap /etc/designate-rootwrap.conf \
rndc -s 10.0.0.93 -p 953 -k /etc/designate/rndc.key status
Bước này quan trọng: nếu thêm ns2 vào pool khi worker chưa gọi được nó, mọi thay đổi zone sau đó sẽ chuyển sang ERROR (xem threshold_percentage bên dưới).
Sửa pool
Trong /etc/genestack/helm-configs/designate/designate-bind9-overrides.yaml, thay conf.pools và thêm service:worker:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
conf:
designate:
DEFAULT:
root_helper: sudo designate-rootwrap /etc/designate-rootwrap.conf
service:worker:
# 100: zone chỉ ACTIVE khi mọi BIND9 đã có serial mới (mặc định)
threshold_percentage: 100
pools: |
- name: default
description: BIND9 pool
attributes: {}
ns_records:
- hostname: ns1.gslab.example.
priority: 1
- hostname: ns2.gslab.example.
priority: 2
nameservers:
- host: 10.0.0.53
port: 53
- host: 10.0.0.93
port: 53
targets:
- type: bind9
description: BIND9 ns1 on gslab-deployer
masters:
- host: 10.0.0.215
port: 5354
options:
host: 10.0.0.53
port: 53
rndc_host: 10.0.0.53
rndc_port: 953
rndc_key_file: /etc/designate/rndc.key
- type: bind9
description: BIND9 ns2
masters:
- host: 10.0.0.215
port: 5354
options:
host: 10.0.0.93
port: 53
rndc_host: 10.0.0.93
rndc_port: 953
rndc_key_file: /etc/designate/rndc.key
threshold_percentage quyết định một thay đổi cần bao nhiêu phần trăm BIND9 thành công:
- 100 (mặc định): zone chỉ
ACTIVEkhi cả hai BIND9 đã có serial mới. Một máy hỏng thì zone chuyểnERROR, dù máy còn lại vẫn đúng. Bạn biết ngay có máy hỏng, nhưng người dùng thấy lỗi. - 50: một máy là đủ. Người dùng không thấy lỗi khi một máy hỏng, nhưng máy hỏng có thể lệch dữ liệu mà không ai biết, trừ khi có giám sát riêng (so serial của hai máy).
Lab giữ 100. Production chọn theo việc bạn có giám sát serial từng BIND9 hay chưa.
Áp dụng. Init container của worker chạy lại designate-manage pool update khi pod khởi động:
1
2
3
/opt/genestack/bin/install-designate.sh
kubectl -n openstack rollout status deploy/designate-worker
kubectl -n openstack logs deploy/designate-worker -c designate-worker-init | tail -5
Nếu chỉ pools thay đổi mà pod worker không được tạo lại, thì restart nó: kubectl -n openstack rollout restart deploy/designate-worker.
Đồng bộ zone đã có sang ns2
Zone tạo trước khi có ns2 chưa nằm trên ns2. Có hai cơ chế đưa chúng sang:
- Thêm
ns2vàons_records. Khi pool có NS mới, Designate thêm bản ghi NSns2.gslab.example.vào mọi zone của pool. Mỗi zone vì vậy được cập nhật, và worker gửi cập nhật tới mọi target. - Backend bind9 tự tạo zone khi cập nhật. Khi cập nhật zone, backend chạy
rndc showzone. Nếu zone chưa có trên máy đó, nó chạyaddzonethay chomodzone.
Kiểm tra:
1
2
3
4
5
os zone list -c name -c status -c serial
os recordset list demo.gslab.example. --type NS -c records
for ns in 10.0.0.53 10.0.0.93; do
echo -n "$ns: "; dig @$ns demo.gslab.example. SOA +short
done
Hai BIND9 phải trả cùng serial, bằng serial trong Designate. Nếu một zone vẫn chưa có trên ns2, cập nhật zone đó để kích worker:
1
os zone set demo.gslab.example. --description "resync ns2"
Thử khi một BIND9 hỏng
1
2
3
4
5
6
7
ssh 10.0.0.93 systemctl stop named
os recordset create demo.gslab.example. test-ha --type A --record 192.0.2.20
os zone show demo.gslab.example. -c status -c action # thường ERROR với threshold 100
dig @10.0.0.53 test-ha.demo.gslab.example. +short # ns1 vẫn có bản ghi
ssh 10.0.0.93 systemctl start named
os zone set demo.gslab.example. --description "recover" # đẩy lại cho ns2
dig @10.0.0.93 test-ha.demo.gslab.example. +short
Producer cũng tự thử lại các zone ERROR theo định kỳ, nên nếu đợi vài phút, zone thường về ACTIVE mà không cần làm gì.
Dọn dẹp và rollback
1
2
3
4
5
os server delete vm-dns1 vm-dns2
os floating ip list -c ID -c "Floating IP Address" # xoá các FIP vừa tạo
os subnet unset test-subnet --dns-publish-fixed-ip
os network unset test-net --dns-domain
os zone delete demo.gslab.example.
Gỡ tích hợp Neutron: xoá neutron-designate-overrides.yaml, chạy lại install-neutron.sh. Gỡ Designate:
1
2
helm -n openstack uninstall designate
kubectl -n openstack delete secret rndc-key-secret
Trên BIND9, các zone đã thêm bằng rndc addzone vẫn còn trong _default.nzd. Xoá bằng rndc delzone -clean <zone>, hoặc dừng named và xoá file đó.
Lưu ý cho production
- Ít nhất hai BIND9, đặt ở hai failure domain, khai báo cả hai trong
nameserversvàtargets. Đăng ký NS và glue ở domain cha để Internet tìm được chúng. - Tăng replica: base override đặt mọi thành phần 1 replica, PDB
min_available: 0. Tối thiểu 2 choapi,central,worker,mdns,producer. - Giới hạn AXFR bằng TSIG: VIP của mdns trả zone cho bất kỳ ai gọi được tới nó. Nếu VIP nằm trong mạng có người khác dùng, cấu hình TSIG cho AXFR.
- Không dùng image của tài khoản cá nhân: thay
designate_service_cleanerbằng imagegenestack-imagescùng phiên bản (từ 2025.2), hoặc tắt cron job. - Theo dõi zone kẹt ở
PENDINGhoặcERROR: rule Prometheus có trong tài liệu Designate exporter của Genestack.
Tóm tắt
- Designate là primary (qua
mdns), BIND9 là secondary. Worker thêm zone bằngrndc addzone, BIND9 kéo zone qua AXFR từ mdns. - Genestack không dựng DNS server. Tự cài BIND9 với
allow-new-zones yes, keyrndcriêng,allow-notifycho dải IP node. - Trên
release-2026.2.0.2phải tự ghi đè: pool BIND9, mountrndc.key,root_helpermới, tắt cron job service cleaner, endpoint public. - Đưa mdns ra ngoài cluster bằng một Service
LoadBalancercó IP cố định trong kustomize overlay. - Tích hợp Neutron cần
external_dns_driver, URL của Designate,auth_urlcủa Keystone (chart điền sai nếu để trống) và hai extension driver. Chart tự tạo userneutron_designatevà mật khẩu.