13 Min. Lesezeit

Lernziele

Am Ende dieses Moduls werden Sie in der Lage sein:

  • Ein dreistufiges Netzwerk aus öffentlichen und privaten LANs mit `ionoscloud_lan` erstellen, wobei explizite private CIDR-Blöcke verwendet werden
  • Server an mehrere LANs mit Inline-`nic`-Blöcken und der `ionoscloud_nic`-Ressource anbinden
  • Privaten LANs ausgehenden Internetzugang mit `ionoscloud_natgateway` und SNAT-Regeln ermöglichen und den Serververkehr dorthin leiten
  • Ein On-Premises-Netzwerk mit `ionoscloud_vpn_ipsec_gateway` und `ionoscloud_vpn_ipsec_tunnel` verbinden
  • DNS-Zonen und -Einträge als Code mit `ionoscloud_dns_zone` und `ionoscloud_dns_record` verwalten

Einheit 2.2: Netzwerk und Konnektivität als Code

Einführung

In Einheit 2.1 befanden sich Ihr API-Server und der Worker in einem öffentlichen LAN. Das ist für einen Test in Ordnung, aber die Datenbank und der Worker von TaskBoard sollten niemals aus dem Internet erreichbar sein, und das Betriebsteam wünscht sich einen privaten Pfad vom Büronetzwerk aus. Sie benötigen Netzwerksegmentierung, kontrollierten ausgehenden Datenverkehr und einen stabilen DNS-Namen für die API, wobei alles in Git überprüfbar sein muss.

In dieser Einheit bauen Sie diesen Netzwerk-Stack mit Terraform auf: ein öffentliches LAN für den API-Einstiegspunkt, ein App-LAN und ein DB-LAN, die privat bleiben, ein Managed NAT Gateway für ausgehenden Datenverkehr aus den privaten Ebenen, ein IPSec-VPN-Gateway für hybriden Zugriff und Cloud DNS-Einträge für die API. Im Code Lab deployen Sie das Netzwerk und überprüfen die Konnektivität zwischen den Ebenen.

1. LANs für mehrstufige Segmentierung

resource "ionoscloud_lan" "public" {
  datacenter_id = ionoscloud_datacenter.taskboard.id
  name          = "taskboard-public"
  public        = true
}

resource "ionoscloud_lan" "app" {
  datacenter_id   = ionoscloud_datacenter.taskboard.id
  name            = "taskboard-app"
  public          = false
  ipv4_cidr_block = "10.10.1.0/24"
}

resource "ionoscloud_lan" "db" {
  datacenter_id   = ionoscloud_datacenter.taskboard.id
  name            = "taskboard-db"
  public          = false
  ipv4_cidr_block = "10.10.2.0/24"
}

public = true macht ein LAN für das Internet sichtbar; public = false hält es privat und isoliert seinen Verkehr von externem Zugriff. Das öffentliche LAN existiert bereits aus Einheit 1.2; die LANs für App und DB sind neu.

1.1 Auswahl der privaten CIDR-Blöcke

Wenn Sie ipv4_cidr_block für ein privates LAN weglassen, wird automatisch ein /23-Block aus dem 10.0.0.0/8-Bereich zugewiesen. Setzen Sie ihn explizit, wenn Sie vorhersehbare Adressen für Routen, Firewall-Regeln oder ein VPN benötigen. Ein benutzerdefinierter Block muss:

  • sich in einem privaten RFC 1918-Bereich befinden (10.0.0.0/8, 172.16.0.0/12 oder 192.168.0.0/16)
  • eine Präfixlänge zwischen /23 und /28 haben
  • an seiner Präfixgrenze ausgerichtet sein (10.5.0.0/24, nicht 10.5.0.1/24)

Er kann nur für private LANs gesetzt werden. Eine Änderung aktualisiert das LAN an Ort und Stelle.

1.2 Lesen von CIDR-Fehlern

Wenn die API einen Block ablehnt, enthält der Anbieterfehler den API-Fehlercode:

Code Bedeutung
536 Nicht an der Präfixgrenze ausgerichtet
602 Überlappt mit einem bereits genutzten Block
654 Kein privater Bereich
655 Größer als /23
656 Auf einem öffentlichen LAN gesetzt

Wie die Tabelle zeigt, stammen die meisten Fehler aus kopierten und eingefügten Blöcken. Halten Sie alle Blöcke einer Umgebung in einer locals-Karte, damit Überlappungen in der Überprüfung sichtbar werden:

locals {
  cidr = {
    app = "10.10.1.0/24"
    db  = "10.10.2.0/24"
  }
}

1.3 Reservierte Adressen für verwaltete Dienste

DHCP weist niemals Adressen zu, die auf .0 bis .9 oder .224 bis .255 enden. Die Adressen von .2 bis .9 sind für verwaltete Dienste reserviert. Wenn Sie einem verwalteten Dienst wie einem NAT-Gateway oder VPN-Gateway eine LAN-Adresse zuweisen, nehmen Sie diese aus dem reservierten Bereich, um Konflikte mit DHCP-zugewiesenen IP-Adressen zu vermeiden. Die Beispiele in dieser Einheit verwenden .4 für das NAT-Gateway und .5 für das VPN-Gateway.

2. NICs: Anbindung von Servern an LANs

2.1 Inline- und separate NICs

Der API-Server benötigt eine öffentliche NIC für Clients und eine private NIC für die App-Ebene. Die erste NIC bleibt inline im Server, die zweite wird als eigenständiges Resource hinzugefügt:

resource "ionoscloud_nic" "api_app" {
  datacenter_id = ionoscloud_datacenter.taskboard.id
  server_id     = ionoscloud_server.api.id
  lan           = ionoscloud_lan.app.id
  name          = "app"
  dhcp          = true
  ips           = ["10.10.1.11"]
}

datacenter_id, server_id und lan sind erforderlich, und lan ist die numerische LAN-ID. ips erwartet eine Liste von Adressen; die Übertragung von null oder einer leeren Liste führt zu einer automatischen Adresszuweisung. Explizit zugewiesene öffentliche IPs müssen aus reservierten IP-Blöcken stammen (Einheit 2.1). Die private IPv4-Adresse der NIC wird statisch an ihre MAC-Adresse zugewiesen, sodass eine DHCP-Adresse auf einem privaten LAN an der NIC verbleibt.

2.2 Private-Only Servers

Der Worker verfügt über keinerlei öffentliche NIC:

resource "ionoscloud_vcpu_server" "worker" {
  # ... arguments from Unit 2.1 ...
  nic {
    lan  = ionoscloud_lan.app.id
    name = "app"
    dhcp = true
    ips  = ["10.10.1.21"]
  }
}

Das Argument mac eines NIC kann nur bei der Erstellung festgelegt werden und ist unveränderlich; wenn Sie es nicht festlegen, weist die API einen Wert zu.

3. Ausgehender Zugriff mit dem Managed NAT Gateway

Der Managed NAT Gateway ermöglicht es VMs in einem VDC, das Internet ohne eine öffentliche Netzwerkschnittstelle zu erreichen. Er bietet ausschließlich Source NAT (SNAT): VMs initiieren Verbindungen und empfangen Antworten, während eingehende Verbindungen, die vom Internet aus initiiert werden, nicht akzeptiert werden.

3.1 Gateway und Regeln

resource "ionoscloud_ipblock" "nat" {
  name     = "taskboard-nat-ip"
  location = ionoscloud_datacenter.taskboard.location
  size     = 1
}

resource "ionoscloud_natgateway" "egress" {
  datacenter_id = ionoscloud_datacenter.taskboard.id
  name          = "taskboard-nat"
  public_ips    = [ionoscloud_ipblock.nat.ips[0]]

  lans {
    id          = ionoscloud_lan.app.id
    gateway_ips = ["10.10.1.4"]
  }
  lans {
    id          = ionoscloud_lan.db.id
    gateway_ips = ["10.10.2.4"]
  }
}

resource "ionoscloud_natgateway_rule" "app_out" {
  datacenter_id = ionoscloud_datacenter.taskboard.id
  natgateway_id = ionoscloud_natgateway.egress.id
  name          = "app-egress"
  type          = "SNAT"
  protocol      = "ALL"
  source_subnet = local.cidr.app
  public_ip     = ionoscloud_ipblock.nat.ips[0]
}

public_ips muss reservierte IP-Adressen am Standort des Gateways sein. Jeder lans-Block verbindet ein privates LAN; ein Gateway unterstützt bis zu sechs private Netzwerke. Nur private LANs können verbunden werden, und ein an das Gateway angeschlossenes LAN kann nicht von privat auf öffentlich umgestellt werden. gateway_ips wird automatisch generiert, wenn Sie es weglassen, aber eine feste Adresse macht die Route in Abschnitt 3.2 vorhersagbar.

Das protocol einer Regel ist TCP, UDP, ICMP oder ALL (Standard). target_subnet und target_port_range schränken die Regel auf bestimmte Zieladressen ein; ohne sie trifft die Regel jede Adresse und jeden Port. Fügen Sie eine zweite Regel mit source_subnet = local.cidr.db für die DB-Ebene hinzu.

3.2 Serververkehr zum Gateway routen

Das NAT-Gateway injiziert keine Standardroute in Ihre Server. Die Routing-Tabelle jeder privaten VM muss ihre Standardroute auf die Gateway-IP zeigen oder eine dedizierte Route für jedes Internetziel enthalten. Führen Sie dies beim ersten Start mit cloud-init aus:

#cloud-config
runcmd:
  - ip route replace default via 10.10.1.4

Machen Sie die Route in der Netzwerkkonfiguration des Images für den Produktivbetrieb persistent. Wenn die VM DNS über diese Standardroute auflöst, stellen Sie sicher, dass die SNAT-Regeln UDP abdecken, da die DNS-Auflösung sonst möglicherweise nicht mehr funktioniert. Die oben genannte ALL-Regel deckt dies ab.

4. Hybrid-Verbindung mit dem VPN Gateway

Das VPN Gateway unterstützt IPSec und WireGuard. Diese Einheit verwendet IPSec mit IKEv2 und einem Pre-Shared Key (PSK).

4.1 Gateway und Tunnel

resource "ionoscloud_vpn_ipsec_gateway" "office" {
  name        = "taskboard-office-vpn"
  location    = ionoscloud_datacenter.taskboard.location
  # ionoscloud_ipblock.vpn: a one-address block, like ionoscloud_ipblock.nat
  gateway_ip  = ionoscloud_ipblock.vpn.ips[0]
  version     = "IKEv2"
  description = "Office to TaskBoard app LAN"
  tier        = "STANDARD"

  connections {
    datacenter_id = ionoscloud_datacenter.taskboard.id
    lan_id        = ionoscloud_lan.app.id
    ipv4_cidr     = "10.10.1.5/24"
  }
}

resource "ionoscloud_vpn_ipsec_tunnel" "office" {
  location    = ionoscloud_datacenter.taskboard.location
  gateway_id  = ionoscloud_vpn_ipsec_gateway.office.id
  name        = "office-tunnel"
  remote_host = var.office_vpn_host

  auth {
    method  = "PSK"
    psk_key = var.vpn_psk
  }
  ike {
    diffie_hellman_group = "16-MODP4096"
    encryption_algorithm = "AES256"
    integrity_algorithm  = "SHA256"
  }
  esp {
    diffie_hellman_group = "16-MODP4096"
    encryption_algorithm = "AES256"
    integrity_algorithm  = "SHA256"
  }

  cloud_network_cidrs = [local.cidr.app]
  peer_network_cidrs  = [var.office_cidr]
}

gateway_ip ist eine reservierte öffentliche IP in derselben Rechenzentrumsstandort wie die Verbindungen, und alle Verbindungen müssen demselben VDC zugeordnet sein. ipv4_cidr ist die private Gateway-Adresse, über die LAN-Clients geroutet werden; sie muss im Subnetz des LAN liegen. Deklarieren Sie var.vpn_psk mit sensitive = true. Das Produkt erstellt keine PSKs für Sie, und ein 32 Zeichen langer Schlüssel wird empfohlen.

