fix(docker): accept the pinned image id when the stores report different ids

Docker ids are not comparable across image stores: for the same content a
classic store reports the config digest while a containerd store (or an
image loaded from an OCI archive) reports the manifest digest. The
controller pins the id of its own daemon, so a compute whose store reports
another id for that content answered ImageMissingError forever: every node
creation streamed the image again (save/load round trip) without ever
converging, then failed with "The image 'x' is missing" after the six
retries. Docker 29 makes this easy to hit, since the id a daemon reports
now depends on how the image entered it.

The load endpoint now takes the tag and the digest pinned by the
controller, and the compute records how its own daemon identifies the
image it just received. Node creation accepts the pin through that pair,
and only while the tag still resolves to the synced content: a tag moved
to some other image, or an image the controller never pushed here, still
counts as missing. The pair lives in the compute process, so a restarted
compute syncs once more.

Computes that predate the new endpoint parameters keep the previous
behaviour, as do controllers that do not send them.

gns3server/api/routes/compute/images.py

@@ -20,9 +20,9 @@ API routes for images.
 
 import os
 import urllib.parse
-from typing import List
+from typing import List, Optional
 
-from fastapi import APIRouter, Body, HTTPException, Request, status
+from fastapi import APIRouter, Body, HTTPException, Query, Request, status
 from fastapi.responses import FileResponse
 
 from gns3server.compute.docker import Docker
@@ -54,13 +54,23 @@ async def pull_docker_image(image: str = Body(..., embed=True, min_length=1, pat
 
 
 @router.post("/docker/images/load", status_code=status.HTTP_204_NO_CONTENT)
-async def load_docker_image(request: Request) -> None:
+async def load_docker_image(
+    request: Request,
+    image: Optional[str] = Query(None, pattern=r"^\S+$", description="Tag of the image in the archive"),
+    digest: Optional[str] = Query(
+        None, pattern=r"^\S+$", description="Image id reported by the controller host daemon"
+    ),
+) -> None:
     """
     Load a Docker image into the Docker daemon from a docker save tar stream.
+
+    The optional image tag and digest let the compute remember which image the
+    controller pushed and how the local daemon identifies it (see
+    Docker.load_image).
     """
 
     docker_manager = Docker.instance()
-    await docker_manager.load_image(request.stream())
+    await docker_manager.load_image(request.stream(), image=image, digest=digest)
 
 
 @router.get("/dynamips/images")