From 6274d552d624e38a39d751bbc67042b879fb448f Mon Sep 17 00:00:00 2001
From: yeasy <yangbaohua@gmail.com>
Date: Thu, 4 Feb 2016 14:29:05 +0800
Subject: [PATCH] Update the ubuntu os installation

---
 install/ubuntu.md | 95 +++++++++++++++++++++++++++++++++--------------
 1 file changed, 68 insertions(+), 27 deletions(-)

diff --git a/install/ubuntu.md b/install/ubuntu.md
index cb473b9..7757726 100644
--- a/install/ubuntu.md
+++ b/install/ubuntu.md
@@ -1,36 +1,77 @@
 ## Ubuntu 系列安装 Docker
 
-### 通过系统自带包安装
-Ubuntu 14.04 版本系统中已经自带了 Docker 包，可以直接安装。
+### 系统要求
+
+Docker 目前只能按照在 64 位平台上，并且要求内核版本不低于 3.10，实际上内核越新越好，过低的内核版本容易造成功能的不稳定。
+
+用户可以通过如下命令检查自己的内核版本详细信。
+
+```sh
+$ 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
 ```
+或者
+```sh
+$ 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
+```
+
+Docker 目前支持的最低 Ubuntu 版本为 12.04 LTS，但实际上从稳定性上考虑，推荐至少使用 14.04 LTS 版本。
+
+如果使用 12.04 LTS 版本，首先要更新系统内核和安装可能需要的软件包，包括 
+
+* linux-image-generic-lts-trusty （必备）
+* linux-headers-generic-lts-trusty （必备）
+* xserver-xorg-lts-trusty  （带图形界面时必备）
+* libgl1-mesa-glx-lts-trusty（带图形界面时必备）
+
+
+另外，为了让 Docker 使用 aufs 存储，推荐安装 `linux-image-extra` 软件包。
+
+```
+$ sudo apt-get install -y linux-image-extra-$(uname -r)
+```
+
+*注：Ubuntu 发行版中，LTS （Long-Term-Support）意味着更稳定的功能和更长期（目前为 5 年）的升级支持，生产环境中尽量使用 LTS 版本。*
+
+### 添加镜像源
+
+首先需要安装 apt-transport-https 包支持 https 协议的源。
+```
+$ sudo apt-get install -y apt-transport-https
+```
+
+添加源的 gpg 密钥。
+```sh
+$ sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
+```
+
+获取当前操作系统的代号。
+```sh
+$ lsb_release -c
+Codename:       trusty
+```
+
+一般的，12.04 (LTS) 代号为 precise，14.04 (LTS) 代号为 trusty，15.04 代号为 vivid，15.10 代号为 wily。这里获取到代号为 trusty。
+
+接下来就可以添加 Docker 的官方 apt 软件源了。通过下面命令创建 `/etc/apt/sources.list.d/docker.list` 文件，并写入源的地址内容。非 trusty 版本的系统注意修改为自己对应的代号。
+
+```sh
+$ sudo cat <<EOF > /etc/apt/sources.list.d/docker.list
+deb https://apt.dockerproject.org/repo ubuntu-trusty main
+EOF
+```
+
+添加成功后，更新 apt 软件包缓存。
+```sh
 $ sudo apt-get update
-$ sudo apt-get install -y docker.io
-$ sudo ln -sf /usr/bin/docker.io /usr/local/bin/docker
-$ sudo sed -i '$acomplete -F _docker docker' /etc/bash_completion.d/docker.io
 ```
 
-如果使用操作系统自带包安装 Docker，目前安装的版本是比较旧的 0.9.1。 要安装更新的版本，可以通过使用 Docker 源的方式。
+### 安装 Docker
+在成功添加源之后，就可以安装最新版本的 Docker 了，软件包名称为 docker-engine。
 
-### 通过Docker源安装最新版本
-要安装最新的 Docker 版本，首先需要安装 apt-transport-https 支持，之后通过添加源来安装。
-```
-$ sudo apt-get install apt-transport-https
-$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9
-$ sudo bash -c "echo deb https://get.docker.io/ubuntu docker main > /etc/apt/sources.list.d/docker.list"
-$ sudo apt-get update
-$ sudo apt-get install lxc-docker
+```sh
+$ sudo apt-get install -y docker-engine
 ```
 
-### 14.04 之前版本
-如果是较低版本的 Ubuntu 系统，需要先更新内核。
-```
-$ sudo apt-get update
-$ sudo apt-get install linux-image-generic-lts-raring linux-headers-generic-lts-raring
-$ sudo reboot
-```
-然后重复上面的步骤即可。
-
-安装之后启动 Docker 服务。
-```
-$ sudo service docker start
-```
+如果系统中存在旧版本的 Docker （lxc-docker），会提示是否先删除，选择是即可。