Rancher

Plataforma de gestión multi-cluster de Kubernetes. Permite administrar, monitorear y operar múltiples clusters de Kubernetes y k3s desde una sola interfaz web.

Versión:

2.13.2

Volver a Marketplace

Requisitos de VM

Recurso Mínimo
CPU 2 vCPU
RAM 4 GB
Disco 40 GB
Sistema Operativo Ubuntu 22.04 / 24.04

Puerto de acceso

Puerto Protocolo Uso
443 HTTPS Interfaz web de Rancher

Cómo acceder

Con SSL habilitado (recomendado)

https://<IP-CON-GUIONES>.sslip.io/

Ejemplo: si tu VM tiene la IP 200.25.101.125:

https://200-25-101-125.sslip.io/

Sin SSL

http://<IP_DE_LA_VM>/

Credenciales de acceso

Al abrir la URL por primera vez, Rancher solicita el Bootstrap Password para configurar la cuenta de administrador.

Campo Valor
Bootstrap Password El valor de RANCHER_BOOTSTRAP_PASSWORD o búscalo en los outputs del deployment

Después de ingresar el bootstrap password, Rancher te pedirá definir una contraseña permanente para el usuario admin.

Validar que Rancher Está Activo

# Ver el pod de Rancher
kubectl get pods -A | grep rancher

# Ver log de instalación
tail -f /var/log/cuemby/bootstrap.log

# Verificar el endpoint de health
curl -k https://<IP_DE_LA_VM>/healthz

Respuesta esperada

ok

Respuesta esperada del pod

NAME                       READY   STATUS    RESTARTS
rancher-xxxxxxxxx-xxxxx    1/1     Running   0        ← Running ✓

ℹ️ Aunque el pod esté en Running, Rancher puede tardar varios minutos adicionales en inicializar todos sus controladores internos. Espera hasta que /healthz responda ok antes de acceder a la UI.

Parámetros de configuración

Parámetro Default Descripción
RANCHER_BOOTSTRAP_PASSWORD ⚠️ auto-generado Contraseña de arranque para el primer acceso. Búscala en los outputs del deployment si no la configuraste.
RANCHER_DATA_SIZE 10Gi Tamaño del volumen persistente para configuración y estado de Rancher.
RANCHER_SSL_ENABLED true Habilita HTTPS con certificado automático vía sslip.io.
RANCHER_HOSTNAME auto (sslip.io) Hostname personalizado. Si se deja vacío, se usa la URL generada por Cuemby.

⚠️ Fija RANCHER_HOSTNAME antes de desplegar si planeas usar un dominio propio. Cambiarlo después requiere reconfiguración manual del certificado y puede romper los clusters ya registrados.

Primeros pasos (inicio rápido)

  1. Abre la URL, ingresa el Bootstrap Password y define tu contraseña permanente de admin.
  2. Rancher detecta automáticamente el cluster local de k3s. Haz clic en local para administrarlo.
  3. Explora namespaces, workloads, servicios y volúmenes desde el menú Cluster Management.
  4. Conecta clusters adicionales desde Cluster Management → Create o Import Existing.

💡 Tip: Rancher gestiona el cluster de k3s donde está instalado como cluster local de forma automática. Es el punto de partida para explorar todos los recursos de Cuemby Marketplace desplegados en la misma VM, con una vista más completa que Portainer para operaciones multi-cluster.

Solución rápida de problemas

Problema Causa probable Solución
UI no carga Rancher aún inicializando Espera 8–15 min. Verifica con curl -k https:///healthz.
Bootstrap Password no funciona Password incorrecto Revisa los outputs del deployment en el portal de Cuemby.
Cluster local en estado Unavailable Rancher aún registrando el cluster Espera unos minutos y recarga la página. Es parte del arranque normal.
Certificado SSL inválido Hostname mal configurado Verifica que RANCHER_HOSTNAME coincide exactamente con la URL que estás usando.
Pod en CrashLoopBackOff Recursos insuficientes Verifica con kubectl describe pod -n .

Cuemby Cloud

IaaS

Acerca de Cuemby Cloud

Cuemby Cloud es una infraestructura de nube de nivel empresarial gestionada desde una única consola, diseñada para ofrecer una seguridad más sólida, operaciones predecibles y una fácil escalabilidad en todas las regiones.

Regiones de centros de datos disponibles en Colombia, Ecuador y Chile

Respaldado por ubicaciones de centros de datos de nivel III y nivel IV

Tarifas de entrada y salida de red cero

Soporte de expertos locales 24/7

¿listo para modernizar tu empresa?

Los desafíos del futuro exigen soluciones preparadas para el futuro. ¡Empecemos!

© Derechos de autor | Cuemby® 2025