Unité 2.2 : Réseau et connectivité en tant que code
Introduction
Dans l'unité 2.1, votre serveur API et votre worker étaient situés sur un même LAN public. Cela convient pour un test, mais la base de données et le worker de TaskBoard ne doivent jamais être accessibles depuis Internet, et l'équipe d'exploitation souhaite un chemin privé depuis le réseau du bureau. Vous avez besoin d'une segmentation réseau, d'un trafic sortant contrôlé et d'un nom DNS stable pour l'API, le tout révisable dans Git.
Dans cette unité, vous construisez cette pile réseau avec Terraform : un LAN public pour le point d'entrée de l'API, un LAN applicatif et un LAN base de données qui restent privés, un Managed NAT Gateway pour le trafic sortant des couches privées, une passerelle VPN IPSec pour un accès hybride, et des enregistrements Cloud DNS pour l'API. Dans le Code Lab, vous déployez le réseau et vérifiez la connectivité entre les couches.
1. Réseaux locaux pour la segmentation en plusieurs niveaux
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 expose une LAN à Internet ; public = false la garde privée et isole son trafic de tout accès externe. La LAN publique existe déjà depuis l'unité 1.2 ; les LAN de l'application et de la base de données sont nouvelles.
1.1 Choix des blocs CIDR privés
Si vous omettez ipv4_cidr_block sur une LAN privée, un bloc /23 de la plage 10.0.0.0/8 est attribué automatiquement. Définissez-le explicitement si vous avez besoin d'adresses prévisibles pour les routes, les règles de pare-feu ou un VPN. Un bloc personnalisé doit :
- se situer dans une plage privée RFC 1918 (
10.0.0.0/8,172.16.0.0/12ou192.168.0.0/16) - avoir une longueur de préfixe comprise entre /23 et /28
- être aligné sur sa frontière de préfixe (
10.5.0.0/24, et non10.5.0.1/24)
Il ne peut être défini que sur des LAN privées. Sa modification met à jour la LAN sur place.
1.2 Lecture des erreurs CIDR
Lorsque l'API rejette un bloc, l'erreur du fournisseur contient le code d'erreur de l'API :
| Code | Signification |
|---|---|
536 |
Non aligné sur sa frontière de préfixe |
602 |
Se superpose à un bloc déjà utilisé |
654 |
Non une plage privée |
655 |
Plus grand que /23 |
656 |
Défini sur une LAN publique |
Comme le montre le tableau, la plupart des erreurs proviennent de blocs copiés-collés. Conservez tous les blocs d'un environnement dans une seule carte locals afin que les chevauchements apparaissent lors de la revue :
locals {
cidr = {
app = "10.10.1.0/24"
db = "10.10.2.0/24"
}
}
1.3 Adresses réservées pour les services gérés
DHCP n'attribue jamais d'adresses se terminant par .0 à .9 ou .224 à .255. Les adresses de .2 à .9 sont réservées aux services gérés. Lorsque vous attribuez une adresse LAN à un service géré, tel qu'une passerelle NAT ou une passerelle VPN, choisissez-la dans cette plage réservée afin d'éviter les conflits avec les adresses IP attribuées par DHCP. Les exemples de cette unité utilisent .4 pour la passerelle NAT et .5 pour la passerelle VPN.
2. Cartes réseau : Attacher des serveurs aux LAN
2.1 Cartes réseau intégrées et distinctes
Le serveur API a besoin d'une carte réseau publique pour les clients et d'une carte réseau privée pour la couche d'application. Conservez la première carte réseau intégrée au serveur et ajoutez la seconde en tant que ressource distincte :
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 et lan sont obligatoires, et lan est l'identifiant numérique du LAN. ips prend une liste d'adresses ; le passage de null ou d'une liste vide assigne une adresse automatiquement. Les adresses IP publiques explicitement assignées doivent provenir de blocs IP réservés (Unité 2.1). L'adresse IPv4 privée de la carte réseau est assignée statiquement à son adresse MAC, de sorte qu'une adresse DHCP sur un LAN privé reste associée à la carte réseau.
2.2 Serveurs uniquement privés
Le worker n'a aucune carte réseau publique :
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"]
}
}
L'argument mac d'une NIC ne peut être défini qu'au moment de la création et est immuable ; si vous ne le définissez pas, l'API en attribue un.
3. Accès sortant avec le Managed NAT Gateway
Le Managed NAT Gateway permet aux VM d'un VDC d'accéder à Internet sans interface réseau publique. Il fournit uniquement la Source NAT (SNAT) : les VM initient les connexions et reçoivent les réponses, et les connexions entrantes initiées depuis Internet ne sont pas acceptées.
3.1 Passerelle et règles
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 doit être des adresses IP réservées dans l'emplacement de la passerelle. Chaque bloc lans connecte un LAN privé ; une passerelle prend en charge jusqu'à six réseaux privés. Seuls les LAN privés peuvent être connectés, et un LAN connecté à la passerelle ne peut pas être modifié de privé à public. gateway_ips est généré automatiquement si vous l'omettez, mais une adresse fixe rend la route de la section 3.2 prévisible.
Le protocol d'une règle est TCP, UDP, ICMP ou ALL (par défaut). target_subnet et target_port_range restreignent la règle aux destinations ; sans eux, la règle correspond à n'importe quelle adresse et à n'importe quel port. Ajoutez une deuxième règle avec source_subnet = local.cidr.db pour la couche de base de données.
3.2 Routage du trafic serveur vers la passerelle
La passerelle NAT n'injecte pas de route par défaut dans vos serveurs. La table de routage de chaque VM privée doit pointer sa route par défaut vers l'IP de la passerelle, ou contenir une route dédiée pour chaque destination internet. Effectuez cette opération au premier démarrage avec cloud-init :
#cloud-config
runcmd:
- ip route replace default via 10.10.1.4
Rendez la route persistante dans la configuration réseau de l'image pour la production. Si la VM résout DNS via cette route par défaut, assurez-vous que les règles SNAT couvrent le protocole UDP, car la résolution DNS pourrait cesser de fonctionner. La règle ALL ci-dessus le couvre.
4. Connectivité hybride avec la VPN Gateway
La VPN Gateway prend en charge IPSec et WireGuard. Cette unité utilise IPSec avec IKEv2 et une clé partagée préalable (PSK).
4.1 Passerelle et 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 est une adresse IP publique réservée située dans le même centre de données que les connexions, et toutes les connexions doivent appartenir au même VDC. ipv4_cidr est l'adresse de passerelle privée par laquelle les clients LAN acheminent leur trafic ; elle doit se trouver dans le sous-réseau du LAN. Déclarez var.vpn_psk avec sensitive = true. Le produit ne crée pas de PSK à votre place, et une clé de 32 caractères est recommandée.
4.2 Règles qui affectent votre code
- Routage statique uniquement. BGP et le routage dynamique ne sont pas disponibles. Comme pour NAT, les serveurs ont besoin d'une route vers le réseau pair via l'adresse LAN de la passerelle, par exemple
ip route add 192.168.50.0/24 via 10.10.1.5. - Non compatible avec DHCP. L'adresse LAN de la passerelle est statique, c'est pourquoi elle provient de la plage réservée (section 1.3).
- Points de terminaison de tunnel IPv4. Le point de terminaison du tunnel et l'adresse IP de la passerelle sont uniquement IPv4.
- Limites par niveau.
STANDARDautorise 5 LAN et 10 tunnels,ENHANCED10 LAN et 20 tunnels,PREMIUM15 LAN et 30 tunnels. - Ordre de suppression. Supprimez la VPN Gateway avant le VDC connecté. Terraform suit le graphe de dépendances, mais une suppression manuelle du centre de données viole cette règle.
L'API de la VPN Gateway est régionale. Utilisez le point de terminaison de l'emplacement de votre VDC, par exemple https://vpn.de-txl.ionos.com/ipsecgateways pour de/txl.
5. DNS en tant que code avec 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
}
Seuls les jetons sont acceptés pour l'autorisation dans les ressources ionoscloud_dns_zone et ionoscloud_dns_record, il faut donc définir IONOS_TOKEN (Unité 1.2) plutôt qu'un nom d'utilisateur et un mot de passe. Seuls les propriétaires de contrat, les administrateurs et les utilisateurs disposant du privilège accessAndManageDns peuvent créer et gérer les zones principales et les enregistrements via l'API.
5.1 Paramètres des enregistrements
name est immuable, tant au niveau de la zone qu'au niveau de l'enregistrement. La valeur par défaut de ttl pour l'enregistrement est de 3600 secondes ; Cloud DNS accepte des TTL compris entre 60 et 604800 secondes. Un TTL court, comme 300, permet de faire basculer l'API vers une nouvelle adresse IP rapidement. Les types pris en charge incluent A, AAAA, CNAME, ALIAS, MX, TXT, SRV et CAA, et les enregistrements jokers sont pris en charge.
5.2 Délégation du domaine
Une zone ne répond aux requêtes qu'après que votre registrar a pointé le domaine vers les serveurs de noms de Cloud DNS : ns-ic.ui-dns.com, ns-ic.ui-dns.de, ns-ic.ui-dns.org et ns-ic.ui-dns.biz. Les modifications des serveurs de noms peuvent prendre jusqu'à 48 heures pour se propager. Testez d'abord la zone directement :
dig +short api.taskboard.example.com @ns-ic.ui-dns.com
Fiche de référence rapide de l'API
Principaux points de terminaison d'API derrière les ressources de cette unité :
| Méthode | Point de terminaison | Description |
|---|---|---|
POST |
/datacenters/{datacenterId}/lans |
Créé par ionoscloud_lan |
POST |
/datacenters/{datacenterId}/servers/{serverId}/nics |
Créé par ionoscloud_nic |
POST |
/datacenters/{datacenterId}/natgateways |
Créé par ionoscloud_natgateway |
POST |
/ipsecgateways |
Créé par ionoscloud_vpn_ipsec_gateway (API VPN, https://vpn.{region}.ionos.com) |
POST |
/zones/{zoneId}/records |
Créé par ionoscloud_dns_record (API DNS, https://dns.de-fra.ionos.com) |
URL de base : https://api.ionos.com/cloudapi/v6 (VPN et DNS utilisent leurs propres URL de base, indiquées ci-dessus)
Authentification : Authorization: Bearer <token>
Atelier de code
Objectif : Construire le réseau à trois niveaux de TaskBoard avec Terraform (LAN publiques, applicative et de base de données, cartes réseau et passerelle NAT), puis vérifier la connectivité entre les niveaux et l'accès sortant depuis le niveau privé.
Prérequis :
- Le projet du niveau de calcul de l'Unité 2.1, avec
IONOS_TOKENdéfini - Terraform avec le fournisseur verrouillé comme dans l'Unité 1.2
- Votre clé SSH dans
TF_VAR_ssh_public_key
Étape 1 : Ajouter les LAN privées
Ajoutez les LAN applicative et de base de données de la section 1 et le bloc locals de la section 1.2 à main.tf. Puis planifiez :
terraform plan | tail -n 1
Sortie attendue :
Plan: 2 to add, 0 to change, 0 to destroy.
Étape 2 : Déplacer le worker vers le LAN de l'application et ajouter la NIC d'application du serveur API
Modifiez le paramètre en ligne nic du worker pour la version de la section 2.2 et ajoutez ionoscloud_nic.api_app de la section 2.1. Enregistrez le cloud-config de la section 3.2 sous cloud-init/worker.yaml et ajoutez user_data = base64encode(file("${path.module}/cloud-init/worker.yaml")) au bloc volume du worker. Comme user_data ne s'applique qu'à un nouveau volume, le worker doit être reconstruit ; il est sans état, ce qui est donc sans risque.
terraform plan -replace=ionoscloud_vcpu_server.worker | grep -E "replaced|created"
Sortie attendue :
# 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
Étape 3 : Ajouter la passerelle NAT et les règles
Ajoutez ionoscloud_ipblock.nat, ionoscloud_natgateway.egress et les deux règles SNAT de la section 3.1, puis appliquez :
terraform apply -replace=ionoscloud_vcpu_server.worker -auto-approve | tail -n 1
Sortie attendue :
Apply complete! Resources: ... added, ... changed, ... destroyed.
Étape 4 : Vérifier le gateway NAT via l'API
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}'
Sortie attendue :
{
"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"] } ]
}
Étape 5 : Atteindre le worker via le LAN de l'application
ssh -J root@"$(terraform output -raw api_public_ip)" root@10.10.1.21 'hostname; ip route show default'
Sortie attendue :
taskboard-worker-01
default via 10.10.1.4 dev ...
Étape 6 : Tester l'accès sortant depuis le worker privé
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'
Sortie attendue :
HTTP/... <status code>
Toute ligne de statut HTTP prouve que le worker privé a atteint Internet via la passerelle NAT ; un dépassement de délai d'attente signifie que l'itinéraire ou la règle SNAT est manquant.
Liste de contrôle de validation :
- [ ] Trois LAN existent : un public, deux privés avec les blocs CIDR que vous avez définis
- [ ] Le worker n'a pas d'IP publique et n'est accessible que via le serveur API
- [ ] L'itinéraire par défaut du worker pointe vers
10.10.1.4 - [ ] Le worker atteint Internet via l'IP publique de la passerelle NAT
Nettoyage :
terraform destroy -auto-approve
Erreurs courantes
Erreurs de développement à éviter concernant le sujet de cette unité :
-
Passerelle NAT créée, mais les serveurs privés n'ont pas d'accès à Internet
- Problème :
curldepuis un serveur privé expirer, bien que la passerelle NAT et les règles existent. - Cause : La passerelle n'injecte pas de route par défaut. Le serveur n'a toujours pas de route vers l'adresse IP de la passerelle.
- Correction : Définir
gateway_ipsexplicitement et ajouterip route replace default via <gateway ip>dans cloud-init (section 3.2). Si la résolution des noms échoue, vérifier que les règles SNAT couvrent le protocole UDP.
- Problème :
-
Conflit entre l'adresse statique de la passerelle et le DHCP
- Problème : L'adresse d'une passerelle VPN ou NAT entre en conflit avec celle d'un serveur, et le trafic est dirigé vers l'hôte incorrect.
- Cause : L'interface de la passerelle VPN n'est pas compatible avec le DHCP, et vous avez choisi une adresse que le DHCP peut attribuer.
- Correction : Utiliser des adresses issues de la plage réservée aux services gérés, de
.2à.9(section 1.3), et attribuer aux serveurs des adresses à partir de.10.
-
Échec des ressources DNS avec une authentification basique
- Problème :
ionoscloud_dns_zoneéchoue à s'authentifier dans un pipeline qui utiliseIONOS_USERNAMEetIONOS_PASSWORD. - Cause : Seuls les jetons sont acceptés pour l'autorisation dans les ressources DNS.
- Correction : Générer un jeton, le stocker en tant que secret CI et l'exporter sous le nom
IONOS_TOKEN.
- Problème :
Résumé
Vous pouvez désormais décrire le réseau de TaskBoard sous forme de code. Les LAN publiques et privées séparent les niveaux à l'aide de blocs RFC 1918 explicites, les serveurs rejoignent plusieurs LAN via des NIC en ligne et séparées, et un Managed NAT Gateway accorde aux serveurs privés un accès sortant une fois que leurs routes pointent vers celui-ci. Un passerelle VPN IPSec connecte le bureau avec des routes statiques, et Cloud DNS publie un nom stable pour l'API.
Points clés :
- Les blocs de LAN privés doivent être RFC 1918, de /23 à /28 et alignés ; les blocs omis reçoivent un /23 de
10.0.0.0/8 - Attribuez aux services gérés des adresses LAN issues de la plage réservée de
.2à.9 - La passerelle NAT est uniquement SNAT, connecte jusqu'à six LAN privées, et nécessite une route sur chaque serveur
- La passerelle VPN utilise uniquement le routage statique, IKEv2 avec PSK pour IPSec, et un point d'entrée API régional
- Les ressources DNS n'acceptent que des jetons ; déléguez le domaine aux quatre serveurs de noms Cloud DNS
Terminologie importante :
- LAN privée : Une LAN avec
public = falsedont les NIC reçoivent des adresses privées et n'ont aucune exposition à Internet - Règle SNAT : Une règle de passerelle NAT qui masque l'adresse source des paquets sortants avec une IP publique
- IP de passerelle : L'adresse propre de la passerelle NAT ou VPN dans une LAN privée, utilisée comme cible de route
- Clé pré-partagée (PSK) : Le secret partagé qui authentifie les deux extrémités d'un tunnel IPSec
- Délégation : Pointage des serveurs de noms d'un domaine vers Cloud DNS afin que la zone réponde aux requêtes publiques
Prochaines étapes
Poursuivre l'apprentissage : Unité 2.3 : Équilibrage de charge et sécurité en tant que code
Sujets connexes :