Debian 10 安装 Docker、Docker Compose 与 Ansible 完整指南

2020-09-19 · Ryan · 发表评论

前言

本指南将详细介绍在 Debian 10 (Buster) 系统上安装 Docker 容器引擎、Docker Compose 编排工具以及 Ansible 自动化运维工具的完整步骤。文中已根据最新实践更新命令与说明。

安装 Docker 容器引擎

1. 卸载旧版本（如有）

如果系统上存在旧版本的 Docker（如 docker、docker.io 或 docker-engine），建议先将其卸载。

sudo apt-get remove docker docker-engine docker.io containerd runc

2. 安装依赖包

更新软件包索引并安装必要的依赖包，以便通过 HTTPS 使用仓库。

sudo apt-get update
sudo apt-get install 
    apt-transport-https 
    ca-certificates 
    curl 
    gnupg-agent 
    software-properties-common

3. 添加 Docker 官方 GPG 密钥

添加 Docker 官方的 GPG 密钥，用于验证软件包的完整性。

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

4. 验证密钥指纹

可以通过以下命令验证密钥指纹的后 8 位是否为 0EBFCD88。

sudo apt-key fingerprint 0EBFCD88

输出应包含 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88。

5. 设置稳定版仓库

将 Docker 的稳定版仓库添加到 APT 源列表中。

sudo add-apt-repository 
   "deb [arch=amd64] https://download.docker.com/linux/debian 
   $(lsb_release -cs) 
   stable"

6. 安装 Docker Engine

更新软件包索引并安装最新版本的 Docker Engine、CLI 和 Containerd。

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

Docker 的默认安装路径为 /var/lib/docker。

7. 安装特定版本（可选）

如果需要安装特定版本的 Docker Engine，请按以下步骤操作：

列出仓库中可用的版本：
```
apt-cache madison docker-ce
```
安装指定版本（将 <VERSION_STRING> 替换为上一步查到的具体版本号，例如 5:20.10.7~3-0~debian-buster）：
```
sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io
```

8. 验证安装

运行 Hello World 镜像以测试 Docker 是否安装成功，并查看 Docker 版本。

sudo docker run hello-world
docker --version

9. 管理 Docker 服务

设置 Docker 服务开机自启或禁止自启。

sudo systemctl enable docker  # 开机自启
sudo systemctl disable docker # 禁止开机自启

（注：在 Debian 10 上，使用 systemctl 是推荐方式。原文中提到的 /lib/systemd/systemd-sysv-install 命令通常用于管理 SysV 风格的初始化脚本，对于 Docker 服务直接使用 systemctl 即可。）

更多关于 Docker 守护进程的配置（如以非 root 用户运行 Docker），请参考官方文档。

安装 Docker Compose

Docker Compose 是一个用于定义和运行多容器 Docker 应用程序的工具。建议从 GitHub 发布页面下载最新稳定版本。

重要提示：原文中的版本 1.27.3 已过时。请访问 Docker Compose GitHub Releases 页面查看最新版本号，并将以下命令中的 v2.20.0 替换为最新版本。

# 下载 Docker Compose 二进制文件（以 v2.20.0 为例，请替换为最新版本）
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 赋予二进制文件可执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version

安装成功后，命令将输出类似 Docker Compose version v2.20.0 的信息。

安装 Ansible

Ansible 是一个强大的自动化运维工具。在 Debian 10 上，可以通过系统仓库直接安装。

sudo apt update
sudo apt install ansible -y
ansible --version

安装完成后，运行 ansible --version 可以查看安装的 Ansible 版本信息。

总结

至此，您已在 Debian 10 系统上成功安装了 Docker 容器平台、Docker Compose 编排工具以及 Ansible 自动化工具。这三者的组合为构建、部署和管理现代化应用提供了强大的基础设施。

建议后续操作：

将您的用户添加到 docker 用户组，以便无需 sudo 即可运行 Docker 命令：sudo usermod -aG docker $USER（需要重新登录生效）。
阅读 Docker 和 Ansible 的官方文档，以深入了解其功能与最佳实践。

前言