为多个架构构建扩展
强烈建议至少为以下架构提供扩展支持
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
进行身份验证。
有关更多信息,请参阅 多平台映像 页面。
添加多架构二进制文件
如果您的扩展包含一些部署到主机的二进制文件,则在针对多个架构构建扩展时,这些二进制文件也必须具有正确的架构。
目前,Docker 无法在 metadata.json
文件中为每个架构显式指定多个二进制文件。但是,您可以根据扩展的 Dockerfile
中的 TARGETARCH
添加特定于架构的二进制文件。
以下示例显示了一个使用二进制文件作为其操作一部分的扩展。该扩展需要在 Docker Desktop for Mac 和 Windows 中运行。
在 Dockerfile
中,根据目标架构下载二进制文件
#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.json
文件中,指定每个平台上每个二进制文件的路径
{
"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
时,获取的kubectl
二进制文件对应于arm64
架构,并在最终阶段复制到/darwin/kubectl
。amd64
时,将获取两个kubectl
二进制文件。一个用于 Darwin,另一个用于 Windows。它们分别在最终阶段复制到/darwin/kubectl
和/windows/kubectl.exe
。
注意
两种情况下,Darwin 的二进制文件目标路径均为
darwin/kubectl
。唯一的区别是下载的特定于架构的二进制文件。
安装扩展时,扩展框架会将扩展映像中 /darwin/kubectl
(对于 Darwin)或 /windows/kubectl.exe
(对于 Windows)中的二进制文件复制到用户主机文件系统中的特定位置。
我能否开发运行 Windows 容器的扩展?
尽管 Docker Extensions 支持 Docker Desktop for Windows、Mac 和 Linux,但扩展框架仅支持 Linux 容器。因此,在构建扩展映像时,必须将 linux
作为操作系统进行目标设置。