La importación de imágenes de contenedor RouterOS falla con 'no manifest.json' — docker-archive vs layout OCI

Problema

add.rsc
/container/add file=myimage.tar interface=veth1

falla (visible en el comentario de /container/print o en /log/print):

output.txt
download/extract error: no manifest.json in archive

Causa

El importador file= de RouterOS espera el formato docker-archive heredado (layout de salida de docker save), concretamente:

  • manifest.json en la raíz del tar — literalmente llamado manifest.json, no ./manifest.json ni dentro de un subdirectorio
  • más config.json y el/los tar(s) de capas

Dos formas de topar con el error:

  1. Tarball de rootfs plano — un tar de un filesystem sin los metadatos docker. No es una imagen.
  2. Layout OCI — la salida moderna de docker save/docker buildx -o type=docker usa blobs/sha256/... + index.json en lugar de manifest.json en la raíz. RouterOS no puede leerlo.

Solución 1: construir un docker-archive a mano

Para un directorio rootfs rootfs/:

mkimg.sh
tar -cf layer.tar -C rootfs .
SHA=$(sha256sum layer.tar | cut -d' ' -f1)
mkdir img && cp layer.tar img/
cat > img/config.json <<EOJ
{"architecture":"arm","variant":"v5","os":"linux",
 "config":{"Entrypoint":["/busybox"],"Cmd":["sleep","600"]},
 "rootfs":{"type":"layers","diff_ids":["sha256:$SHA"]}}
EOJ
printf '[{"Config":"config.json","RepoTags":["img:latest"],"Layers":["layer.tar"]}]' > img/manifest.json
# important: archive the files at tar ROOT, no ./ prefix:
cd img && tar -cf ../img.tar manifest.json config.json layer.tar

Luego scp -O img.tar admin@router:img.tar y /container/add file=img.tar ....

Solución 2: convertir OCI a docker-archive

skopeo.sh
skopeo copy oci-archive:oci.tar docker-archive:legacy.tar:mytag:1

skopeo convierte entre formatos de imagen — necesario porque incluso docker save en Docker reciente emite el layout OCI que RouterOS rechaza.


Echa un vistazo a artículos similares por categoría: MikroTik Redes Docker