Docker
Docker Engine, Docker Desktop, contextos y comprobaciones iniciales.
Instalar Docker no consiste únicamente en conseguir que funcione. Debes comprender .
docker run hello-worldUn entorno Docker funcional combina:
Docker CLI
+ contexto activo
+ endpoint accesible
+ Docker Engine o Docker Desktop
+ permisos
+ almacenamiento
+ red
+ arquitectura compatibleCuando alguno de estos elementos no coincide con lo esperado, aparecen fallos que suelen atribuirse erróneamente a la aplicación.
Docker Engine incluye el daemon, APIs y runtime necesarios para administrar images, containers, networks y volumes. En un servidor Linux normalmente se ejecuta como un servicio del sistema.
Linux host
→ dockerd
→ containerd
→ containers Linux usando kernel del hostEste modelo ofrece acceso directo al kernel y suele representar mejor un host de producción Linux.
Docker Desktop integra Engine, CLI, Compose, gestión de recursos y otras herramientas. En macOS y Windows necesita una VM Linux para ejecutar containers Linux.
macOS / Windows
→ Docker Desktop
→ Linux VM
→ Docker Engine
→ Linux containersLa VM cambia varias cosas:
Las instrucciones exactas dependen del sistema operativo y cambian con versiones. La fuente principal debe ser la documentación oficial para tu plataforma.
Antes de instalar, decide:
amd64 o arm64?En servidores, evita scripts de instalación no auditados y repositorios no oficiales. Una instalación rápida puede configurar versiones o permisos que no entiendes.
docker --version
docker versiondocker --version muestra el cliente disponible. docker version intenta consultar también al servidor.
Un resultado conceptual:
Client: disponible
Server: error de conexiónsignifica que el binario existe, pero no puede comunicarse con el daemon. Reinstalar la CLI probablemente no corrige el problema.
docker infodocker info muestra, entre otros datos:
No publiques la salida completa sin revisar: puede contener nombres, endpoints o configuración sensible.
docker context ls
docker context show
docker context inspectUn contexto define a qué endpoint se conecta la CLI y cómo se autentica. Puedes tener un contexto local y otro de producción.
default → socket local
production → Engine remoto protegido por SSH/TLSAntes de comandos destructivos, confirma el contexto. docker system prune sobre producción por usar el contexto equivocado no es un error de Docker, sino una falta de control operativo.
docker run --rm hello-worldEsta prueba confirma varias etapas:
No confirma networking avanzado, volumes, builds ni que tu aplicación sea compatible.
FROM alpine:3.22
CMD ["echo", "build-ok"]docker build -t environment-check .
docker run --rm environment-checkEsto añade verificación de BuildKit, build context, cache y almacenamiento local.
En Linux, el daemon suele ejecutarse con privilegios elevados. El socket Unix puede pertenecer a root:docker.
Añadir un usuario al grupo docker elimina la necesidad de sudo, pero le concede una capacidad equivalente a root porque puede pedir al daemon montar el host o crear containers privilegiados.
sudo usermod -aG docker $USEREste comando no debe entenderse como “dar permiso limitado para ejecutar containers”. Debe tratarse como acceso administrativo.
sudo con política controlada;Rootless reduce el impacto potencial del daemon y containers, pero tiene diferencias en networking, cgroups, storage y puertos privilegiados. Debe probarse con el workload real.
Los contextos permiten administrar varios Engines sin cambiar manualmente variables y certificados.
docker context create staging --docker host=ssh://deploy@staging.example.com
docker context use staging
docker psEn este ejemplo, docker ps lista containers del host remoto.
Consecuencia importante: un bind mount como:
docker run -v $PWD:/app imagese interpreta en el host donde corre el daemon. Con un Engine remoto, $PWD de tu shell no se transfiere automáticamente. El daemon intentará montar ese path remoto.
En Desktop, CPU, memoria y disco pertenecen a la VM o entorno virtualizado. Una aplicación puede fallar por límites de Desktop aunque el equipo físico tenga recursos libres.
Un límite bajo puede provocar OOM en containers, builds o servicios auxiliares.
Una asignación pequeña ralentiza compilaciones y pruebas. Aumentarla no corrige una aplicación con loops o paralelismo mal configurado.
Images, layers, build cache y volumes consumen el disco virtual. Liberar espacio en el host no siempre reduce inmediatamente el archivo virtual; usa herramientas soportadas por Desktop.
Bind mounts desde macOS o Windows pueden ser más lentos que volumes internos, especialmente con miles de archivos pequeños como node_modules.
Una estrategia común para Node.js:
services:
app:
volumes:
- .:/app
- node_modules:/app/node_modules
volumes:
node_modules:El código se sincroniza desde el host y las dependencias Linux viven en un volume interno.
Comprueba:
uname -m
docker info --format '{{.Architecture}}'
docker image inspect image --format '{{.Architecture}}'Valores comunes:
x86_64 / amd64;aarch64 / arm64.En un Mac Apple Silicon, una image solo amd64 puede ejecutarse mediante emulación. Esto puede:
Prefiere images multi-platform y fija --platform solo cuando la decisión sea consciente.
docker run --platform linux/amd64 imageEste flag no convierte mágicamente una image en nativa; puede activar emulación.
Docker administra su data root. Allí viven metadata, snapshots, layers, containers y volumes según la configuración.
No debes editar directamente /var/lib/docker ni paths internos de Desktop. Las implementaciones pueden cambiar entre storage drivers o image stores, y Docker Engine 29 introdujo cambios relevantes alrededor del image store de containerd en instalaciones nuevas.
Para inspección usa:
docker system df -v
docker image ls
docker volume ls
docker infoDepender de la estructura interna del directorio hace frágiles backups y scripts.
Valida salida a internet y DNS:
docker run --rm alpine sh -c 'wget -qO- https://example.com >/dev/null && echo ok'
docker run --rm alpine getent hosts example.comSi falla:
Que el host navegue correctamente no garantiza que la VM o daemon tenga la misma ruta o certificados.
En redes empresariales, el daemon puede necesitar proxy para pull y el build puede necesitar otro para descargar dependencias.
Existen tres niveles distintos:
CLI / usuario
Docker daemon
build y proceso dentro del containerConfigurar solo HTTP_PROXY en tu shell puede no resolver un pull del daemon. Agregar una CA al host tampoco garantiza que la base image confíe en ella.
No desactives TLS como solución permanente. Instala la CA en la frontera correcta.
docker pull node:22-slim falla, pero el navegador funciona.
docker context showQuizá controlas un Engine remoto.
docker infoBusca proxy, registries y warnings.
no such host apunta a DNS;x509: certificate signed by unknown authority apunta a confianza TLS;unauthorized apunta a credenciales o permisos;En Linux con systemd:
journalctl -u docker --since '10 minutes ago'No cambies varias variables a la vez. Conserva evidencia del error original.
Común en entornos donde solo se instaló la CLI. docker version muestra Client, pero no Server.
El error menciona el socket. Usar sudo confirma el diagnóstico, pero luego debes decidir el modelo de permisos.
Los comandos funcionan, pero muestran recursos inesperados. Confirma endpoint antes de crear o borrar.
Pulls y builds fallan; containers activos pueden perder capacidad de escribir logs. Revisa espacio e inodes.
Puede causar fallos TLS o tokens inválidos. La sincronización de tiempo también forma parte del entorno.
Docker Desktop puede no iniciar la VM. Revisa soporte de virtualización y políticas del sistema.
Puede entregar versiones antiguas, forks o configuración distinta. Usa la fuente oficial o una política corporativa controlada.
Concede privilegios elevados. Debe auditarse como acceso administrativo.
Archivos creados mediante bind mounts pueden quedar propiedad de root en el host.
Oculta problemas y hace builds lentos. Busca soporte multi-platform o builders nativos.
Puede ocultar memory leaks o builds mal diseñados. Mide antes de ajustar.
Primero distingue CLI, daemon, contexto y permisos.
docker version
docker info
docker context ls
docker context inspect
docker run --rm hello-world
docker system df
docker network ls
docker volume lsRegistra además:
docker concede acceso administrativo, no un permiso inocuo.docker --version funciona, pero docker version no muestra Server. Diseña un diagnóstico paso a paso.docker?amd64 funciona lentamente en un Mac ARM. ¿Qué comprobarías antes de forzar otra configuración?Modelo mental de la CLI, para operar recursos de manera predecible y diagnosticar sin depender de comandos memorizados.