要在 Ubuntu 上开始使用 Docker Engine,请确保 满足先决条件,然后 安装 Docker。
先决条件
操作系统要求
要安装 Docker Engine,您需要以下 Ubuntu 版本之一的 64 位版本:
- Ubuntu Jammy 22.04 (LTS)
- Ubuntu 小鬼 21.10
- Ubuntu 焦点 20.04 (LTS)
- Ubuntu 仿生 18.04 (LTS)
Docker 引擎与x86_64(或amd64)armhf、、、arm64和 s390x架构兼容。
卸载旧版本
旧版本的 Docker 的名称为docker、docker.io或 docker-engine. 在尝试安装新版本之前卸载任何此类旧版本:
$ sudo apt-get remove docker docker-engine docker.io containerd runc
apt-get如果报告没有安装这些软件包,那也没关系。
/var/lib/docker/卸载 Docker 时,不会自动删除其中存储的映像、容器、卷和网络。如果您想从全新安装开始,并希望清理任何现有数据,请参阅 卸载 Docker 引擎部分。
安装方法
您可以根据需要以不同的方式安装 Docker Engine:
- Docker Engine 与Docker Desktop for Linux捆绑在一起 。这是最简单、最快捷的开始方式。
- 您还可以从Docker 的
apt存储库中设置和安装 Docker Engine 。 - 手动安装并手动管理升级。
- 使用方便的脚本。仅推荐用于测试和开发环境。
使用存储库安装
在新主机上首次安装 Docker Engine 之前,您需要设置 Docker 存储库。之后,您可以从存储库安装和更新 Docker。
设置存储库
- 更新
apt包索引并安装包以允许apt通过 HTTPS 使用存储库:$ sudo apt-get update $ sudo apt-get install \ ca-certificates \ curl \ gnupg \ lsb-release - 添加 Docker 的官方 GPG 密钥:
$ sudo mkdir -p /etc/apt/keyrings $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg - 使用以下命令设置存储库:
$ echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
安装 Docker 引擎
- 更新
apt包索引:$ sudo apt-get update运行时收到 GPG 错误apt-get update?您的默认umask可能配置不正确,从而阻止了对存储库公钥文件的检测。在更新包索引之前尝试授予 Docker 公钥文件的读取权限:$ sudo chmod a+r /etc/apt/keyrings/docker.gpg $ sudo apt-get update - 安装 Docker 引擎、containerd 和 Docker Compose。要安装最新版本,请运行:
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin hello-world通过运行镜像来验证 Docker Engine 安装是否成功 :$ sudo docker run hello-world此命令下载测试映像并在容器中运行它。当容器运行时,它会打印一条确认消息并退出。
您现在已经成功安装并启动了 Docker 引擎。用户组存在但不包含任何用户,这docker就是为什么您需要使用它sudo 来运行 Docker 命令。继续Linux 后安装 以允许非特权用户运行 Docker 命令和其他可选配置步骤。
升级 Docker 引擎
要升级 Docker Engine,请按照 安装说明,选择您要安装的新版本。
从包安装
如果您无法使用 Docker 的apt存储库来安装 Docker Engine,您可以下载deb适用于您的发行版的文件并手动安装。每次升级 Docker Engine 时都需要下载一个新文件。
- 去
https://download.docker.com/linux/ubuntu/dists/。 - 在列表中选择您的 Ubuntu 版本。
- 转到
pool/stable/并选择适用的架构(amd64、armhf、arm64或s390x)。 deb为 Docker 引擎、CLI、containerd 和 Docker Compose 包下载以下文件:containerd.io_<version>_<arch>.debdocker-ce_<version>_<arch>.debdocker-ce-cli_<version>_<arch>.debdocker-compose-plugin_<version>_<arch>.deb
- 安装
.deb软件包。将以下示例中的路径更新为您下载 Docker 包的位置。$ sudo dpkg -i ./containerd.io_<version>_<arch>.deb \ ./docker-ce_<version>_<arch>.deb \ ./docker-ce-cli_<version>_<arch>.deb \ ./docker-compose-plugin_<version>_<arch>.debDocker 守护进程自动启动。 hello-world通过运行镜像来验证 Docker Engine 安装是否成功 :$ sudo docker run hello-world此命令下载测试映像并在容器中运行它。当容器运行时,它会打印一条确认消息并退出。
您现在已经成功安装并启动了 Docker 引擎。用户组存在但不包含任何用户,这docker就是为什么您需要使用它sudo 来运行 Docker 命令。继续Linux 后安装 以允许非特权用户运行 Docker 命令和其他可选配置步骤。
升级 Docker 引擎
要升级 Docker Engine,请下载更新的包文件并重复 安装过程,指向新文件。
使用便捷脚本安装
Docker 在https://get.docker.com/提供了一个方便的脚本, 以非交互方式将 Docker 安装到开发环境中。不建议将便利脚本用于生产环境,但它对于创建适合您的需求的配置脚本很有用。另请参阅 使用存储库安装步骤以了解使用包存储库安装的安装步骤。该脚本的源代码是开源的,可以 docker-install在 GitHub 上的存储库中找到。
在本地运行脚本之前,请务必检查从 Internet 下载的脚本。在安装之前,请让自己熟悉便捷脚本的潜在风险和限制:
- 该脚本需要
root或sudo特权才能运行。 - 该脚本会尝试检测您的 Linux 发行版和版本,并为您配置包管理系统。
- 该脚本不允许您自定义大多数安装参数。
- 该脚本会在不要求确认的情况下安装依赖项和建议。这可能会安装大量软件包,具体取决于主机的当前配置。
- 默认情况下,该脚本安装 Docker、containerd 和 runc 的最新稳定版本。使用此脚本配置机器时,可能会导致 Docker 的主要版本升级意外。在部署到生产系统之前,始终在测试环境中测试升级。
- 该脚本并非旨在升级现有的 Docker 安装。使用脚本更新现有安装时,可能无法将依赖项更新到预期版本,从而导致版本过时。
提示:运行前预览脚本步骤
您可以使用DRY_RUN=1选项运行脚本,以了解脚本在调用时将运行哪些步骤:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ DRY_RUN=1 sudo sh ./get-docker.sh
此示例从https://get.docker.com/下载脚本 并运行它以在 Linux 上安装最新的稳定版本的 Docker:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh
Executing docker install script, commit: 7cae5f8b0decc17d6571f9f52eb840fbc13b2737
<...>
您现在已经成功安装并启动了 Docker 引擎。该docker 服务在基于 Debian 的发行版上自动启动。在RPM基于发行版(例如 CentOS、Fedora、RHEL 或 SLES)上,您需要使用适当的systemctlorservice命令手动启动它。如消息所示,默认情况下,非 root 用户无法运行 Docker 命令。
以非特权用户身份使用 Docker,还是以无根模式安装?
安装脚本需要
root或sudo具有安装和使用 Docker 的权限。如果要授予非 root 用户对 Docker 的访问权限,请参阅 Linux 的安装后步骤。您也可以在没有root权限的情况下安装 Docker,或者将其配置为以无根模式运行。有关在无根模式下运行 Docker 的说明,请参阅以 非 root 用户身份运行 Docker 守护程序(无根模式)。
安装预发行版
Docker 还在 https://test.docker.com/上提供了一个方便的脚本,用于在 Linux 上安装 Docker 的预发布版本。此脚本等同于 处的脚本get.docker.com,但将您的包管理器配置为使用 Docker 包存储库的测试通道。测试通道包括 Docker 的稳定版和预发布版(beta 版、候选发布版)。使用此脚本可以提前访问新版本,并在发布稳定之前在测试环境中对其进行评估。
要从测试通道在 Linux 上安装最新版本的 Docker,请运行:
$ curl -fsSL https://test.docker.com -o test-docker.sh
$ sudo sh test-docker.sh
使用便利脚本后升级 Docker
如果您使用便捷脚本安装 Docker,则应直接使用包管理器升级 Docker。重新运行便捷脚本没有任何好处。如果它尝试重新安装主机上已经存在的存储库,则重新运行它可能会导致问题。
卸载 Docker 引擎
- 卸载 Docker Engine、CLI、containerd 和 Docker Compose 包:
$ sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-compose-plugin - 主机上的映像、容器、卷或自定义配置文件不会自动删除。要删除所有映像、容器和卷:
$ sudo rm -rf /var/lib/docker $ sudo rm -rf /var/lib/containerd
