diff --git a/SUMMARY.md b/SUMMARY.md index d725988..3489ec7 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -11,9 +11,11 @@ * [容器](basic_concept/container.md) * [仓库](basic_concept/repository.md) * [安装 Docker](install/README.md) - * [Ubuntu、Debian](install/ubuntu.md) + * [Ubuntu](install/ubuntu.md) + * [Debian](install/debian.md) * [CentOS](install/centos.md) * [macOS](install/mac.md) + * [Windows PC](install/windows.md) * [镜像加速器](install/mirror.md) * [使用镜像](image/README.md) * [获取镜像](image/pull.md) @@ -148,4 +150,3 @@ * [Node.js](appendix/repo/nodejs.md) * [附录三:Docker 命令查询](appendix/command/README.md) * [附录四:资源链接](appendix/resources/README.md) - diff --git a/install/README.md b/install/README.md index dcef752..6f79057 100644 --- a/install/README.md +++ b/install/README.md @@ -1,2 +1,16 @@ # 安装 Docker -官方网站上有各种环境下的 [安装指南](https://docs.docker.com/installation/#installation),这里主要介绍下 Ubuntu、Debian 和 CentOS 系列的安装。 + +Docker 在 1.13 版本之后,从 2017 年的 3 月 1 号开始,版本命名规则变为如下: + +| 项目 | 说明 | +| -- | -- | +| 版本格式 | YY.MM | +| stable 版本 | 每个季度发行 | +| edge 版本 | 每个月发行 | +| 当前 CE 版本 | 17.07.0-ce | + +同时 Docker 划分为 CE 和 EE 。CE 版本即社区版(免费,支持周期三个月),EE 即企业版,强调安全,付费使用。 + +Docker CE 每月发布一个 edge 版本(17.03, 17.04, 17.05...),每三个月发布一个 stable 版本(17.03, 17.06, 17.09...),Docker EE 和 stable 版本号保持一致,但每个版本提供一年维护。 + +官方网站上有各种环境下的 [安装指南](https://docs.docker.com/engine/installation/),这里主要介绍 Docker CE 在 Linux 、Windows 10 (PC) 和 macOS 上的安装。 diff --git a/install/_images/install-win-docker-app-search.png b/install/_images/install-win-docker-app-search.png new file mode 100644 index 0000000..02d8afa Binary files /dev/null and b/install/_images/install-win-docker-app-search.png differ diff --git a/install/_images/install-win-success-popup-cloud.png b/install/_images/install-win-success-popup-cloud.png new file mode 100644 index 0000000..083cd76 Binary files /dev/null and b/install/_images/install-win-success-popup-cloud.png differ diff --git a/install/_images/install-win-taskbar-circle.png b/install/_images/install-win-taskbar-circle.png new file mode 100644 index 0000000..d4c6cc5 Binary files /dev/null and b/install/_images/install-win-taskbar-circle.png differ diff --git a/install/centos.md b/install/centos.md index 92bac13..b70436b 100644 --- a/install/centos.md +++ b/install/centos.md @@ -1,40 +1,24 @@ -## CentOS 操作系统安装 Docker +## CentOS 操作系统安装 Docker CE ### 系统要求 -Docker 最低支持 CentOS 7。 +Docker CE 支持 64 位版本 CentOS 7,并且要求内核版本不低于 3.10。 CentOS 7 满足最低内核的要求,但由于内核版本比较低,部分功能(如 `overlay2` 存储层驱动)无法使用,并且部分功能可能不太稳定。 -Docker 需要安装在 64 位的平台,并且内核版本不低于 3.10。 CentOS 7 满足最低内核的要求,但由于内核版本比较低,部分功能(如 `overlay2` 存储层驱动)无法使用,并且部分功能可能不太稳定。 +### 卸载旧版本 -### 使用脚本自动安装 - -Docker 官方为了简化安装流程,提供了一套安装脚本,CentOS 系统上可以使用这套脚本安装: +旧版本的 Docker 称为 `docker` 或者 `docker-engine`,使用以下命令卸载旧版本: ```bash -curl -sSL https://get.docker.com/ | sh +$ sudo yum remove docker \ + docker-common \ + docker-selinux \ + docker-engine ``` - -执行这个命令后,脚本就会自动的将一切准备工作做好,并且把 Docker 安装在系统中。 - -不过,由于伟大的墙的原因,在国内使用这个脚本可能会出现某些下载出现错误的情况。国内的一些云服务商提供了这个脚本的修改版本,使其使用国内的 Docker 软件源镜像安装,这样就避免了墙的干扰。 - -#### 阿里云的安装脚本 - -```bash -curl -sSL http://acs-public-mirror.oss-cn-hangzhou.aliyuncs.com/docker-engine/internet | sh - -``` - -#### DaoCloud 的安装脚本 - -```bash -curl -sSL https://get.daocloud.io/docker | sh -``` - -### 手动安装 +### 使用 yum 源安装 #### 添加内核参数 -默认配置下,在 CentOS 使用 Docker 可能会碰到下面的这些警告信息: +默认配置下,在 CentOS 使用 Docker CE 可能会看到下面的这些警告信息: ```bash WARNING: bridge-nf-call-iptables is disabled @@ -58,38 +42,70 @@ $ sudo sysctl -p #### 添加 yum 源 -虽然 CentOS 软件源 `Extras` 中有 Docker,名为 `docker`,但是不建议使用系统源中的这个版本,它的版本相对比较陈旧,而且并非 Docker 官方维护的版本。因此,我们需要使用 Docker 官方提供的 CentOS 软件源。 - -执行下面的命令添加 `yum` 软件源。 +执行以下命令安装依赖包: ```bash -$ sudo tee /etc/yum.repos.d/docker.repo <<-'EOF' -[dockerrepo] -name=Docker Repository -baseurl=https://yum.dockerproject.org/repo/main/centos/7/ -enabled=1 -gpgcheck=1 -gpgkey=https://yum.dockerproject.org/gpg -EOF +$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2 ``` -#### 安装 Docker +##### 国内源 -更新 `yum` 软件源缓存,并安装 `docker-engine`。 +执行下面的命令添加 `yum` 软件源: ```bash -$ sudo yum update -$ sudo yum install docker-engine +$ sudo yum-config-manager \ + --add-repo \ + https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo ``` -#### 启动 Docker 引擎 +##### 官方源 + +```bash +$ sudo yum-config-manager \ + --add-repo \ + https://download.docker.com/linux/centos/docker-ce.repo +``` + +>以上命令会添加 稳定 版本的 Docker CE APT 镜像源 。从 Docker 17.06 开始,edge test 版本的 APT 镜像源也会包含稳定版本的 Docker CE + +如果需要最新版本的 Docker CE 请使用以下命令: + +```bash +$ sudo yum-config-manager --enable docker-ce-edge +``` + +```bash +$ sudo yum-config-manager --enable docker-ce-test +``` + +#### 安装 Docker CE + +更新 `yum` 软件源缓存,并安装 `docker-ce`。 + +```bash +$ sudo yum makecache fast +$ sudo yum install docker-ce +``` + +### 使用脚本自动安装 + +在测试或开发环境中 Docker 官方为了简化安装流程,提供了一套便捷的安装脚本,CentOS 系统上可以使用这套脚本安装: + +```bash +$ curl -fsSL get.docker.com -o get-docker.sh +$ sudo sh get-docker.sh --mirror Aliyun +``` + +执行这个命令后,脚本就会自动的将一切准备工作做好,并且把 Docker CE 的 edge 版本安装在系统中。 + +### 启动 Docker CE ```bash $ sudo systemctl enable docker $ sudo systemctl start docker ``` -#### 建立 docker 用户组 +### 建立 docker 用户组 默认情况下,`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑,一般 Linux 系统上不会直接使用 `root` 用户。因此,更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。 @@ -105,6 +121,11 @@ $ sudo groupadd docker $ sudo usermod -aG docker $USER ``` +### 镜像加速 + +鉴于国内网络问题,后续拉取 Docker 镜像十分缓慢,强烈建议安装 Docker 之后配置 [国内镜像加速](/install/mirror.html)。 + ### 参考文档 -参见 [Docker 官方 CentOS 安装文档](https://docs.docker.com/engine/installation/linux/centos/)。 +* [Docker 官方 CentOS 安装文档](https://docs.docker.com/engine/installation/linux/docker-ce/centos/)。 +* [阿里云 Docker CE 安装镜像帮助](https://yq.aliyun.com/articles/110806) diff --git a/install/debian.md b/install/debian.md new file mode 100644 index 0000000..3a94b87 --- /dev/null +++ b/install/debian.md @@ -0,0 +1,169 @@ +## Debian 安装 Docker CE + +### 准备工作 + +#### 系统要求 + +Docker CE 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作系统: + +* Debian 9 Stretch +* Debian 8 Jessie +* Debian 7 Wheezy + +Docker CE 可以安装在 64 位的 x86 平台或 ARM 平台上(如[树莓派](https://www.raspberrypi.org/))。 + + +#### 卸载旧版本 + +旧版本的 Docker 称为 `docker` 或者 `docker-engine`,使用以下命令卸载旧版本: + +```bash +$ sudo apt-get remove docker docker-engine docker.io +``` + +#### Debian 7 Wheezy + +Debian 7 的内核默认为 3.2,为了满足 Docker CE 的需求,应该安装 [`backports`](https://backports.debian.org/Instructions/) 的内核。 + +### 使用 APT 源安装 + +由于官方源使用 HTTPS 以确保软件下载过程中不被篡改。因此,我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。 + +Debian 8 Jessie 或者 Debian 9 Stretch 使用以下命令: + +```bash +$ sudo apt-get update + +$ sudo apt-get install \ + apt-transport-https \ + ca-certificates \ + curl \ + gnupg2 \ + lsb-release \ + software-properties-common +``` + +Debian 7 Wheezy 使用以下命令: + +```bash +$ sudo apt-get update + +$ sudo apt-get install \ + apt-transport-https \ + ca-certificates \ + curl \ + lsb-release \ + python-software-properties + +``` + +鉴于国内网络问题,强烈建议使用国内源,下面先介绍国内源的使用。 + +#### 国内源 + +为了确认所下载软件包的合法性,需要添加软件源的 GPG 密钥。 + +```bash +$ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | sudo apt-key add - +``` + +然后,我们需要向 `source.list` 中添加 Docker CE 软件源: + +```bash +$ sudo add-apt-repository \ + "deb [arch=amd64] https://mirrors.aliyun.com/docker-ce/linux/debian \ + $(lsb_release -cs) \ + stable" +``` + +>以上命令会添加 稳定 版本的 Docker CE APT 镜像源,如果需要最新版本的 Docker CE 请将 stable 改为 edge 或者 test 。从 Docker 17.06 开始,edge test 版本的 APT 镜像源也会包含稳定版本的 Docker CE + +#### 官方源 + +```bash +$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add - + +$ sudo add-apt-repository \ + "deb [arch=amd64] https://download.docker.com/linux/debian \ + $(lsb_release -cs) \ + stable" +``` + +Debian 7 需要进行额外的操作: + +编辑 `/etc/apt/sources.list` 将 deb-src 一行删除或者使用 # 注释。 + +```bash +deb-src [arch=amd64] https://download.docker.com/linux/debian wheezy stable +``` + +#### 安装 Docker CE + +更新 apt 软件包缓存,并安装 `docker-ce`。 + +```bash +$ sudo apt-get update + +$ sudo apt-get install docker-ce +``` + +### 使用脚本自动安装 + +在测试或开发环境中 Docker 官方为了简化安装流程,提供了一套便捷的安装脚本,Debian 系统上可以使用这套脚本安装: + +```bash +$ curl -fsSL get.docker.com -o get-docker.sh +$ sudo sh get-docker.sh --mirror Aliyun +``` + +执行这个命令后,脚本就会自动的将一切准备工作做好,并且把 Docker CE 的 edge 版本安装在系统中。 + +### 树莓派安装 Docker CE + +基本和上述步骤相同,添加 apt 源时请使用如下命令: + +```bash +$ sudo add-apt-repository \ + "deb [arch=armhf] https://mirrors.aliyun.com/docker-ce/linux/debian \ + $(lsb_release -cs) \ + stable" +``` + +ARM 平台不能使用 x86 镜像,查看树莓派可使用镜像请访问 [arm32v7](https://hub.docker.com/u/arm32v7/)。 + +### 启动 Docker CE + +```bash +$ sudo systemctl enable docker +$ sudo systemctl start docker +``` +Debian 7 Wheezy 请使用以下命令启动 + +```bash +$ sudo service docker start +``` + +### 建立 docker 用户组 + +默认情况下,`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑,一般 Linux 系统上不会直接使用 `root` 用户。因此,更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。 + +建立 `docker` 组: + +```bash +$ sudo groupadd docker +``` + +将当前用户加入 `docker` 组: + +```bash +$ sudo usermod -aG docker $USER +``` + +### 镜像加速 + +鉴于国内网络问题,后续拉取 Docker 镜像十分缓慢,强烈建议安装 Docker 之后配置 [国内镜像加速](/install/mirror.html)。 + +### 参考文档 + +* [Docker 官方 Debian 安装文档](https://docs.docker.com/engine/installation/linux/docker-ce/debian/) +* [阿里云 Docker CE 安装镜像帮助](https://yq.aliyun.com/articles/110806) diff --git a/install/mac.md b/install/mac.md index 46091df..c5ce3cb 100644 --- a/install/mac.md +++ b/install/mac.md @@ -2,7 +2,9 @@ ### 系统要求 -[Docker for Mac](https://docs.docker.com/docker-for-mac/) 要求系统最低为 macOS 10.10.3 Yosemite,或者 2010 年以后的 Mac 机型,准确说是带 [Intel MMU 虚拟化](https://en.wikipedia.org/wiki/X86_virtualization#Intel-VT-d)的,最低 4GB 内存。如果系统不满足需求,可以考虑安装 [Docker Toolbox](https://docs.docker.com/toolbox/overview/)。如果机器安装了 [VirtualBox](https://www.virtualbox.org/) 的话,VirtualBox 的版本不要低于 4.3.30。 +[Docker for Mac](https://docs.docker.com/docker-for-mac/) 要求系统最低为 macOS 10.10.3 Yosemite,或者 2010 年以后的 Mac 机型,准确说是带 [Intel MMU 虚拟化](https://en.wikipedia.org/wiki/X86_virtualization#Intel-VT-d)的,最低 4GB 内存。 + +如果系统不满足需求,可以安装 [Docker Toolbox](https://docs.docker.com/toolbox/overview/)。 ### 安装 @@ -71,3 +73,7 @@ $ docker run -d -p 80:80 --name webserver nginx $ docker stop webserver $ docker rm webserver ``` + +### 参考文档 + +* [Docker 官方 macOS 安装文档](https://docs.docker.com/docker-for-mac/install/) diff --git a/install/ubuntu.md b/install/ubuntu.md index ef4baba..0b56af0 100644 --- a/install/ubuntu.md +++ b/install/ubuntu.md @@ -1,221 +1,121 @@ -## Ubuntu、Debian 系列安装 Docker +## Ubuntu 安装 Docker CE -### 系统要求 +### 准备工作 -Docker 支持以下版本的 [Ubuntu](https://www.ubuntu.com/server) 和 [Debian](https://www.debian.org/intro/about) 操作系统: +#### 系统要求 +Docker CE 支持以下版本的 [Ubuntu](https://www.ubuntu.com/server) 操作系统: + +* Zesty 17.04 * Ubuntu Xenial 16.04 (LTS) * Ubuntu Trusty 14.04 (LTS) -* Ubuntu Precise 12.04 (LTS) -* Debian testing stretch (64-bit) -* Debian 8 Jessie (64-bit) -* Debian 7 Wheezy (64-bit)(*必须启用 backports*) -Ubuntu 发行版中,LTS(Long-Term-Support)长期支持版本,会获得 5 年的升级维护支持,这样的版本会更稳定,因此在生产环境中推荐使用 LTS 版本。 -Docker 目前支持的 Ubuntu 版本最低为 12.04 LTS,但从稳定性上考虑,推荐使用 14.04 LTS 或更高的版本。 +Docker CE 可以安装在 64 位的 x86 平台或 ARM 平台上。Ubuntu 发行版中,LTS(Long-Term-Support)长期支持版本,会获得 5 年的升级维护支持,这样的版本会更稳定,因此在生产环境中推荐使用 LTS 版本。 -Docker 需要安装在 64 位的 x86 平台或 ARM 平台上(如[树莓派](https://www.raspberrypi.org/)),并且要求内核版本不低于 3.10。但实际上内核越新越好,过低的内核版本可能会出现部分功能无法使用,或者不稳定。 +#### 卸载旧版本 -用户可以通过如下命令检查自己的内核版本详细信息: +旧版本的 Docker 称为 `docker` 或者 `docker-engine`,使用以下命令卸载旧版本: ```bash -$ uname -a -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 +$ sudo apt-get remove docker docker-engine docker.io ``` -#### 升级内核 - -如果内核版本过低,可以用下面的命令升级系统内核。 - -##### Ubuntu 12.04 LTS - -```bash -sudo apt-get install -y --install-recommends linux-generic-lts-trusty -``` - -##### Ubuntu 14.04 LTS - -```bash -sudo apt-get install -y --install-recommends linux-generic-lts-xenial -``` - -##### Debian 7 Wheezy - -Debian 7 的内核默认为 3.2,为了满足 Docker 的需求,应该安装 `backports` 的内核。 - -执行下面的命令添加 `backports` 源: - -```bash -$ echo "deb http://http.debian.net/debian wheezy-backports main" | sudo tee /etc/apt/sources.list.d/backports.list -``` - -升级到 `backports` 内核: - -```bash -$ sudo apt-get update -$ sudo apt-get -t wheezy-backports install linux-image-amd64 -``` - -##### Debian 8 Jessie - -Debian 8 的内核默认为 3.16,满足基本的 Docker 运行条件。但是如果打算使用 `overlay2` 存储层驱动,或某些功能不够稳定希望升级到较新版本的内核,可以添加 `backports` 源,升级到新版本的内核。 - -执行下面的命令添加 `backports` 源: - -```bash -$ echo "deb http://http.debian.net/debian jessie-backports main" | sudo tee /etc/apt/sources.list.d/backports.list -``` - -升级到 `backports` 内核: - -```bash -$ sudo apt-get update -$ sudo apt-get -t jessie-backports install linux-image-amd64 -``` - -需要注意的是,升级到 `backports` 的内核之后,会因为 `AUFS` 内核模块不可用,而使用默认的 `devicemapper` 驱动,并且配置为 `loop-lvm`,这是不推荐的。因此,不要忘记安装 Docker 后,配置 `overlay2` 存储层驱动。 - -##### 配置 GRUB 引导参数 - -在 Docker 使用期间,或者在 `docker info` 信息中,可能会看到下面的警告信息: - -```bash -WARNING: Your kernel does not support cgroup swap limit. WARNING: Your -kernel does not support swap limit capabilities. Limitation discarded. -``` - -或者 - -```bash -WARNING: No memory limit support -WARNING: No swap limit support -WARNING: No oom kill disable support -``` - -如果需要这些功能,就需要修改 GRUB 的配置文件 ` /etc/default/grub`,在 `GRUB_CMDLINE_LINUX` 中添加内核引导参数 `cgroup_enable=memory swapaccount=1`。 - -然后不要忘记了更新 GRUB: - -```bash -$ sudo update-grub -$ sudo reboot -``` - -### 使用脚本自动安装 - -Docker 官方为了简化安装流程,提供了一套安装脚本,Ubuntu 和 Debian 系统可以使用这套脚本安装: - -```bash -curl -sSL https://get.docker.com/ | sh -``` - -执行这个命令后,脚本就会自动的将一切准备工作做好,并且把 Docker 安装在系统中。 - -不过,由于伟大的墙的原因,在国内使用这个脚本可能会出现某些下载出现错误的情况。国内的一些云服务商提供了这个脚本的修改版本,使其使用国内的 Docker 软件源镜像安装,这样就避免了墙的干扰。 - -#### 阿里云的安装脚本 - -```bash -curl -sSL http://acs-public-mirror.oss-cn-hangzhou.aliyuncs.com/docker-engine/internet | sh - -``` - -#### DaoCloud 的安装脚本 - -```bash -curl -sSL https://get.daocloud.io/docker | sh -``` - -### 手动安装 - -#### 安装所需的软件包 - -##### 可选内核模块 +#### Ubuntu 14.04 可选内核模块 从 Ubuntu 14.04 开始,一部分内核模块移到了可选内核模块包(`linux-image-extra-*`),以减少内核软件包的体积。正常安装的系统应该会包含可选内核模块包,而一些裁剪后的系统可能会将其精简掉。`AUFS` 内核驱动属于可选内核模块的一部分,作为推荐的 Docker 存储层驱动,一般建议安装可选内核模块包以使用 `AUFS`。 如果系统没有安装可选内核模块的话,可以执行下面的命令来安装可选内核模块包: ```bash -$ sudo apt-get install linux-image-extra-$(uname -r) linux-image-extra-virtual +$ sudo apt-get update + +$ sudo apt-get install \ + linux-image-extra-$(uname -r) \ + linux-image-extra-virtual ``` -##### 12.04 LTS 图形界面 - -在 Ubuntu 12.04 桌面环境下,需要一些额外的软件包,可以用下面的命令安装。 - -```bash -$ sudo apt-get install xserver-xorg-lts-trusty libgl1-mesa-glx-lts-trusty -``` - -#### 添加 APT 镜像源 - -虽然 Ubuntu 系统软件源中有 Docker,名为 `docker.io`,但是不应该使用系统源中的这个版本,它的版本太旧。我们需要使用 Docker 官方提供的软件源,因此,我们需要添加 APT 软件源。 +### 使用 APT 镜像源 安装 由于官方源使用 HTTPS 以确保软件下载过程中不被篡改。因此,我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。 -*国内的一些软件源镜像(比如[阿里云](http://mirrors.aliyun.com/docker-engine/))不是太在意系统安全上的细节,可能依旧使用不安全的 HTTP,对于这些源可以不执行这一步。* +```bash +$ sudo apt-get update + +$ sudo apt-get install \ + apt-transport-https \ + ca-certificates \ + curl \ + software-properties-common +``` + +鉴于国内网络问题,强烈建议使用国内源,下面先介绍国内源的使用。 + +#### 国内源 + +为了确认所下载软件包的合法性,需要添加软件源的 GPG 密钥。 + +```bash +$ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add - +``` + +然后,我们需要向 `source.list` 中添加 Docker 软件源 + +```bash +$ sudo add-apt-repository \ + "deb [arch=amd64] https://mirrors.aliyun.com/docker-ce/linux/ubuntu \ + $(lsb_release -cs) \ + stable" +``` + +>以上命令会添加 稳定 版本的 Docker CE APT 镜像源,如果需要最新版本的 Docker CE 请将 stable 改为 edge 或者 test 。从 Docker 17.06 开始,edge test 版本的 APT 镜像源也会包含稳定版本的 Docker + +#### 官方源 + +```bash +$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - + +$ sudo add-apt-repository \ + "deb [arch=amd64] https://download.docker.com/linux/ubuntu \ + $(lsb_release -cs) \ + stable" +``` + +#### 安装 Docker CE + +更新 apt 软件包缓存,并安装 `docker-ce`: ```bash $ sudo apt-get update -$ sudo apt-get install apt-transport-https ca-certificates + +$ sudo apt-get install docker-ce ``` -为了确认所下载软件包的合法性,需要添加 Docker 官方软件源的 GPG 密钥。 +### 使用脚本自动安装 + +在测试或开发环境中 Docker 官方为了简化安装流程,提供了一套便捷的安装脚本,Ubuntu 系统上可以使用这套脚本安装: ```bash -$ sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D +$ curl -fsSL get.docker.com -o get-docker.sh +$ sudo sh get-docker.sh --mirror Aliyun ``` -然后,我们需要向 `source.list` 中添加 Docker 软件源,下表列出了不同的 Ubuntu 和 Debian 版本对应的 APT 源。 +执行这个命令后,脚本就会自动的将一切准备工作做好,并且把 Docker 安装在系统中。 -| 操作系统版本 | 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` | -| 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`(将其中的 `` 替换为上表的值): - -```bash -$ echo "" | sudo tee /etc/apt/sources.list.d/docker.list -``` - -添加成功后,更新 apt 软件包缓存。 - -```bash -$ sudo apt-get update -``` - -#### 安装 Docker - -在一切准备就绪后,就可以安装最新版本的 Docker 了,软件包名称为 `docker-engine`。 - -```bash -$ sudo apt-get install docker-engine -``` - -如果系统中存在旧版本的 Docker (`lxc-docker`, `docker.io`),会提示是否先删除,选择是即可。 - -#### 启动 Docker 引擎 - -##### Ubuntu 12.04/14.04、Debian 7 Wheezy - -```bash -$ sudo service docker start -``` - -##### Ubuntu 16.04、Debian 8 Jessie/Stretch +### 启动 Docker CE ```bash $ sudo systemctl enable docker $ sudo systemctl start docker ``` -#### 建立 docker 用户组 +Ubuntu 14.04 请使用以下命令启动: + +```bash +$ sudo service docker start +``` + +### 建立 docker 用户组 默认情况下,`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑,一般 Linux 系统上不会直接使用 `root` 用户。因此,更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。 @@ -231,7 +131,11 @@ $ sudo groupadd docker $ sudo usermod -aG docker $USER ``` +### 镜像加速 + +鉴于国内网络问题,后续拉取 Docker 镜像十分缓慢,强烈建议安装 Docker 之后配置 [国内镜像加速](/install/mirror.html)。 + ### 参考文档 -* [Docker 官方 Ubuntu 安装文档](https://docs.docker.com/engine/installation/linux/ubuntulinux/) -* [Docker 官方 Debian 安装文档](https://docs.docker.com/engine/installation/linux/debian/) +* [Docker 官方 Ubuntu 安装文档](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/) +* [阿里云 Docker CE 安装镜像帮助](https://yq.aliyun.com/articles/110806) diff --git a/install/windows.md b/install/windows.md new file mode 100644 index 0000000..a2a7cb4 --- /dev/null +++ b/install/windows.md @@ -0,0 +1,33 @@ +## Windows 10 PC 安装 Docker CE + +### 系统要求 + +Docker CE 支持 64 位版本的 Windows 10 Pro ,且必须开启 Hyper-V。 + +### 安装 + +点击以下链接下载 [stable](https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe) 或 [edge](https://download.docker.com/win/edge/Docker%20for%20Windows%20Installer.exe) 版本的 Docker CE。 + +下载好之后双击 Docker for Windows Installer.exe 开始安装。 + +### 运行 + +在 Windows 搜索栏 输入 Docker 点击 Docker for Windows 开始运行。 + +![](_images/install-win-docker-app-search.png) + +Docker CE 启动之后会在 Windows 任务栏出现鲸鱼图标。 + +![](_images/install-win-taskbar-circle.png) + +等待片刻,点击 Got it 开始使用 Docker CE。 + +![](_images/install-win-success-popup-cloud.png) + +### 镜像加速 + +鉴于国内网络问题,后续拉取 Docker 镜像十分缓慢,强烈建议安装 Docker 之后配置 [国内镜像加速](/install/mirror.html)。 + +### 参考文档 + +* [Docker 官方 Windows PC 安装文档](https://docs.docker.com/docker-for-windows/install/)