Todas las guías
  1. Inicio
  2. Guías técnicas
  3. Cloud

CloudNivel intermedio

Migrar un servicio a IONOS Cloud: Kubernetes, PostgreSQL y Object Storage

7 min de lectura

Todas las guías

Migrar un servicio a IONOS Cloud: Kubernetes, PostgreSQL y Object Storage

Una guía práctica para migrar un servicio a IONOS Cloud, el proveedor europeo: una API en contenedores con su base de datos PostgreSQL y sus archivos, desde el inventario hasta el cambio de DNS. Todos los comandos están comprobados en la documentación oficial de IONOS y los tienes también en el README.md de la izquierda.

¿Qué vas a aprender?

  • Cómo trasladar las piezas de un servicio (aplicación, base de datos y archivos) a sus equivalentes en IONOS Cloud.
  • Preparar ionosctl en Windows, revisar las cuotas del contrato y crear el centro de datos virtual.
  • Crear un clúster de Managed Kubernetes conectado a una base de datos PostgreSQL gestionada en red privada.
  • Migrar la base de datos con pg_dump / pg_restore y los archivos a Object Storage.
  • Desplegar, validar y hacer el cambio de DNS con el menor corte posible.

Requisitos previos

  • Un contrato de IONOS Cloud con acceso al Data Center Designer (DCD).
  • Windows con PowerShell, Scoop (para instalar ionosctl), kubectl, Docker Desktop y la AWS CLI (se usa contra el Object Storage de IONOS).
  • El servicio a migrar empaquetado en una imagen de contenedor (ver la guía de FastAPI o la de Spring Boot) y acceso a su base de datos de origen.
  • Conocer lo básico de Kubernetes (ver la guía de administración de Kubernetes).

Paso a paso

1. Planifica la migración

Haz inventario de lo que se migra y decide dónde va cada pieza:

Lo que tienes hoyDónde va en IONOS Cloud
Servidores o contenedores de la aplicaciónManaged Kubernetes (o servidores Dedicated Core / vCPU en un VDC)
Imágenes de contenedorPrivate Container Registry
Base de datos PostgreSQLDBaaS PostgreSQL (versiones 14 a 18), en una LAN privada
Archivos y documentosObject Storage, compatible con S3
Balanceador y certificadosApplication o Network Load Balancer y Certificate Manager
DNSCloud DNS (o tu proveedor actual)

Elige una ubicación y no la cambies: el centro de datos virtual (VDC) no se puede mover después. Para datos en España o la UE, por ejemplo de/fra (Fráncfort) o es/vit (Vitoria). Baja con antelación el TTL de los registros DNS que vas a cambiar, para que el cambio final se propague rápido.

2. Instala ionosctl y autentícate

# Instalar ionosctl en Windows con Scoop
scoop bucket add ionos-cloud https://github.com/ionos-cloud/scoop-bucket.git
scoop install ionos-cloud/ionosctl

# Iniciar sesión y crear un token para la migración (válido como máximo un año)
ionosctl login
ionosctl token generate

Para scripts y pipelines, usa el token en la variable de entorno IONOS_TOKEN en lugar de usuario y contraseña.

3. Revisa ubicaciones y cuotas

Cada contrato tiene límites de cores, RAM, almacenamiento, IPs y clústeres. Compruébalos antes de empezar; si no llegan, pide a soporte de IONOS que los amplíe:

ionosctl compute location list    # ubicaciones disponibles (de/fra, de/txl, es/vit…)
ionosctl compute contract get     # límites del contrato: cores, RAM, almacenamiento, IPs, clústeres…

4. Crea el centro de datos virtual y la red privada

ionosctl compute datacenter create --name "vdc-produccion" --location de/fra

Después, en el DCD, añade al VDC una LAN privada para la base de datos (en los ejemplos, la LAN 3). La base de datos gestionada solo es accesible desde redes privadas.

5. Crea el clúster de Kubernetes

El node pool se conecta a la LAN privada para que los pods lleguen a la base de datos:

# Clúster (indica siempre la ubicación: por defecto no es europea)
ionosctl compute k8s cluster create --name k8s-produccion --location de/fra --wait

