Tecnología · GUÍA PRÁCTICA
¿Docker dice no matching manifest? Demuestra la plataforma antes de forzar arquitectura
Vincula la petición del host o override con el índice inmutable, OS, arquitectura y variant antes de fijar un digest, republicar o emular.
“No matching manifest” significa que Docker no pudo unir la plataforma efectiva con un descriptor compatible del índice. No demuestra que el portátil esté mal ni que `--platform linux/amd64` sea seguro. Conserva primero ambos lados.
Congela la petición y referencia exactas
Guarda comando, error completo, referencia, versiones Docker/Compose, contexto activo, arquitectura de cliente/daemon y todos los overrides en entorno, Compose y build. Conserva tag o digest exactos y no agregues todavía `--platform`.
Inspecciona el índice inmutable
Inspecciona la referencia exacta en el registry real. Registra media type, digest del índice y digest, OS, arquitectura y variant de cada descriptor. Si resuelve a un solo manifest, regístralo también.
Une petición y descriptor
Compara exactamente la petición efectiva con los descriptors. `linux/amd64` no coincide con `linux/arm64`; la variant ARM puede importar y un attestation de plataforma unknown no es ejecutable. Separa omisión del publicador de una petición alterada por contexto o política.
Elige remedio según propiedad
Si existe descriptor nativo, fija su digest o corrige política obsoleta. Si falta una variante en una imagen propia, constrúyela y publica un índice completo. Si la arquitectura ajena es intencional, declara y prueba la emulación; si no hay variante compatible, cambia de tag.
Vincula despliegue a bytes revisados
Registra el digest específico de plataforma y, si conviene, el digest del índice padre. Haz visible la elección en Compose, CI o política de despliegue. Cambiar solo el tag es provisional porque puede moverse.
Demuestra arquitectura y repetibilidad
Descarga con caché limpia, inspecciona digest y arquitectura, inicia la carga y verifica arquitectura y salud. Repite en cada host soportado. Detente ante cambio de digest, emulación implícita, índice cambiante o variante sin explicación.
