在 Ubuntu 上安装、启动和升级 Docker Desktop

DEB 包

有关校验和,请参见发布说明。

先决条件

要成功安装 Docker Desktop,你必须:

  • 满足系统要求。

  • 拥有 Ubuntu Lunar Lobster 23.04 或 Ubuntu Jammy Jellyfish 22.04(LTS)的 64 位版本。Docker Desktop 支持 x86_64(或 amd64)架构。

  • 对于非 Gnome 桌面环境,必须安装 gnome-terminal:

    $ sudo apt install gnome-terminal
  • 卸载 Linux 上的技术预览版或测试版 Docker Desktop。运行:

    $ sudo apt remove docker-desktop

    要进行完全清理,请删除 $HOME/.docker/desktop 中的配置和数据文件、/usr/local/bin/com.docker.cli 中的符号链接以及剩余的 systemd 服务文件。

    $ rm -r $HOME/.docker/desktop
    $ sudo rm /usr/local/bin/com.docker.cli
    $ sudo apt purge docker-desktop

    注意:如果你安装了 Docker Desktop for Linux 的技术预览版或测试版,则需要删除这些软件包生成的所有文件(例如,~/.config/systemd/user/docker-desktop.service,~/.local/share/systemd/user/docker-desktop.service)。

安装 Docker Desktop

在 Ubuntu 上安装 Docker Desktop 推荐使用以下方法:

  • 设置 Docker 的软件仓库。
# 添加 Docker 的官方 GPG 密钥:
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

#将软件仓库添加到 Apt 源中:
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

注意:如果你使用的是 Ubuntu 派生版发行版,例如 Linux Mint,则可能需要使用 UBUNTU_CODENAME 代替 VERSION_CODENAME。

  • 下载最新的 DEB 包
  • 使用以下命令安装软件包:

    $ sudo apt-get update
    $ sudo apt-get install ./docker-desktop--.deb

    注意:在安装过程结束时,apt 会因为安装了一个已下载的软件包而显示错误。你可以忽略此错误消息。

安装完成后,通过 DEB 包中包含的后安装脚本完成一些后安装配置步骤。该脚本:

  • 设置 Docker Desktop 二进制文件的能力,以映射特权端口并设置资源限制。
  • 为 Kubernetes 添加一个 DNS 名称到 /etc/hosts。
  • 创建一个符号链接,将 /usr/local/bin/com.docker.cli 链接到 /usr/bin/docker。这是因为经典的 Docker CLI 安装在 /usr/bin/docker。Docker Desktop 安装程序还安装了一个 Docker CLI 二进制文件,其中包括云集成功能,并且本质上是 Compose CLI 的包装器,位于 /usr/local/bin/com.docker.cli。符号链接确保包装器可以访问经典的 Docker CLI。

启动 Docker Desktop

要启动 Linux 上的 Docker Desktop,请在应用程序菜单中搜索 Docker Desktop 并打开它。这将启动 Docker 菜单图标并打开 Docker 仪表板,报告 Docker Desktop 的状态。

或者,打开终端并运行:

$ systemctl --user start docker-desktop

当 Docker Desktop 启动时,它会创建一个专用上下文,Docker CLI 可以将其用作目标并将其设置为当前使用的上下文。这是为了避免与可能在 Linux 主机上运行并使用默认上下文的本地 Docker 引擎发生冲突。在关闭时,Docker Desktop 将当前上下文重置为上一个上下文。

Docker Desktop 安装程序会更新主机上的 Docker Compose 和 Docker CLI 二进制文件。它安装 Docker Compose V2,并允许用户选择将其作为 docker-compose 链接到设置面板。Docker Desktop 在 /usr/local/bin/com.docker.cli 中安装新的 Docker CLI 二进制文件,其中包括云集成功能,并创建到经典 Docker CLI 的符号链接。

安装 Docker Desktop 成功后,你可以通过运行以下命令检查这些二进制文件的版本:

$ docker compose version
Docker Compose version v2.17.3

$ docker --version
Docker version 23.0.5, build bc4487a

$ docker version
Client: Docker Engine - Community
 Cloud integration: v1.0.31
 Version:           23.0.5
 API version:       1.42
<...>

要在登录时启用 Docker Desktop,请从 Docker 菜单中选择“设置”>“常规”>“登录时启动 Docker Desktop”。

或者,打开终端并运行:

$ systemctl --user enable docker-desktop

要停止 Docker Desktop,请选择 Docker 菜单图标以打开 Docker 菜单,然后选择“退出 Docker Desktop”。

或者,打开终端并运行:

$ systemctl --user stop docker-desktop

升级 Docker Desktop

一旦发布 Docker Desktop 的新版本,Docker UI 就会显示通知。每次要升级 Docker Desktop 时,你需要下载新软件包并运行:

$ sudo apt-get install ./docker-desktop-<version>-<arch>.deb

下一步

  • 查看入门培训模块,了解如何构建镜像并将其作为容器化应用程序运行。
  • 探索 Docker Desktop 及其所有功能。
  • 查看使用 Docker 开发的主题,了解如何使用 Docker 构建新应用程序。