Add operational documentation

1 files changed, 130 insertions, 0 deletions

diff --git a/ops/topology.md b/ops/topology.md
new file mode 100644
index 0000000..95b53b8
--- /dev/null
+++ b/ops/topology.md
@@ -0,0 +1,130 @@
+---
+title: SourceHut network topology
+---
+
+We don't use a NAT (yet). This is a list of where our IP addresses are
+allocated, and the hosts for each VM.
+
+# Subnets
+
+- 173.195.146.128/25 (255.255.255.128)
+- 2604:BF00:710::/64
+
+**Gateways**
+
+- 173.195.146.129
+- 2604:BF00:710::1
+
+# Allocations
+
+**Next IPs**
+
+Virtual machines (grows upwards):
+			
+- 173.195.146.137 (reclaimed from mail.sr.ht v1)
+- 173.195.146.140 (reclaimed from metrics.sr.ht v1)
+- 173.195.146.154
+
+Hosts (grows downwards):
+
+- 173.195.146.243
+
+## cirno1.sr.ht
+
+Purpose: build slave
+
+Host IP: 173.195.146.249, 2604:bf00:710:0:ae1f:6bff:fead:55a
+
+## cirno2.sr.ht
+
+Purpose: build slave
+
+Host IP: 173.195.146.244, 2604:bf00:710:0:ae1f:6bff:fe79:a33e
+
+## yukari.sr.ht
+
+Purpose: file storage
+
+Host IP: 173.195.146.250, 2604:bf00:710:0:230:48ff:fedf:3552
+
+## remilia.sr.ht
+
+Purpose: SQL primary
+
+Host IP: 173.195.146.251, 2604:bf00:710:0:230:48ff:fe7d:599a
+
+## alice1.sr.ht
+
+Purpose: VM host
+
+Host IP: 208.88.54.60 (**old subnet**), 2604:bf00:710:0:225:90ff:fe09:440
+
+### Guests
+
+- packages.knightos.org: 173.195.146.130
+- ns2.sr.ht: 173.195.146.138, 2604:bf00:710:0:5054:ff:fe77:d4b4/64
+- man.sr.ht: 173.195.146.146, 2604:bf00:710:0:5054:ff:feb7:8f16
+- static1.sr.ht: 173.195.146.149, 2604:bf00:710:0:5054:ff:fe0c:b76e
+- metrics.sr.ht: 173.195.146.153, 2604:bf00:710:0:5054:ff:fee3:409
+
+## alice2.sr.ht
+
+Purpose: VM host
+
+Host IP: 208.88.54.61 (**old subnet**), 2604:bf00:710:0:230:48ff:fedc:ab06
+
+### Guests
+
+- drewdevault.com: 173.195.146.133
+- todo.sr.ht: 173.195.146.145, 2604:bf00:710:0:5054:ff:fea1:a941
+- dispatch.sr.ht: 173.195.146.147, 2604:bf00:710:0:5054:ff:fe44:efcb
+- hg.sr.ht: 173.195.146.139, 2604:bf00:710:0:5054:ff:fe25:1aa6
+
+## alice3.sr.ht
+
+Purpose: VM host
+
+Host IP: 208.88.54.62 (**old subnet**), 2604:bf00:710:0:230:48ff:fedb:c474
+
+### Guests
+
+- cmpwn.com: 173.195.146.132
+- ns1.sr.ht: 173.195.146.135, 2604:bf00:710:0:5054:ff:fe65:e92f
+- irc.sircmpwn.com: 173.195.146.141
+- meta.sr.ht: 173.195.146.143, 2604:bf00:710:0:5054:ff:fe97:74b3
+- lists.sr.ht: 173.195.146.144, 2604:bf00:710:0:5054:ff:fec4:6bfb
+- builds.sr.ht: 173.195.146.148, 2604:bf00:710:0:5054:ff:fe50:b8e1
+- paste.sr.ht: 173.195.146.150, 2604:bf00:710:0:5054:ff:fec4:3586
+- mail-b.sr.ht: 173.195.146.151, 2604:bf00:710:0:5054:ff:fee5:c082
+
+## alice4.sr.ht
+
+Purpose: VM host (**out of service**)
+
+Host IP: 173.195.146.248
+
+**Note**: this machine has severe issues, needs to be diagnosed. Don't host
+anything here.
+
+## patchouli.sr.ht
+
+Purpose: blob storage
+
+Host IP: 173.195.146.247, 2604:bf00:710:0:ae1f:6bff:fec2:5502
+
+## flandre.sr.ht
+
+Purpose: ppc64le build host
+
+Host IP: 173.195.146.246, 2604:bf00:710:0:2e09:4dff:fe00:992
+
+## tenshi.sr.ht
+
+Purpose: High-performance VM host
+
+Host IP: 173.195.146.245
+
+### Guests
+
+- git.sr.ht: 173.195.146.142, 2604:bf00:710:0:5054:ff:fe36:ebc6
+- legacy.sr.ht: 173.195.146.152, 2604:bf00:710:0:5054:ff:fe8f:b9de