创建简单的扩展

目录

要开始创建您的扩展，首先需要一个包含文件（从扩展源代码到所需的扩展特定文件）的目录。本页提供了如何设置基于纯 HTML 的最小前端扩展的信息。

开始之前，请确保您已安装最新版本的 Docker Desktop。

提示

如果您想为新扩展创建一个代码库，我们的快速入门指南和 docker extension init <my-extension> 将为您的扩展提供更好的基础。

扩展文件夹结构

在 minimal-frontend 示例文件夹 中，您可以找到一个现成的示例，它代表了基于 HTML 构建的 UI 扩展。在本教程中，我们将讲解此代码示例。

尽管您可以从一个空目录开始，但强烈建议您从下面的模板开始，并根据您的需求进行相应的修改。

.
├── Dockerfile # (1)
├── metadata.json # (2)
└── ui # (3)
    └── index.html
  1. 包含构建扩展并在 Docker Desktop 中运行所需的一切。
  2. 提供扩展信息（如名称、描述和版本）的文件。
  3. 包含所有 HTML、CSS 和 JS 文件的源文件夹。其中还可以包含其他静态资源，例如徽标和图标。有关构建 UI 的更多信息和指南，请参阅设计和 UI 样式部分。

创建 Dockerfile

您的 Dockerfile 至少需要

  • 标签，它们提供关于扩展、图标和截图的额外信息。
  • 源代码，在这种情况下是位于 ui 文件夹中的 index.html 文件。
  • metadata.json 文件。
# syntax=docker/dockerfile:1
FROM scratch

LABEL org.opencontainers.image.title="Minimal frontend" \
    org.opencontainers.image.description="A sample extension to show how easy it's to get started with Desktop Extensions." \
    org.opencontainers.image.vendor="Awesome Inc." \
    com.docker.desktop.extension.api.version="0.3.3" \
    com.docker.desktop.extension.icon="https://docker.net.cn/wp-content/uploads/2022/03/Moby-logo.png"

COPY ui ./ui
COPY metadata.json .

配置元数据文件

镜像文件系统的根目录需要一个 metadata.json 文件。

{
  "ui": {
    "dashboard-tab": {
      "title": "Minimal frontend",
      "root": "/ui",
      "src": "index.html"
    }
  }
}

有关 metadata.json 的更多信息，请参阅元数据。

构建并安装扩展

配置好扩展后，您需要构建 Docker Desktop 将用于安装的扩展镜像。

$ docker build --tag=awesome-inc/my-extension:latest .

这构建了一个标记为 awesome-inc/my-extension:latest 的镜像，您可以运行 docker inspect awesome-inc/my-extension:latest 查看更多详细信息。

最后，您可以安装扩展并在 Docker Desktop 仪表板中看到它出现。

$ docker extension install awesome-inc/my-extension:latest

预览扩展

要在 Docker Desktop 中预览扩展，安装完成后请关闭并重新打开 Docker Desktop 仪表板。

左侧菜单会显示一个以您的扩展名称命名的新标签页。

Minimal frontend extension

下一步？

页面选项