gcrane: `--platform` is ignored

[lindeskar]

Describe the bug

Using --platform when copying a multi-platform image with gcrane seems to have no effect. The same works as expected with crane.

To Reproduce

Copy image, select platform linux/amd64:

gcrane cp --platform linux/amd64 \
busybox:1.35.0 \
europe-west1-docker.pkg.dev/my-project/my-images/busybox:1.35.0

Get the manifest:

gcrane manifest europe-west1-docker.pkg.dev/my-project/my-images/busybox:1.35.0

This returns a manifest with mediaType: application/vnd.oci.image.index.v1+json and multiple platforms listed.

Also, pulling a different platform (linux/arm64) works fine:

docker pull --platform linux/arm64 \
europe-west1-docker.pkg.dev/my-project/my-images/busybox:1.35.0

Expected behavior

Only the selected platform is copied, like with crane.

Working example with crane

Copy image, select platform linux/amd64:

crane cp --platform linux/amd64 \
busybox:1.36.0 \
europe-west1-docker.pkg.dev/my-project/my-images/busybox:1.36.0

Get the manifest:

crane manifest europe-west1-docker.pkg.dev/my-project/my-images/busybox:1.36.0

This returns a manifest with mediaType: application/vnd.docker.distribution.manifest.v2+json.

Also, pulling a different platform (linux/arm64):

docker pull --platform linux/arm64 \
europe-west1-docker.pkg.dev/my-project/my-images/busybox:1.36.0

Returns the expected error:

image with reference europe-west1-docker.pkg.dev/my-project/my-images/busybox:1.36.0 was found but does not match the specified platform: wanted linux/arm64, actual: linux/amd64

Additional context

$ gcrane version && crane version
v0.20.3
v0.20.3

Source or target registry seems to not matter.

[shantanoo-desai]

Can confirm the same, assuming that the default for --platform is all as mentioned in the help text, crane pull only pull the host's architecture specific image artifacts into a tarball.

on the contrary, when pulling the artifact in OCI format, it tends to pull all possible architecture images (as should be the expected behavior).

So --platform is ignored only for tarball creation and not for OCI related artifacts.

Reproduction

1. spin up a temporary registry

docker run --rm -d --name=test-reg -p 5000:5000 registry:2

2. pull artifacts locally

   a. Tarball

    crane pull busybox:latest busybox-latest-all.tar

   b. OCI artifacts

   crane pull --format=oci busybox:latest oci:busybox-latest-all

3. Push artifact to local registry

   a. Tarball

   crane push busybox-latest-all.tar localhost:5000/busybox-tar:latest

   b. OCI artifacts

   crane push oci:busybox-latest-all localhost:5000/busybox-oci:latest

4. Check Manifests

   a. Tarball

   crane manifest localhost:5000/busybox-tar:latest | jq

   b. OCI

   crane manifest localhost:5000/busybox-oci:latest | jq

Outputs

Tarball

{
  "schemaVersion": 2,
  "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
  "config": {
    "mediaType": "application/vnd.docker.container.image.v1+json",
    "size": 459,
    "digest": "sha256:31311c5853a22c04d692f6581b4faa25771d915c1ba056c74e5ec82606eefdfa"
  },
  "layers": [
    {
      "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
      "size": 2155907,
      "digest": "sha256:9c0abc9c5bd3a7854141800ba1f4a227baa88b11b49d8207eadc483c3f2496de"
    }
  ]
}

OCI

