diff --git a/install/debian.md b/install/debian.md index 4bb1a1c..b6822eb 100644 --- a/install/debian.md +++ b/install/debian.md @@ -1,114 +1,185 @@ -# Debian操作系统安装Docker +## Debian操作系统安装Docker -## 支持的版本 +### 系统要求 -- Debian testing stretch (64-bit) -- Debian 8.0 Jessie (64-bit) -- Debian 7.7 Wheezy (64-bit) +Docker 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作系统： -## 预安装 +* Debian testing stretch (64-bit) +* Debian 8 Jessie (64-bit) +* Debian 7 Wheezy (64-bit)（*必须启用 backports*) -Docker 支持 64 位、内核高于 3.10 的 Debian 操作系统，内核低于 3.10 将导致数据丢失和系统不稳定等问题。 -查看内核版本使用以下命令： +Docker 需要安装在 64 位的 x86 平台或 ARM 平台上（如[树莓派](https://www.raspberrypi.org/)），并且要求内核版本不低于 3.10。但实际上内核越新越好，过低的内核版本可能会出现部分功能无法使用，或者不稳定。 -``` -$ uname -r -``` - -### 更新APT仓库 - -Docker 的 APT 仓库包含了 1.7.1 及以上版本的 Docker，安装前需要更新 APT 设置，来使用新的仓库： - -#### 1. 清理旧的仓库信息 +用户可以通过如下命令检查自己的内核版本详细信息： ```sh - $ apt-get purge lxc-docker* - $ apt-get purge docker.io* +$ uname -a +Linux debian-512mb-nyc3-01 3.16.0-0.bpo.4-amd64 #1 SMP Debian 3.16.36-1+deb8u2~bpo70+1 (2016-10-19) x86_64 GNU/Linux ``` -#### 2. 更新和安装软件包 +#### 升级内核 + +##### Debian 7 Wheezy + +Debian 7 的内核默认为 3.2，为了满足 Docker 的需求，应该安装 `backports` 的内核。 + +执行下面的命令添加 `backports` 源： ```sh - $ apt-get update - $ apt-get install apt-transport-https ca-certificates +$ echo "deb http://http.debian.net/debian wheezy-backports main" | sudo tee /etc/apt/sources.list.d/backports.list ``` -#### 3. 添加 GPG 键 - -``` - $ apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D -``` - -#### 4. 添加 APT 源 - -编辑文件 `/etc/apt/sources.list.d/docker.list`，清理已存在的信息，写入APT源地址内容。以下以 Debian Jessie 为例，非 Jessie 版本的系统注意修改为自己对应的代号。 +升级到 `backports` 内核： ```sh -$ sudo cat < /etc/apt/sources.list.d/docker.list -deb https://apt.dockerproject.org/repo debian-jessie main -EOF +$ sudo apt-get update +$ sudo apt-get -t wheezy-backports install linux-image-amd64 ``` -其他两个版本内容： +##### Debian 8 Jessie -``` -deb https://apt.dockerproject.org/repo debian-wheezy main +Debian 8 的内核默认为 3.16，满足基本的 Docker 运行条件。但是如果打算使用 `overlay2` 存储层驱动，或某些功能不够稳定希望升级到较新版本的内核，可以添加 `backports` 源，升级到新版本的内核。 + +执行下面的命令添加 `backports` 源： + +```sh +$ echo "deb http://http.debian.net/debian jessie-backports main" | sudo tee /etc/apt/sources.list.d/backports.list ``` -``` -deb https://apt.dockerproject.org/repo debian-stretch main +升级到 `backports` 内核： + +```sh +$ sudo apt-get update +$ sudo apt-get -t jessie-backports install linux-image-amd64 ``` -#### 5. 校验安装结果 +需要注意的是，升级到 `backports` 的内核之后，会因为 `AUFS` 内核模块不可用，而使用默认的 `devicemapper` 驱动，并且配置为 `loop-lvm`，这是不推荐的。因此，不要忘记安装 Docker 后，配置 `overlay2` 存储层驱动。 -``` - $ apt-cache policy docker-engine -docker-engine: - Installed: 1.11.0-0~jessie - Candidate: 1.11.0-0~jessie - Version table: - *** 1.11.0-0~jessie 0 - 500 https://apt.dockerproject.org/repo/ debian-jessie/main amd64 Packages - 100 /var/lib/dpkg/status - ..... +##### 配置 GRUB 引导参数 + +在 Docker 使用期间，或者在 `docker info` 信息中，可能会看到下面的警告信息： + +```sh +WARNING: No memory limit support +WARNING: No swap limit support +WARNING: No oom kill disable support ``` -以后，当执行 `apt-get upgrade` 等命令时，将使用新设置的的 APT 源。 +如果需要这些功能，就需要修改 GRUB 的配置文件 ` /etc/default/grub`，在 `GRUB_CMDLINE_LINUX` 中添加内核引导参数 `cgroup_enable=memory swapaccount=1`。 -## 安装 Docker +然后不要忘记了更新 GRUB，并重启： +```sh +$ sudo update-grub +$ sudo reboot ``` + +### 使用脚本自动安装 + +Docker 官方为了简化安装流程，提供了一套安装脚本，Debian 系统上可以使用这套脚本安装： + +```sh +curl -sSL https://get.docker.com/ | sh +``` + +执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker 安装在系统中。 + +不过，由于伟大的墙的原因，在国内使用这个脚本可能会出现某些下载出现错误的情况。国内的一些云服务商提供了这个脚本的修改版本，使其使用国内的 Docker 软件源镜像安装，这样就避免了墙的干扰。 + +#### 阿里云的安装脚本 + +```sh +curl -sSL http://acs-public-mirror.oss-cn-hangzhou.aliyuncs.com/docker-engine/internet | sh - +``` + +#### DaoCloud 的安装脚本 + +```sh +curl -sSL https://get.daocloud.io/docker | sh +``` + +### 手动安装 + +#### 添加 APT 镜像源 + +由于官方源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。 + +*国内的一些软件源镜像（比如[阿里云](http://mirrors.aliyun.com/docker-engine/)）不是太在意系统安全上的细节，可能依旧使用不安全的 HTTP，对于这些源可以不执行这一步。* + +```sh +$ sudo apt-get update +$ sudo apt-get install apt-transport-https ca-certificates +``` + +为了确认所下载软件包的合法性，需要添加 Docker 官方软件源的 GPG 密钥。 + +```sh +$ sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D +``` + +然后，我们需要向 `source.list` 中添加 Docker 软件源，下表列出了不同的 Debian 版本对应的 APT 源。 + +| Debian 版本 | REPO | +|---------------------|--------------------------------------------------------------| +| Debian 7 Wheezy | `deb https://apt.dockerproject.org/repo debian-wheezy main` | +| Debian 8 Jessie | `deb https://apt.dockerproject.org/repo debian-jessie main` | +| Debian Stretch/Sid | `deb https://apt.dockerproject.org/repo debian-stretch main` | + +用下面的命令将 APT 源添加到 `source.list`（将其中的 `` 替换为上表的值）： + +```sh +$ echo "" | sudo tee /etc/apt/sources.list.d/docker.list +``` + +添加成功后，更新 apt 软件包缓存。 + +```sh +$ sudo apt-get update +``` + +#### 安装 Docker + +在一切准备就绪后，就可以安装最新版本的 Docker 了，软件包名称为 `docker-engine`。 + +```sh $ sudo apt-get install docker-engine ``` -## 为非 root 用户授权 +如果系统中存在旧版本的 Docker （`lxc-docker`, `docker.io`），会提示是否先删除，选择是即可。 -``` -# 如果没有就建立一个 Docker 组 -$ sudo groupadd docker +#### 启动 Docker 引擎 -# 增加一个用户（用真实的名字替换下面的 ${USER}）到 Docker 组，需重登陆来生效 -$ sudo gpasswd -a ${USER} docker - -# 重启 Docker 服务 -$ sudo service docker restart -``` - -## 更新 Docker - -``` -$ apt-get upgrade docker-engine -``` - -## 卸载 Docker +##### Debian 7 Wheezy ```sh -# 卸载软件包 -$ sudo apt-get purge docker-engine - -#卸载依赖包 -$ sudo apt-get autoremove --purge docker-engine - -#如有必要，执行以下命令，删除全部镜像、容器、数据卷和其他docker相关用户信息: -$ rm -rf /var/lib/docker +$ sudo service docker start ``` + +##### Debian 8 Jessie/Stretch + +```sh +$ sudo systemctl enable docker +$ sudo systemctl start docker +``` + +#### 建立 docker 用户组 + +默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。 + +建立 `docker` 组： + +```sh +$ sudo groupadd docker +``` + +将当前用户加入 `docker` 组： + +```sh +$ sudo usermod -aG docker $USER +``` + + + +### 参考文档 + +参见 [Docker 官方 Debian 安装文档](https://docs.docker.com/engine/installation/linux/debian/)。 diff --git a/install/ubuntu.md b/install/ubuntu.md index f523152..f187dce 100644 --- a/install/ubuntu.md +++ b/install/ubuntu.md @@ -50,6 +50,24 @@ sudo apt-get install -y --install-recommends linux-generic-lts-xenial sudo reboot ``` +##### 配置 GRUB 引导参数 + +在 Docker 使用期间，或者在 `docker info` 信息中，可能会看到下面的警告信息： + +```sh +WARNING: Your kernel does not support cgroup swap limit. WARNING: Your +kernel does not support swap limit capabilities. Limitation discarded. +``` + +如果需要这些功能，就需要修改 GRUB 的配置文件 ` /etc/default/grub`，在 `GRUB_CMDLINE_LINUX` 中添加内核引导参数 `cgroup_enable=memory swapaccount=1`。 + +然后不要忘记了更新 GRUB： + +```sh +$ sudo update-grub +$ sudo reboot +``` + ### 使用脚本自动安装 Docker 官方为了简化安装流程，提供了一套安装脚本，Ubuntu 系统上可以使用这套脚本安装： @@ -100,7 +118,7 @@ $ sudo apt-get install xserver-xorg-lts-trusty libgl1-mesa-glx-lts-trusty 虽然 Ubuntu 系统软件源中有 Docker，名为 `docker.io`，但是不应该使用系统源中的这个版本，它的版本太旧。我们需要使用 Docker 官方提供的软件源，因此，我们需要添加 APT 软件源。 -首先，我们需要确保 APT 使用 HTTPS，以及 CA 证书更新到最新。官方源使用的是 HTTPS，从而确保软件下载过程中不被篡改。 +由于官方源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。 *国内的一些软件源镜像（比如[阿里云](http://mirrors.aliyun.com/docker-engine/)）不是太在意系统安全上的细节，可能依旧使用不安全的 HTTP，对于这些源可以不执行这一步。* @@ -143,7 +161,7 @@ $ sudo apt-get update $ sudo apt-get install docker-engine ``` -如果系统中存在旧版本的 Docker （`lxc-docker`），会提示是否先删除，选择是即可。 +如果系统中存在旧版本的 Docker （`lxc-docker`, `docker.io`），会提示是否先删除，选择是即可。 #### 启动 Docker 引擎 @@ -176,27 +194,6 @@ $ sudo groupadd docker $ sudo usermod -aG docker $USER ``` -#### 配置 GRUB 引导参数 - -在 Docker 使用期间，或者在 `docker info` 信息中，可能会看到下面的警告信息： - -```sh -WARNING: Your kernel does not support cgroup swap limit. WARNING: Your -kernel does not support swap limit capabilities. Limitation discarded. -``` - -如警告信息所说，这些内核功能没有启用，因此如果需要使用这些功能，需要启用这些功能。因此需要修改 GRUB 的配置文件 ` /etc/default/grub`，添加下面这个配置： - -```sh -GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1" -``` - -然后不要忘记了更新 GRUB - -```sh -$ sudo update-grub -``` - ### 参考文档 -参见 [Docker官方配置文档](https://docs.docker.com/engine/installation/linux/ubuntulinux/)。 +参见 [Docker 官方 Ubuntu 安装文档](https://docs.docker.com/engine/installation/linux/ubuntulinux/)。