Unidad 2.2: Red y conectividad como código
Introducción
En la Unidad 2.1, su servidor de API y el worker estaban en una sola LAN pública. Eso está bien para una prueba, pero la base de datos y el worker de TaskBoard nunca deben ser accesibles desde internet, y el equipo de operaciones desea una ruta privada desde la red de la oficina. Necesita segmentación de red, salida controlada y un nombre de DNS estable para la API, todo revisable en Git.
En esta unidad, construye esa pila de red con Terraform: una LAN pública para el punto de entrada de la API, una LAN de aplicaciones y una LAN de base de datos que permanecen privadas, un Managed NAT Gateway para el tráfico saliente desde las capas privadas, un gateway de VPN IPSec para acceso híbrido y registros de Cloud DNS para la API. En el Code Lab, implementa la red y verifica la conectividad entre las capas.
1. LANs para segmentación multinivel
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 hace que una LAN se conecte a internet; public = false la mantiene privada e aísla su tráfico del acceso externo. La LAN pública ya existe desde la Unidad 1.2; las LANs de la aplicación y de la base de datos son nuevas.
1.1 Selección de los bloques CIDR privados
Si omite ipv4_cidr_block en una LAN privada, se asigna automáticamente un bloque /23 del rango 10.0.0.0/8. Establezca este valor de forma explícita cuando necesite direcciones predecibles para rutas, reglas de firewall o una VPN. Un bloque personalizado debe:
- estar dentro de un rango privado RFC 1918 (
10.0.0.0/8,172.16.0.0/12o192.168.0.0/16) - tener una longitud de prefijo entre /23 y /28
- estar alineado con su límite de prefijo (
10.5.0.0/24, no10.5.0.1/24)
Solo puede establecerse en LANs privadas. Al cambiarlo, la LAN se actualiza en su lugar.
1.2 Lectura de errores de CIDR
Cuando la API rechaza un bloque, el error del proveedor contiene el código de error de la API:
| Código | Significado |
|---|---|
536 |
No está alineado con su límite de prefijo |
602 |
Se superpone con un bloque ya en uso |
654 |
No es un rango privado |
655 |
Es mayor que /23 |
656 |
Está establecido en una LAN pública |
Como muestra la tabla, la mayoría de los errores provienen de bloques copiados y pegados. Mantenga todos los bloques de un entorno en un solo mapa locals para que las superposiciones se detecten durante la revisión:
locals {
cidr = {
app = "10.10.1.0/24"
db = "10.10.2.0/24"
}
}
1.3 Direcciones reservadas para servicios gestionados
DHCP nunca asigna direcciones que terminan en .0 a .9 ni .224 a .255. Las direcciones desde .2 hasta .9 están reservadas para servicios gestionados. Al asignar una dirección LAN a un servicio gestionado, como un gateway NAT o un gateway VPN, debe tomarla de ese rango reservado para evitar conflictos con las direcciones IP asignadas por DHCP. Los ejemplos de esta unidad utilizan .4 para el gateway NAT y .5 para el gateway VPN.
2. NICs: Conexión de servidores a LANs
2.1 NICs integradas e independientes
El servidor de API requiere una NIC pública para los clientes y una NIC privada para la capa de aplicación. Mantenga la primera NIC integrada en el servidor y agregue la segunda como un recurso independiente:
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 y lan son obligatorios, y lan es el identificador numérico de la LAN. ips acepta una lista de direcciones; si se pasa null o una lista vacía, se asigna una dirección automáticamente. Las direcciones IP públicas asignadas explícitamente deben provenir de bloques de IP reservados (Unidad 2.1). La dirección IPv4 privada de la NIC se asigna de forma estática a su dirección MAC, por lo que una dirección DHCP en una LAN privada permanece asociada a la NIC.
2.2 Servidores solo privados
El worker no tiene ninguna NIC pública:
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"]
}
}
El argumento mac de una NIC solo se puede establecer en el momento de la creación y es inmutable; si no lo establece, la API asignará uno.
3. Acceso saliente con el Managed NAT Gateway
El Managed NAT Gateway permite que las VM en un VDC accedan a internet sin una interfaz de red pública. Solo proporciona Source NAT (SNAT): las VM inician conexiones y reciben respuestas, y las conexiones entrantes iniciadas desde internet no se aceptan.
3.1 Gateway y reglas
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 debe consistir en direcciones IP reservadas en la ubicación de la pasarela. Cada bloque lans conecta una LAN privada; una pasarela admite hasta seis redes privadas. Solo se pueden conectar LANs privadas, y una LAN conectada a la pasarela no puede cambiarse de privada a pública. gateway_ips se genera automáticamente si se omite, pero una dirección fija hace que la ruta de la sección 3.2 sea predecible.
El protocol de una regla es TCP, UDP, ICMP o ALL (el valor predeterminado). target_subnet y target_port_range restringen la regla a destinos; sin ellos, la regla coincide con cualquier dirección y puerto. Agregue una segunda regla con source_subnet = local.cidr.db para la capa de BD.
3.2 Enrutamiento del tráfico del servidor a la pasarela
La pasarela NAT no inyecta una ruta predeterminada en sus servidores. La tabla de enrutamiento de cada VM privada debe apuntar su ruta predeterminada a la IP de la pasarela, o contener una ruta dedicada para cada destino de internet. Hágalo en el primer arranque con cloud-init:
#cloud-config
runcmd:
- ip route replace default via 10.10.1.4
Haga que la ruta sea persistente en la configuración de red de la imagen para producción. Si la VM resuelve DNS a través de esta ruta predeterminada, asegúrese de que las reglas SNAT cubran UDP, o la resolución de DNS podría dejar de funcionar. La regla ALL anterior la cubre.
4. Conectividad híbrida con VPN Gateway
VPN Gateway admite IPSec y WireGuard. Esta unidad utiliza IPSec con IKEv2 y una clave precompartida (PSK).
4.1 Pasarela y túnel
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 es una IP pública reservada en la misma ubicación de centro de datos que las conexiones, y todas las conexiones deben pertenecer al mismo VDC. ipv4_cidr es la dirección de la pasarela privada por la que los clientes de LAN enrutan; debe estar dentro de la subred de la LAN. Declare var.vpn_psk con sensitive = true. El producto no crea PSKs por usted, y se recomienda una clave de 32 caracteres.
4.2 Reglas que afectan su código
- Solo enrutamiento estático. BGP y el enrutamiento dinámico no están disponibles. Al igual que con NAT, los servidores necesitan una ruta hacia la red de par a través de la dirección de LAN de la pasarela, por ejemplo
ip route add 192.168.50.0/24 via 10.10.1.5. - No consciente de DHCP. La dirección de LAN de la pasarela es estática, por lo que proviene del rango reservado (Sección 1.3).
- Endpoints de túnel IPv4. El endpoint del túnel y la dirección IP de la pasarela son solo IPv4.
- Límites por nivel.
STANDARDpermite 5 LANs y 10 túneles,ENHANCED10 LANs y 20 túneles,PREMIUM15 LANs y 30 túneles. - Orden de eliminación. Elimine la VPN Gateway antes que el VDC conectado. Terraform sigue el grafo de dependencias, pero una eliminación manual del centro de datos rompe esta regla.
La API de VPN Gateway es regional. Use el endpoint de la ubicación de su VDC, por ejemplo https://vpn.de-txl.ionos.com/ipsecgateways para de/txl.
5. DNS como código con 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
}
Solo se aceptan tokens para la autorización en los recursos ionoscloud_dns_zone y ionoscloud_dns_record, por lo que debe configurar IONOS_TOKEN (Unidad 1.2) en lugar de un nombre de usuario y una contraseña. Solo los propietarios del contrato, los administradores y los usuarios con el privilegio accessAndManageDns pueden crear y gestionar zonas primarias y registros a través de la API.
5.1 Configuración de registros
name es inmutable tanto en la zona como en el registro. El ttl del registro tiene un valor predeterminado de 3600 segundos; Cloud DNS acepta TTL de 60 a 604800 segundos. Un TTL corto, como 300, le permite mover la API a una nueva dirección IP rápidamente. Los tipos admitidos incluyen A, AAAA, CNAME, ALIAS, MX, TXT, SRV y CAA, y se admiten registros comodín.
5.2 Delegación del dominio
Una zona responde a las consultas solo después de que su registrador apunte el dominio a los servidores de nombres de Cloud DNS: ns-ic.ui-dns.com, ns-ic.ui-dns.de, ns-ic.ui-dns.org y ns-ic.ui-dns.biz. Los cambios en los servidores de nombres pueden tardar hasta 48 horas en propagarse. Pruebe la zona directamente primero:
dig +short api.taskboard.example.com @ns-ic.ui-dns.com
Tarjeta rápida de referencia de la API
Endpoints clave de la API detrás de los recursos de esta unidad:
| Método | Endpoint | Descripción |
|---|---|---|
POST |
/datacenters/{datacenterId}/lans |
Creado por ionoscloud_lan |
POST |
/datacenters/{datacenterId}/servers/{serverId}/nics |
Creado por ionoscloud_nic |
POST |
/datacenters/{datacenterId}/natgateways |
Creado por ionoscloud_natgateway |
POST |
/ipsecgateways |
Creado por ionoscloud_vpn_ipsec_gateway (API de VPN, https://vpn.{region}.ionos.com) |
POST |
/zones/{zoneId}/records |
Creado por ionoscloud_dns_record (API de DNS, https://dns.de-fra.ionos.com) |
URL base: https://api.ionos.com/cloudapi/v6 (VPN y DNS utilizan sus propias URLs base, mostradas arriba)
Autenticación: Authorization: Bearer <token>
Laboratorio de código
Objetivo: Construir la red de tres niveles de TaskBoard con Terraform (LAN públicas, de aplicación y de base de datos, NIC y un gateway NAT), y luego verificar la conectividad entre los niveles y el acceso saliente desde el nivel privado.
Requisitos previos:
- El proyecto del nivel de cómputo de la Unidad 2.1 y el conjunto
IONOS_TOKEN - Terraform con el proveedor fijado como en la Unidad 1.2
- Su clave SSH en
TF_VAR_ssh_public_key
Paso 1: Agregar las LAN privadas
Agregue las LAN de aplicación y de base de datos de la Sección 1 y el bloque locals de la Sección 1.2 a main.tf. Luego, ejecute el plan:
terraform plan | tail -n 1
Salida esperada:
Plan: 2 to add, 0 to change, 0 to destroy.
Paso 2: Mover el worker a la LAN de la app y agregar la NIC de la app del servidor de API
Cambie el nic en línea del worker a la versión de la sección 2.2 y agregue ionoscloud_nic.api_app de la sección 2.1. Guarde el cloud-config de la sección 3.2 como cloud-init/worker.yaml y agregue user_data = base64encode(file("${path.module}/cloud-init/worker.yaml")) al bloque volume del worker. Dado que user_data solo se aplica a un volumen nuevo, el worker debe reconstruirse; al ser sin estado, esto es seguro.
terraform plan -replace=ionoscloud_vcpu_server.worker | grep -E "replaced|created"
Salida esperada:
# 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
Paso 3: Agregar el gateway NAT y las reglas
Agregue ionoscloud_ipblock.nat, ionoscloud_natgateway.egress y ambas reglas SNAT de la sección 3.1, y luego aplique:
terraform apply -replace=ionoscloud_vcpu_server.worker -auto-approve | tail -n 1
Salida esperada:
Apply complete! Resources: ... added, ... changed, ... destroyed.
Paso 4: Verificar el gateway NAT a través de la 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}'
Salida esperada:
{
"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"] } ]
}
Paso 5: Alcanzar al worker a través de la LAN de la app
ssh -J root@"$(terraform output -raw api_public_ip)" root@10.10.1.21 'hostname; ip route show default'
Salida esperada:
taskboard-worker-01
default via 10.10.1.4 dev ...
Paso 6: Probar el acceso saliente desde el worker privado
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'
Salida esperada:
HTTP/... <status code>
Cualquier línea de estado HTTP demuestra que el worker privado alcanzó internet a través del gateway NAT; un timeout indica que falta la ruta o la regla SNAT.
Lista de validación:
- [ ] Existen tres LAN: una pública y dos privadas con los bloques CIDR que configuró
- [ ] El worker no tiene IP pública y solo es accesible a través del servidor API
- [ ] La ruta predeterminada del worker apunta a
10.10.1.4 - [ ] El worker alcanza internet a través de la IP pública del gateway NAT
Limpieza:
terraform destroy -auto-approve
Errores comunes
Errores de desarrollo a evitar con el tema de esta unidad:
-
Se creó una pasarela NAT, pero los servidores privados no tienen internet
- Problema:
curldesde un servidor privado expira, aunque la pasarela NAT y las reglas existen. - Por qué ocurre: La pasarela no inyecta una ruta predeterminada. El servidor sigue sin tener una ruta hacia la IP de la pasarela.
- Solución: Establezca
gateway_ipsexplícitamente y agregueip route replace default via <gateway ip>en cloud-init (Sección 3.2). Si la resolución de nombres falla, verifique que las reglas SNAT cubran UDP.
- Problema:
-
La dirección estática de la pasarela entra en conflicto con DHCP
- Problema: La dirección de una pasarela VPN o NAT entra en conflicto con un servidor, y el tráfico va al host equivocado.
- Por qué ocurre: La interfaz de la pasarela VPN no es consciente de DHCP, y usted seleccionó una dirección que DHCP podría asignar.
- Solución: Use direcciones del rango de servicios administrados reservados
.2a.9(Sección 1.3), y asigne a los servidores direcciones desde.10en adelante.
-
Los recursos DNS fallan con autenticación básica
- Problema:
ionoscloud_dns_zoneno logra autenticarse en una canalización que usaIONOS_USERNAMEyIONOS_PASSWORD. - Por qué ocurre: Solo se aceptan tokens para la autorización en los recursos DNS.
- Solución: Genere un token, guárdelo como un secreto de CI y expórtelo como
IONOS_TOKEN.
- Problema:
Resumen
Ahora puede describir la red de TaskBoard como código. Las LAN públicas y privadas separan los niveles mediante bloques RFC 1918 explícitos, los servidores se unen a varias LAN a través de NIC en línea y NIC separadas, y un Managed NAT Gateway proporciona a los servidores privados acceso saliente una vez que sus rutas apunten a él. Un gateway de VPN IPSec conecta la oficina mediante rutas estáticas, y Cloud DNS publica un nombre estable para la API.
Puntos clave:
- Los bloques de LAN privadas deben ser RFC 1918, de /23 a /28 y alineados; los bloques omitidos reciben un /23 desde
10.0.0.0/8 - Asigne a los servicios administrados direcciones de LAN del rango reservado de
.2a.9 - El gateway NAT es solo SNAT, conecta hasta seis LAN privadas y requiere una ruta en cada servidor
- El gateway VPN utiliza solo enrutamiento estático, IKEv2 con PSK para IPSec, y un endpoint regional de la API
- Los recursos de DNS aceptan solo tokens; delegue el dominio en los cuatro servidores de nombres de Cloud DNS
Terminología importante:
- LAN privada: Una LAN con
public = falsecuyas NIC reciben direcciones privadas y no tienen exposición a internet - Regla SNAT: Una regla de gateway NAT que enmascara la dirección de origen de los paquetes salientes con una IP pública
- IP del gateway: La propia dirección del gateway NAT o VPN en una LAN privada, utilizada como destino de la ruta
- Clave precompartida (PSK): El secreto compartido que autentica ambos extremos de un túnel IPSec
- Delegación: Apuntar los servidores de nombres de un dominio a Cloud DNS para que la zona responda a consultas públicas
Próximos pasos
Siga aprendiendo: Unidad 2.3: Equilibrio de carga y seguridad como código
Temas relacionados: