为扩展配置私有市场

Table of contents

Availability: Beta

For: Administrators

了解如何为 Docker Desktop 用户配置和设置带有精选扩展列表的私有市场。

Docker Extensions 的私有市场专为那些不授予开发人员机器 root 访问权限的组织而设计。它利用设置管理，使管理员可以完全控制私有市场。

先决条件

下载并安装 Docker Desktop 4.26.0 或更高版本。
您必须是您组织的管理员。
您有能力通过设备管理软件（如 Jamf）将 extension-marketplace 文件夹和 admin-settings.json 文件推送到以下指定位置。

初始化您的市场配置文件：

$ /Applications/Docker.app/Contents/Resources/bin/extension-admin init

$ C:\Program Files\Docker\Docker\resources\bin\extension-admin init

$ /opt/docker-desktop/extension-admin init

这将创建两个文件：

生成的 admin-settings.json 文件包含您可以修改的各种设置。

每个设置都有一个可以设置的 value，包括一个 locked 字段，该字段允许您锁定设置并使其对开发人员不可更改。

extensionsEnabled 启用 Docker Extensions。
extensionsPrivateMarketplace 激活私有市场，并确保 Docker Desktop 连接到由管理员定义和控制的内容，而不是公共 Docker 市场。
onlyMarketplaceExtensions 允许或阻止开发人员使用命令行安装其他扩展。开发新扩展的团队必须将此设置解锁（"locked": false）才能安装和测试正在开发的扩展。
extensionsPrivateMarketplaceAdminContactURL 定义一个联系链接，开发人员可以通过该链接在私有市场中请求新扩展。如果 value 为空，则在 Docker Desktop 上不会向您的开发人员显示任何链接，否则这可以是 HTTP 链接或 “mailto:” 链接。例如，
"extensionsPrivateMarketplaceAdminContactURL": { "locked": true, "value": "mailto:admin@acme.com" }

有关 admin-settings.json 文件的更多信息，请参阅设置管理。

生成的 extensions.txt 文件定义了在私有市场中可用的扩展列表。

文件中的每一行都是一个允许的扩展，格式为 org/repo:tag。

例如，如果您希望允许 Disk Usage 扩展，您可以在 extensions.txt 文件中输入以下内容：

docker/disk-usage-extension:0.2.8

如果未提供标签，则使用镜像的最新可用标签。您还可以使用 # 注释掉行，以便忽略该扩展。

此列表可以包括不同类型的扩展镜像：

Important

您的开发人员只能安装您列出的扩展版本。

一旦 extensions.txt 中的列表准备就绪，您就可以生成市场：

$ /Applications/Docker.app/Contents/Resources/bin/extension-admin generate

$ C:\Program Files\Docker\Docker\resources\bin\extension-admin generate

$ /opt/docker-desktop/extension-admin generate

这将创建一个 extension-marketplace 目录，并下载所有允许扩展的市场元数据。

市场内容从扩展镜像信息（如镜像标签）生成，这与公共扩展的格式相同。它包括扩展标题、描述、截图、链接等。

建议您在 Docker Desktop 安装上尝试私有市场。