# Node pool en el VDC, conectado también a la LAN privada de la base de datos (LAN 3 en el ejemplo)
ionosctl compute k8s nodepool create --cluster-id CLUSTER_ID --datacenter-id DATACENTER_ID `
  --name pool-a --lan-ids 3 --dhcp=true --wait

# Credenciales para kubectl
ionosctl compute k8s kubeconfig get --cluster-id CLUSTER_ID > kubeconfig.yaml
$env:KUBECONFIG = "$PWD\kubeconfig.yaml"
kubectl get nodes

6. Sube la imagen al registro de contenedores

ionosctl container-registry registry create --name empresa-registro --location de/txl
ionosctl container-registry token create --registry-id REGISTRY_ID --name despliegue
# Al token hay que darle permisos (scopes) antes de usarlo; su contraseña se muestra una sola vez

El nombre del servidor del registro aparece en el DCD (Containers → Container Registry). Etiqueta y sube la imagen:

docker login <servidor-del-registro> -u despliegue
docker tag api-tareas:1.4.0 <servidor-del-registro>/api-tareas:1.4.0
docker push <servidor-del-registro>/api-tareas:1.4.0

7. Crea la base de datos gestionada

PostgreSQL como servicio, en la LAN privada y con una IP de esa red. Elige la misma versión mayor que en origen (o superior):

ionosctl dbaas postgres-v2 cluster create `
  --datacenter-id DATACENTER_ID --lan-id 3 --cidr 192.168.1.10/24 `
  --db-username admin_app --db-password "********" `
  --database pedidos --version 17

Las conexiones van siempre cifradas con TLS. Los usuarios y roles de la base de datos de origen hay que crearlos a mano en la nueva: el servicio gestionado no da acceso de superusuario.

8. Migra los datos de PostgreSQL

Para la migración final, para las escrituras de la aplicación en origen para no perder datos. Haz el volcado:

# En el servidor de origen: volcado en formato personalizado (-F c)
pg_dump -U app -h origen.empresa.local -p 5432 -F c pedidos -f pedidos.dump

Y restáuralo desde un pod temporal dentro del clúster, que sí llega a la red privada de la base de datos:

# Un pod temporal con el cliente de PostgreSQL dentro del clúster (que llega a la LAN privada)
kubectl run pg-cliente --image=postgres:17 --restart=Never -- sleep 3600
kubectl cp pedidos.dump pg-cliente:/tmp/pedidos.dump

# Restaurar en la base de datos de IONOS (con 4 procesos en paralelo)
kubectl exec -it pg-cliente -- pg_restore -U admin_app -h 192.168.1.10 -p 5432 -F c -d pedidos -j 4 /tmp/pedidos.dump

# Comprobar y borrar el pod temporal
kubectl exec -it pg-cliente -- psql -U admin_app -h 192.168.1.10 -d pedidos -c "SELECT count(*) FROM pedido;"
kubectl delete pod pg-cliente

Compara el número de filas de las tablas principales en origen y destino antes de seguir.

9. Migra los archivos a Object Storage

El Object Storage de IONOS es compatible con S3, así que sirve la AWS CLI indicando el endpoint de IONOS en cada comando. En el ejemplo, la región de (Fráncfort):

# Claves de DCD > Storage & Backup > Object Storage > Key management; región: de
aws configure

aws s3 mb s3://empresa-documentos --endpoint-url https://s3.eu-central-1.ionoscloud.com
aws s3 sync .\documentos s3://empresa-documentos --endpoint-url https://s3.eu-central-1.ionoscloud.com
aws s3 ls s3://empresa-documentos --endpoint-url https://s3.eu-central-1.ionoscloud.com

10. Despliega el servicio y valídalo

Guarda la conexión a la base de datos en un secreto, despliega y prueba internamente antes de abrirlo al público:

