15 min de lectura

Objetivos de aprendizaje

Al final de este módulo, podrás:

  • Crear una red de tres niveles con LAN públicas y privadas mediante `ionoscloud_lan`, utilizando bloques CIDR privados explícitos
  • Adjuntar servidores a varias LAN mediante bloques `nic` en línea y el recurso `ionoscloud_nic`
  • Otorgar a las LAN privadas acceso saliente a internet mediante `ionoscloud_natgateway` y reglas SNAT, y enrutar el tráfico de los servidores hacia ella
  • Conectar una red en las instalaciones mediante `ionoscloud_vpn_ipsec_gateway` y `ionoscloud_vpn_ipsec_tunnel`
  • Gestionar zonas y registros de DNS como código mediante `ionoscloud_dns_zone` y `ionoscloud_dns_record`

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/12 o 192.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, no 10.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. STANDARD permite 5 LANs y 10 túneles, ENHANCED 10 LANs y 20 túneles, PREMIUM 15 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:

  1. Se creó una pasarela NAT, pero los servidores privados no tienen internet

    • Problema: curl desde 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_ips explícitamente y agregue ip 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.
  2. 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 .2 a .9 (Sección 1.3), y asigne a los servidores direcciones desde .10 en adelante.
  3. Los recursos DNS fallan con autenticación básica

    • Problema: ionoscloud_dns_zone no logra autenticarse en una canalización que usa IONOS_USERNAME y IONOS_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.

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 .2 a .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 = false cuyas 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: