Skip to content

Commit 4d4133a

Browse files
committed
docs: [#28] add IPv6 AAAA record configuration to Hetzner DNS setup
- Add section 7.3 for IPv6 AAAA record creation in Hetzner setup guide - Include working curl commands for tracker and grafana AAAA records - Add IPv6 verification steps with dig commands for dual-stack testing - Update session documentation with IPv6 completion status - Complete dual-stack DNS configuration: IPv4 + IPv6 for staging environment Tested configuration: - tracker.staging-torrust-demo.com: 78.47.140.132 (A) + 2a01:4f8:1c17:a01d::1 (AAAA) - grafana.staging-torrust-demo.com: 78.47.140.132 (A) + 2a01:4f8:1c17:a01d::1 (AAAA) All DNS records verified working via dig commands.
1 parent b7eb679 commit 4d4133a

File tree

3 files changed

+121
-10
lines changed

3 files changed

+121
-10
lines changed

docs/guides/providers/hetzner/hetzner-cloud-setup-guide.md

Lines changed: 89 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -616,21 +616,106 @@ curl -s -H "Auth-API-Token: $HETZNER_DNS_API_TOKEN" \
616616
}
617617
```
618618

619-
### 7.3 Verify DNS Configuration
619+
### 7.3 Create DNS AAAA Records (IPv6)
620+
621+
Create AAAA records for IPv6 dual-stack connectivity:
622+
623+
```bash
624+
# Create tracker subdomain AAAA record
625+
curl -s -H "Auth-API-Token: $HETZNER_DNS_API_TOKEN" \
626+
-H "Content-Type: application/json" \
627+
-X POST \
628+
-d '{
629+
"type": "AAAA",
630+
"name": "tracker",
631+
"value": "2a01:4f8:1c17:a01d::1",
632+
"ttl": 300,
633+
"zone_id": "hbpTmpwZJw6xbKqbudCiDb"
634+
}' \
635+
"https://dns.hetzner.com/api/v1/records" | jq
636+
637+
# Create grafana subdomain AAAA record
638+
curl -s -H "Auth-API-Token: $HETZNER_DNS_API_TOKEN" \
639+
-H "Content-Type: application/json" \
640+
-X POST \
641+
-d '{
642+
"type": "AAAA",
643+
"name": "grafana",
644+
"value": "2a01:4f8:1c17:a01d::1",
645+
"ttl": 300,
646+
"zone_id": "hbpTmpwZJw6xbKqbudCiDb"
647+
}' \
648+
"https://dns.hetzner.com/api/v1/records" | jq
649+
```
650+
651+
**Expected Response for each IPv6 record:**
652+
653+
```json
654+
{
655+
"record": {
656+
"id": "f1a2926dde3b57396b863c66b139fad5",
657+
"type": "AAAA",
658+
"name": "tracker",
659+
"value": "2a01:4f8:1c17:a01d::1",
660+
"ttl": 300,
661+
"zone_id": "hbpTmpwZJw6xbKqbudCiDb",
662+
"created": "2025-08-08T14:33:36.497Z",
663+
"modified": "2025-08-08T14:33:36.497Z"
664+
}
665+
}
666+
```
667+
668+
### 7.4 Verify DNS Configuration
620669

621670
Verify your DNS records are created correctly:
622671

672+
#### List All DNS Records
673+
623674
```bash
624675
# List all records in your zone
625676
curl -s -H "Auth-API-Token: $HETZNER_DNS_API_TOKEN" \
626-
"https://dns.hetzner.com/api/v1/records?zone_id=Vpew4Pb3YoDjBVHMvV9AHB" | jq
677+
"https://dns.hetzner.com/api/v1/records?zone_id=hbpTmpwZJw6xbKqbudCiDb" | jq
678+
```
679+
680+
#### Test IPv4 (A Records)
681+
682+
```bash
683+
# Test IPv4 DNS resolution
684+
dig A tracker.staging-torrust-demo.com +short
685+
dig A grafana.staging-torrust-demo.com +short
686+
687+
# Expected output for both commands:
688+
# 78.47.140.132
689+
```
627690

628-
# Test DNS resolution
691+
#### Test IPv6 (AAAA Records)
692+
693+
```bash
694+
# Test IPv6 DNS resolution
695+
dig AAAA tracker.staging-torrust-demo.com +short
696+
dig AAAA grafana.staging-torrust-demo.com +short
697+
698+
# Expected output for both commands:
699+
# 2a01:4f8:1c17:a01d::1
700+
```
701+
702+
#### Complete DNS Query
703+
704+
```bash
705+
# View complete DNS information
629706
dig tracker.staging-torrust-demo.com
630707
dig grafana.staging-torrust-demo.com
631708
```
632709

633-
### 7.4 Configure Nameservers at Domain Registrar
710+
#### Test Dual-Stack Connectivity (Optional)
711+
712+
```bash
713+
# Test both IPv4 and IPv6 connectivity (requires deployed application)
714+
curl -4 -s http://tracker.staging-torrust-demo.com/api/health_check || echo "IPv4 not ready"
715+
curl -6 -s http://tracker.staging-torrust-demo.com/api/health_check || echo "IPv6 not ready"
716+
```
717+
718+
### 7.5 Configure Nameservers at Domain Registrar
634719

635720
Finally, configure your domain registrar to use Hetzner's nameservers:
636721

docs/testing/manual-sessions/2025-08-08-issue-28-phase-4-7-staging.md

Lines changed: 27 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -119,18 +119,39 @@ Expected:
119119
- UDP/HTTP tracker announce
120120
- Grafana reachable at https://grafana.staging-torrust-demo.com
121121

122-
### Phase 6: Wrap-up
122+
### Phase 6: IPv6 Dual-Stack DNS Setup
123+
124+
- ✅ Created IPv6 AAAA records for complete dual-stack configuration
125+
- ✅ tracker.staging-torrust-demo.com → 2a01:4f8:1c17:a01d::1 (AAAA record)
126+
- ✅ grafana.staging-torrust-demo.com → 2a01:4f8:1c17:a01d::1 (AAAA record)
127+
- ✅ Verified IPv6 DNS resolution working correctly
128+
- ✅ Updated Hetzner setup guide with IPv6 examples and verification tests
129+
130+
### Phase 7: Wrap-up
123131

124132
- Document issues and fixes
125133
- Optionally keep infra running for further tests or destroy
126134

135+
## DNS Configuration Summary
136+
137+
### IPv4 (A Records) - ✅ Complete
138+
139+
- tracker.staging-torrust-demo.com → 78.47.140.132
140+
- grafana.staging-torrust-demo.com → 78.47.140.132
141+
142+
### IPv6 (AAAA Records) - ✅ Complete
143+
144+
- tracker.staging-torrust-demo.com → 2a01:4f8:1c17:a01d::1
145+
- grafana.staging-torrust-demo.com → 2a01:4f8:1c17:a01d::1
146+
127147
## Open Items / Issues Noted During Session
128148

129-
- [ ]
149+
- [ ] Optional: Test IPv6 connectivity to deployed application (requires application deployment)
130150

131151
## Final Status
132152

133-
- Infrastructure: TBD
134-
- Application: TBD
135-
- SSL: TBD
136-
- External access: TBD
153+
- Infrastructure: ✅ Complete (Hetzner Cloud VM with dual-stack DNS)
154+
- Application: Pending (DNS infrastructure ready for deployment)
155+
- SSL: Pending (DNS ready for SSL certificate generation)
156+
- External access: ✅ Complete (dual-stack DNS resolution working)
157+
- DNS Configuration: ✅ Complete (IPv4 + IPv6 dual-stack)

project-words.txt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ certbot
1111
certonly
1212
challtestsrv
1313
cloudinit
14+
codel
1415
commoninit
1516
conntrack
1617
containerd
@@ -69,6 +70,7 @@ mysqladmin
6970
Namecheap
7071
netcat
7172
netdev
73+
netplan
7274
networkd
7375
networkor
7476
newgrp
@@ -100,6 +102,8 @@ privkey
100102
publickey
101103
pwauth
102104
qcow
105+
qdisc
106+
qlen
103107
repomix
104108
rmem
105109
runcmd
@@ -129,6 +133,7 @@ vcpus
129133
virbr
130134
virsh
131135
virt
136+
Vpew
132137
webroot
133138
whatsmydns
134139
wmem

0 commit comments

Comments
 (0)