kubectl create secret generic bd-pedidos --from-literal=DB_URL="postgresql://192.168.1.10:5432/pedidos?sslmode=require" `
  --from-literal=DB_USER=admin_app --from-literal=DB_PASSWORD="********"
kubectl apply -f deployment.yaml
kubectl rollout status deployment/api-tareas
kubectl port-forward deploy/api-tareas 8080:80   # probar en http://localhost:8080 antes de abrirlo al público

11. Cambia el DNS y retira lo antiguo

  • Expón el servicio (Ingress con su balanceador, o un Application Load Balancer) y su certificado.
  • Cambia los registros DNS a la nueva IP. Con el TTL bajo, el cambio llega en minutos.
  • Vigila logs y métricas durante unos días y mantén el entorno antiguo apagado pero disponible, por si hay que volver atrás.
  • Cuando todo esté estable, retira el entorno antiguo y vuelve a subir el TTL.

12. Opcional: describe la infraestructura con Terraform

Para que la infraestructura sea reproducible, el proveedor oficial de Terraform crea lo mismo desde código (token en la variable IONOS_TOKEN o en var.ionos_token):

terraform {
  required_providers {
    ionoscloud = { source = "ionos-cloud/ionoscloud", version = ">= 6.4.10" }
  }
}

provider "ionoscloud" {
  token = var.ionos_token
}

resource "ionoscloud_datacenter" "produccion" {
  name     = "vdc-produccion"
  location = "de/fra"
}

resource "ionoscloud_k8s_cluster" "produccion" {
  name        = "k8s-produccion"
  k8s_version = "1.31.2"
  maintenance_window {
    day_of_the_week = "Sunday"
    time            = "09:00:00Z"
  }
}

resource "ionoscloud_k8s_node_pool" "general" {
  datacenter_id     = ionoscloud_datacenter.produccion.id
  k8s_cluster_id    = ionoscloud_k8s_cluster.produccion.id
  name              = "pool-a"
  k8s_version       = ionoscloud_k8s_cluster.produccion.k8s_version
  availability_zone = "AUTO"
  storage_type      = "SSD"
  node_count        = 2
  cores_count       = 2
  ram_size          = 4096
  storage_size      = 40
  server_type       = "DedicatedCore"
  cpu_family        = "INTEL_XEON"
}

Errores habituales

Recursos creados fuera de Europa

Algunos comandos tienen una ubicación por defecto que no es la que esperas (por ejemplo, la creación del clúster). Indica siempre --location y revisa la ubicación de cada recurso.

La aplicación no llega a la base de datos

La base de datos gestionada solo está en la LAN privada. El node pool debe estar conectado a esa misma LAN (--lan-ids) con DHCP, y la cadena de conexión debe usar su IP privada.

El rango de red de la base de datos no se acepta

Hay rangos reservados por IONOS que no se pueden usar para la base de datos: 10.208.0.0/12, 10.233.0.0/18, 10.233.64.0/18 y 192.168.230.0/24.

«pg_dumpall» o la restauración de roles falla

En una base de datos gestionada no hay superusuario. Vuelca solo la base de datos con pg_dump y crea a mano los usuarios y roles en destino.

Se acaba la cuota del contrato a mitad de la migración

Revisa los límites con ionosctl compute contract get antes de empezar y pide la ampliación con tiempo: no es inmediata.

La AWS CLI se conecta a Amazon en lugar de a IONOS

Falta --endpoint-url en el comando. Con el Object Storage de IONOS hay que indicarlo siempre, y debe corresponder a la región del bucket.

Un Service de tipo LoadBalancer no obtiene IP

Los node pools privados (detrás de un NAT Gateway) no admiten Services de tipo LoadBalancer. Usa un node pool público para la entrada o un Application Load Balancer.

Siguientes pasos

  • Automatizar el despliegue en el nuevo clúster con un pipeline (ver la guía de CI/CD con GitHub Actions).
  • Activar las copias de seguridad y comprobar una restauración real de la base de datos.
  • Llevar los registros DNS a Cloud DNS y automatizarlos desde Kubernetes con ExternalDNS.
  • Definir alertas sobre el consumo frente a las cuotas del contrato.

Compartir

Más guías sobre

Ver todas las guías

Otras guías técnicas

Ver todas las guías

APIsIntermedio

Estructura básica de una API en IBM API Connect 10

Cómo se estructura una API en IBM API Connect 10: contrato OpenAPI con x-ibm-configuration, Client ID y Client Secret, producto con planes y límites, y validación y publicación con el CLI apic.

Leer la guía 7 min de lectura

IntegraciónIntermedio

Comandos básicos de administración de TIBCO ActiveSpaces 5.2

Los comandos del día a día en TIBCO ActiveSpaces 5.2: servicio de realm sobre servidores FTL, tibdg, definición del grid, tablas, arranque de procesos, estado, escalado con copysets, checkpoints y logs.

Leer la guía 8 min de lectura

DevOpsBásico

Estructura básica de un CI/CD con GitHub Actions

Un pipeline completo con GitHub Actions: pruebas en cada push y pull request, imagen Docker en GitHub Container Registry y despliegue a un entorno protegido, con un workflow listo para copiar.

Leer la guía 6 min de lectura

DesarrolloBásico

Buenas prácticas de desarrollo en Java con Spring Boot

Las prácticas que más se notan en un servicio Spring Boot: estructura, inyección por constructor, DTOs, validación, errores, configuración, transacciones, logs, comentarios, pruebas y calidad automatizada.

Leer la guía 8 min de lectura

Contacto

Construye hoy tu próxima ventaja competitiva

Hablemos sobre cómo podemos ayudarte. Te respondemos con una propuesta técnica clara, sin compromiso.

Solicita información

Los campos marcados con son obligatorios.