---
title: "Desplegar un Clúster de Kubernetes"
description: "Despliega un clúster Kubernetes gestionado: control plane gestionado, node pools sobre VPS, acceso con kubeconfig, CIDRs de red, límites y cómo exponer tus apps."
category: "Despliegue"
language: es
source: https://cubepath.com/es/docs/products/despliegue/desplegar-un-cluster-de-kubernetes
updated: 2026-10-28
---

# Desplegar un Clúster de Kubernetes

Crea un Clúster de Kubernetes Gestionado desde la página **Deploy Kubernetes** en [my.cubepath.com](https://my.cubepath.com). CubePath ejecuta el **control plane** por ti mientras tus **nodos worker** corren sobre VPS de CubePath que tú dimensionas y escalas — solo descargas un kubeconfig y usas `kubectl` como en cualquier otro clúster.

> Nota: Tu cuenta debe estar [verificada](/docs/products/introduccion/configurar-tu-cuenta) antes de poder desplegar.

## Qué significa "gestionado" aquí

CubePath ejecuta el API server, el scheduler, el controller manager y etcd, los mantiene parcheados y sanos, y te entrega un endpoint. Tú te ocupas de todo lo que hay por encima de esa línea: tus cargas de trabajo, tus node pools, tus add-ons.

Cada worker es un [VPS](/docs/products/despliegue/desplegar-una-maquina-virtual) real de tu cuenta, facturado como cualquier otro VPS. Ese es el modelo de coste: pagas los workers que ejecutas, más el control plane en HA si lo activas.

## Desplegar

```steps
### Nombra el clúster
Elige el **proyecto** y un **nombre de clúster** (minúsculas, números y guiones).

### Elige versión y control plane
Selecciona la **versión de Kubernetes** (la predeterminada viene preseleccionada) y opcionalmente activa un **control plane de alta disponibilidad** — 2 réplicas de control plane, +20,00 $/mes. Merece la pena en producción; déjalo desactivado en desarrollo y pruebas.

### Elige región y tipo de instancia
Escoge una **ubicación** en **Miami (MIA)**, **Houston (HOU)** o **Barcelona (BCN)**, y luego un tipo de instancia para los nodos worker.

### Configura los node pools
Define el **nombre**, el **plan** y el **número de nodos** (1–100) de cada pool. **Auto Scale** está activado por defecto; añade más pools con **Add Pool**.

![Node pool con nombre, plan, número de nodos y auto escalado](https://cdn.cubepath.com/img/docs/products/76b2022d-c05f-46a6-b2c7-4333d4b748ea.png)

### Despliega
Opcionalmente ajusta los **Advanced Settings** (IPv4/IPv6, CIDRs de pods y servicios, red privada) y pulsa **Deploy Cluster**.
```

El clúster se aprovisiona en segundo plano; su estado pasa de **Provisioning** a **Active**.

> Importante: Desactivar la IPv6 pública exige conectar antes una red privada, para que los nodos worker sigan siendo accesibles.

## Acceso

A los clústeres se accede con `kubectl`, no con SSH. Cuando el clúster esté **activo**, ábrelo, pulsa **Cluster Management** y luego **Download Kubeconfig** para obtener el fichero `<clúster>-kubeconfig.yaml`. Apunta `kubectl` a él:

```bash
export KUBECONFIG=./<clúster>-kubeconfig.yaml
kubectl get nodes
```

A partir de ahí es un clúster estándar: aplica manifiestos, instala charts de Helm, ejecuta lo que quieras.

> Aviso: El kubeconfig otorga acceso administrativo completo al clúster. Trátalo como una clave privada: no lo subas al repositorio ni lo pegues en un canal compartido.

## Expón tus apps

Un clúster recién creado **no tiene punto de entrada público**. Para llevar tráfico de internet a tus servicios:

```steps
### Instala un ingress controller
Elige uno en la pestaña [Addons](/docs/products/despliegue/k8s-addons-es).

### Pon un balanceador delante
Despliega uno desde la pestaña [Load Balancers](/docs/products/despliegue/k8s-load-balancers-es), apuntando a los nodos worker.

### Apunta el DNS
Crea un registro en [Registros DNS](/docs/products/despliegue/dns-records-es) hacia la IP del balanceador.
```

Para clústeres solo internos, conecta una [red privada](/docs/products/despliegue/redes-privadas) al desplegar y prescinde de las IPs públicas de los workers.

## Protección y eliminación

**Enable Protection** bloquea el borrado accidental del clúster. Eliminar es permanente: retira el clúster, todos sus node pools y destruye todas las instancias VPS worker. Desactiva antes la protección si está activa.

## Límites y restricciones

| Concepto | Límite |
|----------|--------|
| Node pools por clúster | 1–10 |
| Nodos por pool | 1–100 |
| Labels por pool | 50 |
| Taints por pool | 50 |

- Los **CIDRs de pods y servicios** son por defecto `10.42.0.0/16` y `10.43.0.0/16`. Los rangos personalizados no deben solaparse entre sí, ni con la red de nodos, ni con tu red privada.
- **No hay SSH al control plane.** Interactúas con el clúster únicamente a través de la API de Kubernetes.
- **Una ubicación por clúster.** Los workers y la red privada viven en una sola región.

## Las pestañas del clúster

[Node Pools](/docs/products/despliegue/k8s-node-pools-es), [Red](/docs/products/despliegue/k8s-network-es), [Addons](/docs/products/despliegue/k8s-addons-es), [Load Balancers](/docs/products/despliegue/k8s-load-balancers-es), [Métricas](/docs/products/despliegue/k8s-metrics-es) y [Actividad](/docs/products/despliegue/k8s-activity-es).

> Nota: Todo esto está disponible también por la API de CubePath (`Authorization: Bearer <token>`, scopes `kubernetes:read` / `kubernetes:write`; las escrituras requieren además `X-Requested-With: XMLHttpRequest`). Consulta [api.cubepath.com](https://api.cubepath.com).