Imagen Docker
Despliega cualquier imagen pre-built desde un registry — sin build step.
El despliegue más simple posible — elige una imagen Docker por nombre, configura el puerto y cualquier env vars, y envía. Pier tira la imagen, corre el contenedor, lo adjunta a Traefik para HTTPS, y te da controles logs / restart / env. Sin build, sin Dockerfile, sin Compose.
Desplegar con Pier
- 1 Abre el panel de Pier y haz clic en Add service.
- 2 Elige Docker Image en la lista de plantillas.
- 3 Elige la versión, asigna un nombre al servicio y Pier provisionará automáticamente el contenedor, el almacenamiento y los puertos.
- 4 Vincula un dominio si quieres HTTPS. Traefik genera el certificado de Let's Encrypt automáticamente.
¿Qué es Docker Image en Pier?
La plantilla de despliegue más reducida — pega una referencia de imagen
Docker, configura puertos / env vars / volúmenes / dominio, y Pier la corre.
Sin Dockerfile, sin Compose YAML, sin build step. Útil cada vez que alguien
dice “docker pull esta imagen y córrela” y te gustaría que el resultado sea
un servicio Pier gestionado en vez de un docker run hand-rolled en el host.
Pier cablea el contenedor a su red Traefik-fronted para HTTPS, gestiona los volúmenes que declaras, expone overrides env-var y de command, y te da los mismos controles logs / restart / redeploy que obtienes con plantillas nativas.
Cómo lo despliega Pier
Le das a Pier el nombre de imagen (e.g. nginx:latest o
ghcr.io/your-org/your-app:v1.2.3), el puerto interno en que la imagen
escucha, volúmenes opcionales y env vars, y un dominio.
Pier pullea la imagen, inicia el contenedor con los volúmenes y env configurados, adjunta routes Traefik para terminación HTTPS en el dominio elegido, y persiste el contenedor entre reinicios del host.
Para registries privados, agrega credenciales en Pier Settings → Registries antes de desplegar — Pier las usa al pullear.
Updates — click Redeploy para forzar un pull fresco del tag configurado. Para upgrade a nueva versión, edita la referencia de imagen y redeploy.
Cuándo NO usar Docker Image
Cuando tienes source code pero no imagen prebuilt, usa la plantilla Dockerfile o Railpack — construyen por ti. Cuando el servicio es multi-contenedor, usa Docker Compose. Cuando existe plantilla Pier nativa para el servicio (PostgreSQL, Gitea, Grafana, …), la plantilla dedicada viene con backups gestionados, selectores de versión y features de ciclo de vida que la genérica no tiene.
Características clave
Cualquier imagen desde cualquier registry
Docker Hub, GitHub Container Registry (ghcr.io), Quay, GitLab Registry, AWS ECR, Google Artifact Registry — cualquier cosa pulleable funciona.
Un campo — el nombre de la imagen
nginx:latest, postgres:17-alpine, ghcr.io/your-org/your-app:v1.2.3 — pega la referencia de imagen, eso es todo.
Env vars, puertos, volúmenes
UI Pier para agregar env vars, mapear puertos, adjuntar volúmenes persistentes. Mismos controles que plantillas nativas.
Auth de registry privado
Agrega credenciales de registry en Pier; pulls subsecuentes autentican. Credenciales por-registry soportadas.
HTTPS vía Traefik
Adjunta un dominio custom y Traefik maneja terminación TLS. Sin reverse proxy que configurar.
Logs + restart + redeploy
Tail logs, restart, fuerza un pull-and-deploy fresco del mismo tag (o pin un digest) desde la UI.
Casos de uso
Servicios off-the-shelf
nginx, postgres, redis, cualquier imagen mantenida por la comunidad — despliega sin escribir config.
Tus propias imágenes pre-built
CI construye una imagen y push a ghcr.io / tu registry. Pier la pullea y corre.
Probando proyectos comunitarios
Un proyecto GitHub dice "docker pull foo/bar". Pegas foo/bar:latest en Pier y lo tienes corriendo.
Sidecars ligeros
Una sola imagen pequeña — backup runner, log shipper, metric exporter, túnel — desplegado junto a otros servicios.
Prototipado rápido
Levanta una imagen, prueba, destruye. El dropdown de nombre de imagen es el path más rápido a un contenedor corriendo.
Ejemplos de código
Image - nginx:latest
Internal port - 80
Domain - site.example.com (adjuntar en Pier)
→ Pier tira, corre, fronts con HTTPSImage - ghcr.io/your-org/my-api:v2.3.0
Internal port - 8080
Env vars -
DATABASE_URL = postgres://...
API_KEY = sk-...
Volume - /app/uploads → pier-managedPier Settings → Registries → Add
Registry - ghcr.io
Username - your-org-bot
Password - <PAT con scope read:packages>
Pulls subsecuentes autentican automáticamenteImage - nginx@sha256:abcdef0123...
→ Pier tira este digest exacto para siempre — sin sorpresas "latest"Comparativa
| vs Dockerfile (este catálogo) | Dockerfile construye una imagen desde tu source. Docker Image corre una imagen pre-built que ya tienes. Usa Image cuando CI construye por ti; Dockerfile cuando quieres que Pier construya. |
| vs Railpack (este catálogo) | Railpack auto-detecta tu lenguaje y construye sin Dockerfile. Docker Image corre una imagen que ya construiste en otro lado. Puntos diferentes en la chain build/deploy. |
| vs Docker Compose (este catálogo) | Compose corre múltiples contenedores juntos. Docker Image corre uno. Usa Image para apps single-service; Compose para multi-service. |
| vs Plantillas Pier nativas | Plantillas nativas (PostgreSQL, Gitea, Grafana, ...) vienen pre-cableadas con backups, version selectors, features de scaling. Docker Image es el escape hatch genérico para cualquier cosa no nativamente templateada. |
Preguntas frecuentes
¿Y si la imagen necesita args / commands especiales?
¿Cómo funcionan los volúmenes?
¿Puedo pin tag específico o digest?
¿Límites de recursos?
¿Cómo funciona el routing Traefik?
¿Imágenes privadas?
¿Cómo actualizar?
Servicios relacionados
Desplegar en tu VPS
El despliegue más simple posible — elige una imagen Docker por nombre, configura el puerto y cualquier env vars, y envía. Pier tira la imagen, corre el contenedor, lo adjunta a Traefik para HTTPS, y te da controles logs / restart / env. Sin build, sin Dockerfile, sin Compose.
Desplegar este servicio →