4.2 Regeln, die Ihren Code beeinflussen

  • Nur statische Routen. BGP und dynamisches Routing sind nicht verfügbar. Wie bei NAT benötigen Server eine Route zum Peer-Netzwerk über die LAN-Adresse des Gateways, beispielsweise ip route add 192.168.50.0/24 via 10.10.1.5.
  • Kein DHCP-Support. Die LAN-Adresse des Gateways ist statisch, weshalb sie aus dem reservierten Bereich stammt (Abschnitt 1.3).
  • IPv4-Tunnelendpunkte. Der Tunnelendpunkt und die Gateway-IP-Adresse sind ausschließlich IPv4.
  • Stufenlimits. STANDARD erlaubt 5 LANs und 10 Tunnel, ENHANCED 10 LANs und 20 Tunnel, PREMIUM 15 LANs und 30 Tunnel.
  • Löschreihenfolge. Löschen Sie das VPN Gateway vor dem verbundenen VDC. Terraform folgt dem Abhängigkeitsgraphen, aber eine manuelle Rechenzentrumslöschung verletzt diese Regel.

Die VPN Gateway API ist regional. Verwenden Sie den Endpunkt des Standorts Ihres VDC, beispielsweise https://vpn.de-txl.ionos.com/ipsecgateways für de/txl.

5. DNS as Code mit Cloud DNS

resource "ionoscloud_dns_zone" "taskboard" {
  name        = "taskboard.example.com"
  description = "TaskBoard public zone"
  enabled     = true
}

resource "ionoscloud_dns_record" "api" {
  zone_id = ionoscloud_dns_zone.taskboard.id
  name    = "api"
  type    = "A"
  content = ionoscloud_ipblock.api.ips[0]
  ttl     = 300
  enabled = true
}

Für die Autorisierung werden bei den Ressourcen ionoscloud_dns_zone und ionoscloud_dns_record ausschließlich Tokens akzeptiert. Daher ist IONOS_TOKEN (Einheit 1.2) zu verwenden, statt eines Benutzernamens und Passworts. Nur Vertragsinhaber, Administratoren und Benutzer mit dem Privileg accessAndManageDns können über die API primäre Zonen und Datensätze erstellen und verwalten.

5.1 Einstellungen für Datensätze

name ist sowohl auf Zonen- als auch auf Datensatzebene unveränderlich. Der Wert für ttl eines Datensatzes beträgt standardmäßig 3600 Sekunden; Cloud DNS akzeptiert TTL-Werte von 60 bis 604800 Sekunden. Eine kurze TTL wie 300 ermöglicht es, die API schnell auf eine neue IP-Adresse umzustellen. Unterstützte Typen sind unter anderem A, AAAA, CNAME, ALIAS, MX, TXT, SRV und CAA. Wildcard-Datensätze werden ebenfalls unterstützt.

5.2 Delegation der Domain

Eine Zone beantwortet Abfragen erst, nachdem Ihr Registrar die Domain auf die Cloud DNS-Nameserver zeigt: ns-ic.ui-dns.com, ns-ic.ui-dns.de, ns-ic.ui-dns.org und ns-ic.ui-dns.biz. Änderungen an den Nameservern können bis zu 48 Stunden zur Ausbreitung benötigen. Testen Sie die Zone zunächst direkt:

dig +short api.taskboard.example.com @ns-ic.ui-dns.com

Schnellkarte zur API-Referenz

Wichtige API-Endpunkte hinter den Ressourcen dieser Einheit:

