Portainer

Interfaz web para gestionar entornos de contenedores. Permite administrar clusters de Kubernetes y k3s visualmente sin necesidad de usar kubectl directamente.

Versión:

2.33.7

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 Portainer

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>/

Primera vez

Al abrir la URL por primera vez, Portainer te pedirá crear la cuenta de administrador. Tienes 5 minutos para completar este paso antes de que el setup expire y requiera reiniciar el pod.

⚠️ Si la pantalla de creación de cuenta no aparece o ya expiró, reinicia el pod con:

kubectl rollout restart deployment portainer -n <NAMESPACE>

Validar que Portainer Está Activo

# Ver el pod de Portainer
kubectl get pods -A | grep portainer

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

Respuesta esperada

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

Parámetros de configuración

Parámetro Default Descripción
PORTAINER_DATA_SIZE 10Gi Tamaño del volumen persistente para configuración y datos de Portainer.
PORTAINER_SSL_ENABLED true Habilita HTTPS con certificado automático vía sslip.io.
PORTAINER_HOSTNAME auto (sslip.io) Hostname personalizado. Si se deja vacío, se usa la URL generada por Cuemby.

ℹ️ Portainer no requiere credenciales configuradas al desplegar. La cuenta de administrador se crea en el primer acceso.

Primeros pasos (inicio rápido)

  1. Abre la URL y crea tu cuenta de administrador.
  2. Selecciona el entorno local para gestionar el cluster de k3s donde está instalado Portainer.
  3. Desde el dashboard puedes ver y gestionar namespaces, pods, deployments, services, configmaps y volúmenes.
  4. Conecta entornos adicionales (otros clusters de k3s o Kubernetes) desde Environments → Add environment.

💡 Tip: Portainer se conecta directamente al cluster de k3s local sin configuración adicional. Es el punto de partida ideal para explorar los recursos del marketplace de Cuemby desplegados en la VM.

Solución rápida de problemas

Problema Causa probable Solución
Pantalla de setup no aparece Pod aún iniciando Espera ~2 min y recarga la página.
Setup expiró (timeout 5 min) No se completó el registro a tiempo Reinicia el pod con kubectl rollout restart deployment portainer -n .
Invalid username or password Credenciales incorrectas Portainer no tiene recuperación de contraseña por defecto; reinicia el pod para resetear.
Entorno local no conecta Permisos de k3s insuficientes Verifica que el ServiceAccount de Portainer tiene acceso al cluster.
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