{
  "manifests": [
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "amd64",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "07389fddb83df4179472e65a462e69a4941ddb2c",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-glibc"
      },
      "digest": "sha256:42279ede3600b4e63af075a5e27d68232ff837d9cdcaba74feffc7ab0dfec0dc",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "amd64",
        "os": "linux"
      },
      "size": 610
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "amd64",
        "vnd.docker.reference.digest": "sha256:42279ede3600b4e63af075a5e27d68232ff837d9cdcaba74feffc7ab0dfec0dc",
        "vnd.docker.reference.type": "attestation-manifest"
      },
      "digest": "sha256:66e6f10bc167713f31f106cfc694662af90b4636d2510f3026ef00d33377dbbf",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "unknown",
        "os": "unknown"
      },
      "size": 559
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "arm32v5",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "d7f57c5b77bf55a6a45fae8ae233a517c8363723",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-glibc"
      },
      "digest": "sha256:2e4c77aba6a9cd0a9045e60883cc0d38064e2dc8c00d7eb88685c86c07180113",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "arm",
        "os": "linux",
        "variant": "v5"
      },
      "size": 610
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "arm32v5",
        "vnd.docker.reference.digest": "sha256:2e4c77aba6a9cd0a9045e60883cc0d38064e2dc8c00d7eb88685c86c07180113",
        "vnd.docker.reference.type": "attestation-manifest"
      },
      "digest": "sha256:f512fd208f19112afdf7fb156873112422c03130f04c0ad1c3b9a7714d5e96b1",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "unknown",
        "os": "unknown"
      },
      "size": 559
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "arm32v6",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "cb468d3b984acc78e535ac790228e9b38e978e72",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-musl"
      },
      "digest": "sha256:b5b55bf223a3635f79f101b94edc13ef78448fa83eff0fbd4430feeb3d2285c8",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "arm",
        "os": "linux",
        "variant": "v6"
      },
      "size": 608
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "arm32v7",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "aa8eb6cedd8db85c1d39c262ce7a948a57148b97",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-glibc"
      },
      "digest": "sha256:dafaef1373b2d4301b022f2f3f26f2a016e645b7e0a4940f6f073d766ff2c382",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "arm",
        "os": "linux",
        "variant": "v7"
      },
      "size": 610
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "arm32v7",
        "vnd.docker.reference.digest": "sha256:dafaef1373b2d4301b022f2f3f26f2a016e645b7e0a4940f6f073d766ff2c382",
        "vnd.docker.reference.type": "attestation-manifest"
      },
      "digest": "sha256:b74f9295457d80d0238c6ce847d20088cca1e1b3b0312b89ae8fe749e5c49ab2",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "unknown",
        "os": "unknown"
      },
      "size": 559
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "arm64v8",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "8e2f8cc2af967eab1374d1911d32d4ece9b4c88e",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-glibc"
      },
      "digest": "sha256:bc17845ef50fdfe6643ea6535eb9df68623dc52c7a3bceb8401fe85d9dca2a0e",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "arm64",
        "os": "linux",
        "variant": "v8"
      },
      "size": 610
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "arm64v8",
        "vnd.docker.reference.digest": "sha256:bc17845ef50fdfe6643ea6535eb9df68623dc52c7a3bceb8401fe85d9dca2a0e",
        "vnd.docker.reference.type": "attestation-manifest"
      },
      "digest": "sha256:d79dafa288d6a2047583d4f00ac0c7e0ad89b51b11fb7808c24f2d4d7a796b80",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "unknown",
        "os": "unknown"
      },
      "size": 559
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "i386",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "e76a8a15436a97e1b9da168e31afb69015a1d8f9",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-glibc"
      },
      "digest": "sha256:dd8eb0e3533fca3b8a42cef2cb675f207067b4be902debbce11edf43ba1b3147",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "386",
        "os": "linux"
      },
      "size": 610
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "i386",
        "vnd.docker.reference.digest": "sha256:dd8eb0e3533fca3b8a42cef2cb675f207067b4be902debbce11edf43ba1b3147",
        "vnd.docker.reference.type": "attestation-manifest"
      },
      "digest": "sha256:6d7d02e6bdc411ef7a0c9a3159a3c99207f60d9a2d0c147dce4d7b00c0a8fe88",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "unknown",
        "os": "unknown"
      },
      "size": 559
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "mips64le",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "e7213797efd6a7f791f486d4cfd50255dd8b4ba9",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-glibc"
      },
      "digest": "sha256:f243d6108c211d7ca19b429da903ab544abf57eab8d7b52a23852cdfd67640d6",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "mips64le",
        "os": "linux"
      },
      "size": 610
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "ppc64le",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "731a77dbe76d145e73da48c87420cee6ffb5497c",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-glibc"
      },
      "digest": "sha256:e88a72476a15c4dab3e80a23a55c2a9ede723b817cee23b0494fe3f87106ddd2",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "ppc64le",
        "os": "linux"
      },
      "size": 610
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "ppc64le",
        "vnd.docker.reference.digest": "sha256:e88a72476a15c4dab3e80a23a55c2a9ede723b817cee23b0494fe3f87106ddd2",
        "vnd.docker.reference.type": "attestation-manifest"
      },
      "digest": "sha256:c59fec3d1a7dc404126598e5a6c2edac6bfafae4361764606dfacb2adb105e6b",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "unknown",
        "os": "unknown"
      },
      "size": 559
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "riscv64",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "cf916c8a1a242156f40e6430c3a1e99a7b66fba4",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-musl"
      },
      "digest": "sha256:f3216dee9319f81a07ea2bc107830ceca156749c51fb9fa9bd70041cfe4261c9",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "riscv64",
        "os": "linux"
      },
      "size": 608
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "riscv64",
        "vnd.docker.reference.digest": "sha256:f3216dee9319f81a07ea2bc107830ceca156749c51fb9fa9bd70041cfe4261c9",
        "vnd.docker.reference.type": "attestation-manifest"
      },
      "digest": "sha256:f1957b6383d604e066a5c34273193800b903dde50d7ace28e634067ffc92c913",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "unknown",
        "os": "unknown"
      },
      "size": 559
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "s390x",
        "org.opencontainers.image.base.name": "scratch",
        "org.opencontainers.image.created": "2025-02-19T23:56:18Z",
        "org.opencontainers.image.revision": "135a0514d25edfe99270e3b8bf3802ed96936130",
        "org.opencontainers.image.source": "https://github.com/docker-library/busybox.git",
        "org.opencontainers.image.url": "https://hub.docker.com/_/busybox",
        "org.opencontainers.image.version": "1.37.0-glibc"
      },
      "digest": "sha256:e5d950ae866bc49b194cb72fa7f82c88f6e660aa14b2307a7841d864eff23119",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "s390x",
        "os": "linux"
      },
      "size": 610
    },
    {
      "annotations": {
        "com.docker.official-images.bashbrew.arch": "s390x",
        "vnd.docker.reference.digest": "sha256:e5d950ae866bc49b194cb72fa7f82c88f6e660aa14b2307a7841d864eff23119",
        "vnd.docker.reference.type": "attestation-manifest"
      },
      "digest": "sha256:645bdbb54b2ef13bb8b345e09da58bec30f4857c276020d9c7cbbf56e4dc3e97",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {
        "architecture": "unknown",
        "os": "unknown"
      },
      "size": 559
    }
  ],
  "mediaType": "application/vnd.oci.image.index.v1+json",
  "schemaVersion": 2
}