Methode Endpunkt Beschreibung
POST /datacenters/{datacenterId}/lans Erstellt von ionoscloud_lan
POST /datacenters/{datacenterId}/servers/{serverId}/nics Erstellt von ionoscloud_nic
POST /datacenters/{datacenterId}/natgateways Erstellt von ionoscloud_natgateway
POST /ipsecgateways Erstellt von ionoscloud_vpn_ipsec_gateway (VPN API, https://vpn.{region}.ionos.com)
POST /zones/{zoneId}/records Erstellt von ionoscloud_dns_record (DNS API, https://dns.de-fra.ionos.com)

Basis-URL: https://api.ionos.com/cloudapi/v6 (VPN und DNS verwenden eigene Basis-URLs, wie oben gezeigt) Authentifizierung: Authorization: Bearer <token>

Code-Labor

Ziel: Erstellen Sie das dreistufige Netzwerk von TaskBoard mit Terraform (öffentliche, App- und DB-LANs, NICs und ein NAT-Gateway), und überprüfen Sie anschließend die Konnektivität zwischen den Ebenen sowie den ausgehenden Zugriff aus der privaten Ebene.

Voraussetzungen:

  • Das Compute-Tier-Projekt aus Einheit 2.1 und das IONOS_TOKEN-Set
  • Terraform mit dem Provider wie in Einheit 1.2 festgelegt
  • Ihr SSH-Schlüssel in TF_VAR_ssh_public_key

Schritt 1: Die privaten LANs hinzufügen

Fügen Sie die App- und DB-LANs aus Abschnitt 1 und den locals-Block aus Abschnitt 1.2 zu main.tf hinzu. Planen Sie anschließend:

terraform plan | tail -n 1

Erwartete Ausgabe:

Plan: 2 to add, 0 to change, 0 to destroy.

Schritt 2: Worker in das App-LAN verschieben und die App-NIC des API-Servers hinzufügen

Ändern Sie die Inline-nic des Workers auf die Version aus Abschnitt 2.2 und fügen Sie ionoscloud_nic.api_app aus Abschnitt 2.1 hinzu. Speichern Sie die cloud-config aus Abschnitt 3.2 als cloud-init/worker.yaml und fügen Sie user_data = base64encode(file("${path.module}/cloud-init/worker.yaml")) zum volume-Block des Workers hinzu. Da user_data nur auf ein neues Volume zutrifft, muss der Worker neu aufgebaut werden; da er zustandslos ist, ist das sicher.

terraform plan -replace=ionoscloud_vcpu_server.worker | grep -E "replaced|created"

Erwartete Ausgabe:

  # ionoscloud_lan.app will be created
  # ionoscloud_lan.db will be created
  # ionoscloud_nic.api_app will be created
  # ionoscloud_vcpu_server.worker will be replaced, as requested

Schritt 3: NAT-Gateway und Regeln hinzufügen

Fügen Sie ionoscloud_ipblock.nat, ionoscloud_natgateway.egress und beide SNAT-Regeln aus Abschnitt 3.1 hinzu, und wenden Sie diese dann an:

terraform apply -replace=ionoscloud_vcpu_server.worker -auto-approve | tail -n 1

Erwartete Ausgabe:

Apply complete! Resources: ... added, ... changed, ... destroyed.

Schritt 4: Das NAT-Gateway über die API überprüfen

DC=$(terraform output -raw datacenter_id)
curl -s -H "Authorization: Bearer $IONOS_TOKEN" \
  "https://api.ionos.com/cloudapi/v6/datacenters/$DC/natgateways?depth=2" \
  | jq '.items[0].properties | {name, publicIps, lans}'

Erwartete Ausgabe:

{
  "name": "taskboard-nat",
  "publicIps": ["<nat IP>"],
  "lans": [ { "id": <app LAN id>, "gatewayIps": ["10.10.1.4"] }, { "id": <db LAN id>, "gatewayIps": ["10.10.2.4"] } ]
}

Schritt 5: Erreichen Sie den Worker über das App-LAN

ssh -J root@"$(terraform output -raw api_public_ip)" root@10.10.1.21 'hostname; ip route show default'

Erwartete Ausgabe:

taskboard-worker-01
default via 10.10.1.4 dev ...

Schritt 6: Testen des ausgehenden Zugriffs vom privaten Worker

ssh -J root@"$(terraform output -raw api_public_ip)" root@10.10.1.21 \
  'curl -sI --max-time 10 https://api.ionos.com/cloudapi/v6/ | head -n 1'

Erwartete Ausgabe:

HTTP/... <status code>

Jede HTTP-Antwortzeile belegt, dass der private Worker das Internet über das NAT-Gateway erreicht hat; ein Timeout bedeutet, dass die Route oder die SNAT-Regel fehlt.

Prüfliste:

  • [ ] Drei LANs existieren: ein öffentliches und zwei private mit den von Ihnen festgelegten CIDR-Blöcken
  • [ ] Der Worker hat keine öffentliche IP und ist ausschließlich über den API-Server erreichbar
  • [ ] Die Standardroute des Workers zeigt auf 10.10.1.4
  • [ ] Der Worker erreicht das Internet über die öffentliche IP des NAT-Gateways

Aufräumarbeiten:

terraform destroy -auto-approve

Häufige Fehler

Fehler von Entwicklerinnen und Entwicklern, die bei diesem Thema der Einheit zu vermeiden sind:

  1. NAT-Gateway erstellt, aber private Server haben kein Internet

    • Problem: curl von einem privaten Server läuft in ein Timeout, obwohl das NAT-Gateway und die Regeln vorhanden sind.
    • Ursache: Das Gateway injiziert keine Standardroute. Der Server hat weiterhin keine Route zur Gateway-IP.
    • Lösung: gateway_ips explizit setzen und ip route replace default via <gateway ip> in cloud-init hinzufügen (Abschnitt 3.2). Falls die Namensauflösung fehlschlägt, prüfen, ob die SNAT-Regeln UDP abdecken.
  2. Statische Gateway-Adresse kollidiert mit DHCP

    • Problem: Die Adresse eines VPN- oder NAT-Gateways kollidiert mit einem Server, und der Verkehr wird an den falschen Host gesendet.
    • Ursache: Die Schnittstelle des VPN-Gateways ist nicht DHCP-fähig, und es wurde eine Adresse gewählt, die DHCP zuweisen könnte.
    • Lösung: Adressen aus dem reservierten Bereich für verwaltete Dienste von .2 bis .9 verwenden (Abschnitt 1.3) und Servern Adressen ab .10 zuweisen.
  3. DNS-Ressourcen schlagen mit Basis-Authentifizierung fehl

    • Problem: ionoscloud_dns_zone kann sich in einer Pipeline nicht authentifizieren, die IONOS_USERNAME und IONOS_PASSWORD verwendet.
    • Ursache: Für die Autorisierung in den DNS-Ressourcen werden nur Tokens akzeptiert.
    • Lösung: Ein Token generieren, als CI-Geheimnis speichern und als IONOS_TOKEN exportieren.

Zusammenfassung

Sie können das Netzwerk von TaskBoard nun als Code beschreiben. Öffentliche und private LANs trennen die Ebenen mit expliziten RFC 1918-Blöcken, Server treten mehreren LANs über Inline- und separate NICs bei, und ein Managed NAT Gateway gewährt privaten Servern ausgehenden Zugriff, sobald deren Routen darauf zeigen. Ein IPSec-VPN-Gateway verbindet das Büro mit statischen Routen, und Cloud DNS veröffentlicht einen stabilen Namen für die API.

Wichtige Punkte:

  • Private LAN-Blöcke müssen RFC 1918 entsprechen, /23 bis /28 sein und ausgerichtet sein; weggelassene Blöcke erhalten ein /23 aus 10.0.0.0/8
  • Vergeben Sie für verwaltete Dienste LAN-Adressen aus dem reservierten Bereich von .2 bis .9
  • Das NAT-Gateway ist nur SNAT, verbindet bis zu sechs private LANs und benötigt eine Route auf jedem Server
  • Das VPN-Gateway verwendet nur statisches Routing, IKEv2 mit PSK für IPSec und einen regionalen API-Endpunkt
  • DNS-Ressourcen akzeptieren nur Tokens; delegieren Sie die Domain an die vier Cloud DNS-Nameserver

Wichtige Begriffe:

  • Privates LAN: Ein LAN mit public = false, dessen NICs private Adressen erhalten und keine Internet-Exposition haben
  • SNAT-Regel: Eine NAT-Gateway-Regel, die die Quelladresse ausgehender Pakete mit einer öffentlichen IP maskiert
  • Gateway-IP: Die eigene Adresse des NAT- oder VPN-Gateways in einem privaten LAN, die als Routenziel verwendet wird
  • Pre-Shared Key (PSK): Das geteilte Geheimnis, das beide Enden eines IPSec-Tunnels authentifiziert
  • Delegation: Die Zuweisung der Nameserver einer Domain zu Cloud DNS, damit die Zone öffentliche Abfragen beantwortet

Nächste Schritte

Weiter lernen: Einheit 2.3: Lastverteilung und Security as Code

Verwandte Themen: