改进 Ubuntu 安装文档
去除 Ubuntu 15.10 的信息，Ubuntu 15.10 的软件生存周期已经结束； 用表格替代命令获取Ubuntu codename 的方式； 以及扩展更多的信息。pull/112/head
Tao Wang
parent
c4028b0016
commit
442f829ef5
|
|
@ -2,108 +2,201 @@
|
||||||
|
|
||||||
### 系统要求
|
### 系统要求
|
||||||
|
|
||||||
Docker 支持以下版本的Ubuntu操作系统：
|
Docker 支持以下版本的 Ubuntu 操作系统：
|
||||||
|
|
||||||
* Ubuntu Xenial 16.04 (LTS)
|
* Ubuntu Xenial 16.04 (LTS)
|
||||||
* Ubuntu Wily 15.10
|
|
||||||
* Ubuntu Trusty 14.04 (LTS)
|
* Ubuntu Trusty 14.04 (LTS)
|
||||||
* Ubuntu Precise 12.04 (LTS)
|
* Ubuntu Precise 12.04 (LTS)
|
||||||
|
|
||||||
### 预安装
|
*注：Ubuntu 发行版中，LTS（Long-Term-Support）长期支持版本，会获得 5 年的升级维护支持，这样的版本会更稳定，因此在生产环境中推荐使用 LTS 版本。*
|
||||||
Docker 目前只能安装在 64 位平台上，并且要求内核版本不低于 3.10，实际上内核越新越好，过低的内核版本容易造成功能的不稳定。
|
|
||||||
|
|
||||||
用户可以通过如下命令检查自己的内核版本详细信。
|
Docker 目前支持的 Ubuntu 版本最低为 12.04 LTS，但从稳定性上考虑，推荐使用 14.04 LTS 或更高的版本。
|
||||||
|
|
||||||
|
Docker 需要安装在 64 位的 x86 平台或 ARM 平台上（如[树莓派](https://www.raspberrypi.org/)），并且要求内核版本不低于 3.10。但实际上内核越新越好，过低的内核版本可能会出现部分功能无法使用，或者不稳定。
|
||||||
|
|
||||||
|
用户可以通过如下命令检查自己的内核版本详细信息：
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ uname -a
|
$ uname -a
|
||||||
Linux Host 3.16.0-43-generic #58~14.04.1-Ubuntu SMP Mon Jun 22 10:21:20 UTC 2015 x86_64 x86_64 x86_64 GNU/Linux
|
Linux device 4.4.0-45-generic #66~14.04.1-Ubuntu SMP Wed Oct 19 15:05:38 UTC 2016 x86_64 x86_64 x86_64 GNU/Linux
|
||||||
```
|
```
|
||||||
|
|
||||||
或者
|
或者
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ cat /proc/version
|
$ cat /proc/version
|
||||||
Linux version 3.16.0-43-generic (buildd@brownie) (gcc version 4.8.2 (Ubuntu 4.8.2-19ubuntu1) ) #58~14.04.1-Ubuntu SMP Mon Jun 22 10:21:20 UTC 2015
|
Linux version 4.4.0-45-generic (buildd@lcy01-08) (gcc version 4.8.4 (Ubuntu 4.8.4-2ubuntu1~14.04.3) ) #66~14.04.1-Ubuntu SMP Wed Oct 19 15:05:38 UTC 2016
|
||||||
```
|
```
|
||||||
|
|
||||||
Docker 目前支持的最低 Ubuntu 版本为 12.04 LTS，但实际上从稳定性上考虑，推荐至少使用 14.04 LTS 版本。
|
#### 升级内核
|
||||||
|
|
||||||
#### 更新APT镜像源
|
如果内核版本过低，可以用下面的命令升级系统内核。
|
||||||
|
|
||||||
首先需要安装 apt-transport-https 包支持 https 协议的源。
|
##### Ubuntu 12.04 LTS
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo apt-get install -y --install-recommends linux-generic-lts-trusty
|
||||||
```
|
```
|
||||||
|
|
||||||
|
##### Ubuntu 14.04 LTS
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo apt-get install -y --install-recommends linux-generic-lts-xenial
|
||||||
|
```
|
||||||
|
|
||||||
|
升级完内核后不要忘记了重启以生效。
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo reboot
|
||||||
|
```
|
||||||
|
|
||||||
|
### 使用脚本自动安装
|
||||||
|
|
||||||
|
Docker 官方为了简化安装流程，提供了一套安装脚本，Ubuntu 系统上可以使用这套脚本安装：
|
||||||
|
|
||||||
|
```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
|
||||||
|
```
|
||||||
|
|
||||||
|
### 手动安装
|
||||||
|
|
||||||
|
#### 安装所需的软件包
|
||||||
|
|
||||||
|
##### 可选内核模块
|
||||||
|
|
||||||
|
从 Ubuntu 14.04 开始，一部分内核模块移到了可选内核模块包(`linux-image-extra-*`)，以减少内核软件包的体积。正常安装的系统应该会包含可选内核模块包，而一些裁剪后的系统可能会将其精简掉。`AUFS` 内核驱动属于可选内核模块的一部分，作为推荐的 Docker 存储层驱动，一般建议安装可选内核模块包以使用 `AUFS`。
|
||||||
|
|
||||||
|
如果系统没有安装可选内核模块的话，可以执行下面的命令来安装可选内核模块包：
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ sudo apt-get install linux-image-extra-$(uname -r) linux-image-extra-virtual
|
||||||
|
```
|
||||||
|
|
||||||
|
##### 12.04 LTS 图形界面
|
||||||
|
|
||||||
|
在 Ubuntu 12.04 桌面环境下，需要一些额外的软件包，可以用下面的命令安装。
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ sudo apt-get install xserver-xorg-lts-trusty libgl1-mesa-glx-lts-trusty
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 添加 APT 镜像源
|
||||||
|
|
||||||
|
虽然 Ubuntu 系统软件源中有 Docker，名为 `docker.io`，但是不应该使用系统源中的这个版本，它的版本太旧。我们需要使用 Docker 官方提供的软件源，因此，我们需要添加 APT 软件源。
|
||||||
|
|
||||||
|
首先，我们需要确保 APT 使用 HTTPS，以及 CA 证书更新到最新。官方源使用的是 HTTPS，从而确保软件下载过程中不被篡改。
|
||||||
|
|
||||||
|
*国内的一些软件源镜像（比如[阿里云](http://mirrors.aliyun.com/docker-engine/)）不是太在意系统安全上的细节，可能依旧使用不安全的 HTTP，对于这些源可以不执行这一步。*
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ sudo apt-get update
|
||||||
$ sudo apt-get install apt-transport-https ca-certificates
|
$ sudo apt-get install apt-transport-https ca-certificates
|
||||||
```
|
```
|
||||||
|
|
||||||
添加源的 gpg 密钥。
|
为了确认所下载软件包的合法性，需要添加 Docker 官方软件源的 GPG 密钥。
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
|
$ sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
|
||||||
```
|
```
|
||||||
|
|
||||||
获取当前操作系统的代号。
|
然后，我们需要向 `source.list` 中添加 Docker 软件源，下表列出了不同的 Ubuntu 版本对应的 APT 源。
|
||||||
```sh
|
|
||||||
$ lsb_release -c
|
|
||||||
Codename: trusty
|
|
||||||
```
|
|
||||||
|
|
||||||
一般的，12.04 (LTS) 代号为 precise，14.04 (LTS) 代号为 trusty，15.04 代号为 vivid，15.10 代号为 wily，16.04 代号为Xenial 。这里获取到代号为 trusty。
|
| Ubuntu 版本 | REPO |
|
||||||
|
|---------------------|--------------------------------------------------------------|
|
||||||
|
| Precise 12.04 (LTS) | `deb https://apt.dockerproject.org/repo ubuntu-precise main` |
|
||||||
|
| Trusty 14.04 (LTS) | `deb https://apt.dockerproject.org/repo ubuntu-trusty main` |
|
||||||
|
| Xenial 16.04 (LTS) | `deb https://apt.dockerproject.org/repo ubuntu-xenial main` |
|
||||||
|
|
||||||
接下来就可以添加 Docker 的官方 apt 软件源了。通过下面命令创建 `/etc/apt/sources.list.d/docker.list` 文件，并写入源的地址内容。非 trusty 版本的系统注意修改为自己对应的代号。
|
用下面的命令将 APT 源添加到 `source.list`（将其中的 `<REPO>` 替换为上表的值）：
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ sudo cat <<EOF > /etc/apt/sources.list.d/docker.list
|
$ echo "<REPO>" | sudo tee /etc/apt/sources.list.d/docker.list
|
||||||
deb https://apt.dockerproject.org/repo ubuntu-trusty main
|
|
||||||
EOF
|
|
||||||
```
|
```
|
||||||
|
|
||||||
添加成功后，更新 apt 软件包缓存。
|
添加成功后，更新 apt 软件包缓存。
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ sudo apt-get update
|
$ sudo apt-get update
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### 安装 Docker
|
||||||
|
|
||||||
#### 分版本的预安装任务
|
在一切准备就绪后，就可以安装最新版本的 Docker 了，软件包名称为 `docker-engine`。
|
||||||
|
|
||||||
##### 高于 12.04 LTS的版本
|
|
||||||
|
|
||||||
- Ubuntu Xenial 16.04 (LTS)
|
|
||||||
- Ubuntu Wily 15.10
|
|
||||||
- Ubuntu Trusty 14.04 (LTS)
|
|
||||||
|
|
||||||
|
|
||||||
1. 为了让 Docker 使用 aufs 存储，推荐安装 `linux-image-extra` 软件包。
|
|
||||||
```
|
|
||||||
$ sudo apt-get install -y linux-image-extra-$(uname -r)
|
|
||||||
```
|
|
||||||
2. 在 Ubuntu 14.04 或者 12.04上安装Docker，需要安装`apparmor`（apparmor是Linux内核的一个安全模块，新版本的Ubuntu已经被整合到内核）:
|
|
||||||
```
|
|
||||||
$ sudo apt-get install apparmor
|
|
||||||
```
|
|
||||||
|
|
||||||
##### 12.04 LTS版本
|
|
||||||
如果使用 12.04 LTS 版本，首先要更新系统内核和安装可能需要的软件包，包括
|
|
||||||
|
|
||||||
* linux-image-generic-lts-trusty （必备）
|
|
||||||
* linux-headers-generic-lts-trusty （必备）
|
|
||||||
* xserver-xorg-lts-trusty （带图形界面时必备）
|
|
||||||
* libgl1-mesa-glx-lts-trusty（带图形界面时必备）
|
|
||||||
|
|
||||||
安装命令(根据环境和要求不同，选择安装上述软件包)，如：
|
|
||||||
```
|
|
||||||
$ sudo apt-get install linux-image-generic-lts-trusty
|
|
||||||
```
|
|
||||||
|
|
||||||
当然，12.04 LTS 还要根据需要安装`linux-image-extra` 和 `apparmor` 软件包。
|
|
||||||
|
|
||||||
*注：Ubuntu 发行版中，LTS （Long-Term-Support）意味着更稳定的功能和更长期（目前为 5 年）的升级支持，生产环境中尽量使用 LTS 版本。*
|
|
||||||
|
|
||||||
|
|
||||||
### 安装 Docker
|
|
||||||
在成功添加源之后，就可以安装最新版本的 Docker 了，软件包名称为 docker-engine。
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ sudo apt-get install -y docker-engine
|
$ sudo apt-get install docker-engine
|
||||||
```
|
```
|
||||||
|
|
||||||
如果系统中存在旧版本的 Docker （lxc-docker），会提示是否先删除，选择是即可。
|
如果系统中存在旧版本的 Docker （`lxc-docker`），会提示是否先删除，选择是即可。
|
||||||
|
|
||||||
### 其他可选配置
|
#### 启动 Docker 引擎
|
||||||
参见 [docker官方配置文档。](https://docs.docker.com/engine/installation/linux/ubuntulinux/)
|
|
||||||
|
##### Ubuntu 12.04/14.04
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ sudo service docker start
|
||||||
|
```
|
||||||
|
|
||||||
|
##### Ubuntu 16.04
|
||||||
|
|
||||||
|
```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
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 配置 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/)。
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue