构建多架构扩展

强烈建议您的扩展至少支持以下体系结构：

linux/amd64
linux/arm64

Docker Desktop 根据用户的系统架构检索扩展镜像。如果扩展未提供与用户的系统体系结构匹配的镜像，则 Docker Desktop 无法安装扩展。因此，用户无法在 Docker Desktop 中运行扩展。

构建和推送多个架构

如果您从docker extension init命令、Makefile在目录的根目录中包含一个名称为push-extension.

您可以运行make push-extension针对两者构建扩展linux/amd64和linux/arm64平台，并将它们推送到 Docker Hub。

例如：

$ make push-extension

或者，如果您从空目录开始，请使用下面的命令要为多个架构构建扩展，请执行以下作：

$ docker buildx build --push --platform=linux/amd64,linux/arm64 --tag=username/my-extension:0.0.1 .

然后，您可以检查镜像清单，查看该镜像是否可用于两者使用docker buildx imagetools命令:

$ docker buildx imagetools inspect username/my-extension:0.0.1
Name:      docker.io/username/my-extension:0.0.1
MediaType: application/vnd.docker.distribution.manifest.list.v2+json
Digest:    sha256:f3b552e65508d9203b46db507bb121f1b644e53a22f851185d8e53d873417c48

Manifests:
  Name:      docker.io/username/my-extension:0.0.1@sha256:71d7ecf3cd12d9a99e73ef448bf63ae12751fe3a436a007cb0969f0dc4184c8c
  MediaType: application/vnd.docker.distribution.manifest.v2+json
  Platform:  linux/amd64

  Name:      docker.io/username/my-extension:0.0.1@sha256:5ba4ceea65579fdd1181dfa103cc437d8e19d87239683cf5040e633211387ccf
  MediaType: application/vnd.docker.distribution.manifest.v2+json
  Platform:  linux/arm64

提示
如果您在推送镜像时遇到问题，请确保您已登录到 Docker Hub。否则，请运行docker login进行身份验证。

有关更多信息，请参阅多平台镜像页面。

添加多架构Binaries

如果您的扩展包含一些部署到主机的Binaries，那么在针对多个体系结构构建扩展时，它们也必须具有正确的体系结构。

目前，Docker 没有提供一种方法来为metadata.json文件。但是，您可以根据TARGETARCH在扩展的Dockerfile.

以下示例显示了一个使用Binaries作为其作一部分的扩展。该扩展需要在适用于 Mac 和 Windows 的 Docker Desktop 中运行。

在Dockerfile，根据目标架构下载Binaries：

#syntax=docker/dockerfile:1.3-labs

FROM alpine AS dl
WORKDIR /tmp
RUN apk add --no-cache curl tar
ARG TARGETARCH
RUN <<EOT ash
    mkdir -p /out/darwin
    curl -fSsLo /out/darwin/kubectl "https://dl.k8s.io/release/$(curl -Ls https://dl.k8s.io/release/stable.txt)/bin/darwin/${TARGETARCH}/kubectl"
    chmod a+x /out/darwin/kubectl
EOT
RUN <<EOT ash
    if [ "amd64" = "$TARGETARCH" ]; then
        mkdir -p /out/windows
        curl -fSsLo /out/windows/kubectl.exe "https://dl.k8s.io/release/$(curl -Ls https://dl.k8s.io/release/stable.txt)/bin/windows/amd64/kubectl.exe"
    fi
EOT

FROM alpine
LABEL org.opencontainers.image.title="example-extension" \
    org.opencontainers.image.description="My Example Extension" \
    org.opencontainers.image.vendor="Docker Inc." \
    com.docker.desktop.extension.api.version=">= 0.3.3"

COPY --from=dl /out /

在metadata.jsonfile 中，指定每个平台上每个Binaries的路径：

{
  "icon": "docker.svg",
  "ui": {
    "dashboard-tab": {
      "title": "Example Extension",
      "src": "index.html",
      "root": "ui"
    }
  },
  "host": {
    "binaries": [
      {
        "darwin": [
          {
            "path": "/darwin/kubectl"
          }
        ],
        "windows": [
          {
            "path": "/windows/kubectl.exe"
          }
        ]
      }
    ]
  }
}

因此，当TARGETARCH等于：

arm64这kubectlbinary fetched 对应于arm64体系结构，并将其复制到/darwin/kubectl在最后阶段。
amd64二kubectl获取Binaries。一个用于 Darwin，另一个用于 Windows。它们被复制到/darwin/kubectl和/windows/kubectl.exe分别在最后阶段。

注意
Darwin 的二进制目标路径为darwin/kubectl在这两种情况下。唯一的更改是下载的特定于体系结构的Binaries。

安装扩展后，扩展框架会从扩展镜像中复制Binaries，网址为/darwin/kubectl达尔文，或/windows/kubectl.exe对于 Windows，则添加到用户主机文件系统中的特定位置。

我可以开发运行 Windows 容器的扩展吗？

尽管适用于 Windows、Mac 和 Linux 的 Docker Desktop 支持 Docker 扩展，但扩展框架仅支持 Linux 容器。因此，您必须将linux作为 OS 进行构建。