Tutorial Portainer — Índice
Tutorial Portainer — De cero a hero
Portainer es una interfaz visual de gestión de contenedores que se monta sobre Docker, Docker Swarm y Kubernetes. En vez de memorizar banderas de docker run o escribir manifiestos de Kubernetes a mano, operás tus entornos desde una UI web (o una API REST) con control de acceso, plantillas, despliegue desde Git y observabilidad.
Portainer en una frase: la capa de administración que convierte uno o varios hosts de contenedores dispersos en una flota gobernable desde un solo panel.
Portainer tiene dos ediciones: Community Edition (CE), open source y gratuita, y Business Edition (BE), con RBAC granular, autenticación empresarial y soporte. Este tutorial cubre Portainer CE 2.39 LTS (la línea estable de 2026) y marca claramente qué funciones son exclusivas de BE cuando aparecen.
Estructura del tutorial
flowchart LR
A["Fundamentos<br/>01-03"] --> B["Operación diaria<br/>04-08"]
B --> C["Orquestadores<br/>09-11"]
C --> D["Gobierno y<br/>automatización<br/>12-14"]| # | Capítulo | Foco |
|---|---|---|
| 1 | Introducción y arquitectura | Qué es, CE vs BE, modelo server/agent, casos de uso |
| 2 | Instalación | Docker standalone en Linux, volumen, puertos, primer admin |
| 3 | Interfaz y entornos | Tour de la UI, environments, dashboard, navegación |
| 4 | Contenedores | Crear, logs, consola, stats, inspect, recreate |
| 5 | Imágenes, volúmenes y redes | Pull/build, gestión de volúmenes y redes |
| 6 | Stacks y Compose | Deploy de stacks, editor web, variables, despliegue desde Git |
| 7 | App Templates | Plantillas integradas y plantillas personalizadas |
| 8 | Registries | Docker Hub, registries privados, credenciales |
| 9 | Docker Swarm | Cluster, services, scaling, secrets y configs |
| 10 | Kubernetes | Agente/Helm, despliegue de apps, namespaces, recursos |
| 11 | Edge: agentes y stacks | Edge Agents, Edge Stacks, Edge Groups, gestión remota |
| 12 | Usuarios, equipos y RBAC | Roles, access control, OAuth/LDAP (BE) |
| 13 | GitOps y webhooks | Auto-update, polling, webhooks, despliegue continuo |
| 14 | Operación y seguridad | Backups, upgrade, alerting, Fleet Governance, hardening |
¿Para quién es este tutorial?
- Desarrolladores que usan Docker en su día a día y quieren una UI para no vivir en la terminal.
- Equipos de DevOps/SRE que gestionan varios hosts y necesitan un panel central con control de acceso.
- Homelabbers que corren servicios en un servidor casero y quieren administrarlos con comodidad.
No requiere experiencia previa con Portainer, pero ayuda saber qué es un contenedor y haber corrido docker run al menos una vez.
¿Qué vas a poder hacer al terminar?
- Instalar y asegurar Portainer CE sobre un host Docker.
- Crear, inspeccionar y depurar contenedores, imágenes, volúmenes y redes desde la UI.
- Desplegar aplicaciones como stacks de Compose, desde el editor o desde un repositorio Git.
- Conectar registries privados y publicar tus propias imágenes.
- Administrar clusters de Docker Swarm y Kubernetes desde el mismo panel.
- Gestionar hosts remotos con Edge Agents sin abrir puertos entrantes.
- Definir usuarios, equipos y permisos, y conectar autenticación empresarial.
- Automatizar despliegues con GitOps y webhooks, y operar backups, upgrades y alertas.
Siguiente → Capítulo 1: Introducción y arquitectura