yeasy
/
docker_practice
mirror of https://github.com/yeasy/docker_practice.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #470 from Bill0412/english 

Translate the install chapter to English
pull/475/head
Kang Huaishuai 2020-10-26 17:09:50 +08:00 committed by GitHub
parent 3b0f3c0cb2 41633ecf24
commit 2ae8979c5c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
9 changed files with 199 additions and 200 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
install/README.md
View File

@ -1,7 +1,7 @@
# 安装 Docker # Docker Installation
Docker 分为 CE 和 EE 两大版本。CE 即社区版（免费，支持周期 7 个月），EE 即企业版，强调安全，付费使用，支持周期 24 个月。 Docker has 2 major editions, CE and EE. CE is the Community Edition(free, 7 month as a support cycle), while EE is the Enterprise Edition, which emphasizes on security, paid membership, and the support cycle is 24 months.
Docker CE 分为 **stable**, **test**, 和 **nightly** 三个更新频道。每六个月发布一个 **stable** 版本 (18.09, 19.03, 19.09...)。 Docker CE has 3 update channels, **stable**, **test** and **nightly**, and releases a **stable** version every other 6 months(18.09, 19.03, 19.09...).
官方网站上有各种环境下的 [安装指南](https://docs.docker.com/engine/installation/)，这里主要介绍 Docker CE 在 Linux 、Windows 10 (PC) 和 macOS 上的安装。 You can find the [Installation Guidance](https://docs.docker.com/engine/installation/) at the official website. We mainly introduce Docker CE installation on Linux, Windows 10(PC) and macOS here.

72
install/centos.md
View File

@ -1,16 +1,15 @@
## CentOS 安装 Docker CE ## Install Docker CE on CentOS
>警告：切勿在没有配置 Docker YUM 源的情况下直接使用 yum 命令安装 Docker. > WARNING: DO NOT install Docker with yum directly without configuring yum source.
### 准备工作 ### Prerequisites
#### 系统要求 #### OS Requirement
Docker CE supports 64-bit version of CentOS 7, and it requires the kernel version to be no older than 3.10. CentOS 7 satisfies the minimum kernel version requirement. But due to the comparatively old kernel, some of the functionalities like `overlay2` are unable to be used, and some other features may be unstable.
Docker CE 支持 64 位版本 CentOS 7，并且要求内核版本不低于 3.10。 CentOS 7 满足最低内核的要求，但由于内核版本比较低，部分功能（如 `overlay2` 存储层驱动）无法使用，并且部分功能可能不太稳定。 #### Uninstall the Old Versions
#### 卸载旧版本 The old versions of Docker are called `docker` or `docker-engine`, you can have them uninstalled with the following command:
旧版本的 Docker 称为 `docker` 或者 `docker-engine`，使用以下命令卸载旧版本：
```bash ```bash
$ sudo yum remove docker \ $ sudo yum remove docker \
@ -25,9 +24,9 @@ $ sudo yum remove docker \
docker-engine docker-engine
``` ```
### 使用 yum 安装 ### Install with yum
执行以下命令安装依赖包： Use the following commands to install the dependencies:
```bash ```bash
$ sudo yum install -y yum-utils \ $ sudo yum install -y yum-utils \
@ -35,80 +34,79 @@ $ sudo yum install -y yum-utils \
lvm2 lvm2
``` ```
鉴于国内网络问题，强烈建议使用国内源，官方源请在注释中查看。 Due to the network issues in China mainland, it is highly recommended for Chinese users to use Chinese sources. Please refer to the official sources in the comments(they are replaced by a Chinese source).
执行下面的命令添加 `yum` 软件源：
Use the following command to add `dnf` source.
```bash ```bash
$ sudo yum-config-manager \ $ sudo yum-config-manager \
--add-repo \ --add-repo \
https://mirrors.ustc.edu.cn/docker-ce/linux/centos/docker-ce.repo https://mirrors.ustc.edu.cn/docker-ce/linux/centos/docker-ce.repo
# 官方源 # Official source
# $ sudo yum-config-manager \ # $ sudo yum-config-manager \
# --add-repo \ # --add-repo \
# https://download.docker.com/linux/centos/docker-ce.repo # https://download.docker.com/linux/centos/docker-ce.repo
``` ```
如果需要测试版本的 Docker CE 请使用以下命令： If you want to use the `test` version of Docker CE, use the following command:
```bash ```bash
$ sudo yum-config-manager --enable docker-ce-test $ sudo yum-config-manager --enable docker-ce-test
``` ```
如果需要每日构建版本的 Docker CE 请使用以下命令： As for `nightly` version:
```bash ```bash
$ sudo yum-config-manager --enable docker-ce-nightly $ sudo yum-config-manager --enable docker-ce-nightly
``` ```
#### 安装 Docker CE #### Install Docker CE
更新 `yum` 软件源缓存，并安装 `docker-ce`。 Update `yum` source cache，and then install `docker-ce`.
```bash ```bash
$ sudo yum makecache fast $ sudo yum makecache fast
$ sudo yum install docker-ce $ sudo yum install docker-ce
``` ```
### 使用脚本自动安装 ### Install with Automatic Scripts
在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，CentOS 系统上可以使用这套脚本安装： To simplify the installation process during test or development, Docker official provides a convenient installation script, you can install docker on CentOS with the following script:
```bash ```bash
$ curl -fsSL get.docker.com -o get-docker.sh $ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh --mirror Aliyun $ sudo sh get-docker.sh --mirror Aliyun
``` ```
执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker CE 的 Edge 版本安装在系统中。 After execution, the script will have everything prepared, and have installed the stable version on your OS.
### 启动 Docker CE ### Start Docker CE
```bash ```bash
$ sudo systemctl enable docker $ sudo systemctl enable docker
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
### 建立 docker 用户组 ### Add Docker Usergroups
默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。 Command `docker` uses [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) to communicate with Docker engine by default. Only users of `root` and `docker` groups can communicate with Unix socket of the Docker engine.`root` user is not directly used on Linux systems in general for security. Therefore, it is better to add users who need to use `docker` to the `docker` user group.
建立 `docker` 组： create `docker` group:
```bash ```bash
$ sudo groupadd docker $ sudo groupadd docker
``` ```
将当前用户加入 `docker` 组： add current user to `docker` group:
```bash ```bash
$ sudo usermod -aG docker $USER $ sudo usermod -aG docker $USER
``` ```
退出当前终端并重新登录，进行如下测试。 Exit current terminal and relogin to test.
### 测试 Docker 是否安装正确 ### Verify the Installation
```bash ```bash
$ docker run hello-world $ docker run hello-world
@ -141,22 +139,22 @@ For more examples and ideas, visit:
https://docs.docker.com/get-started/ https://docs.docker.com/get-started/
``` ```
若能正常输出以上信息，则说明安装成功。 If it shows the above message, it means your installation is successful.
### 镜像加速 ### Registry Mirror(In China)
如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。 If you pull docker images very slowly, then you can configure [Registry Mirror](mirror.md).
### 添加内核参数 ### Add kernel Parameters
如果在 CentOS 使用 Docker CE 看到下面的这些警告信息： If you see the following warnings when using Docker CE,
```bash ```bash
WARNING: bridge-nf-call-iptables is disabled WARNING: bridge-nf-call-iptables is disabled
WARNING: bridge-nf-call-ip6tables is disabled WARNING: bridge-nf-call-ip6tables is disabled
``` ```
请添加内核配置参数以启用这些功能。 Please add the kernel parameters to enable these features.
```bash ```bash
$ sudo tee -a /etc/sysctl.conf <<-EOF $ sudo tee -a /etc/sysctl.conf <<-EOF
@ -165,12 +163,12 @@ net.bridge.bridge-nf-call-iptables = 1
EOF EOF
``` ```
然后重新加载 `sysctl.conf` 即可 Then reload the `sysctl.confg`
```bash ```bash
$ sudo sysctl -p $ sudo sysctl -p
``` ```
### 参考文档 ### References
* [Docker 官方 CentOS 安装文档](https://docs.docker.com/install/linux/docker-ce/centos/)。 * [Docker Official Installation Documents for Fedora](https://docs.docker.com/install/linux/docker-ce/centos/)

65
install/debian.md
View File

@ -1,19 +1,18 @@
## Debian 安装 Docker CE ## Install Docker CE on Debian
> WARNING: DO NOT install Docker with apt directly without configuring apt source.
>警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker. ### Prerequisites
### 准备工作 #### OS Requirement
#### 系统要求 Docker CE supports the following [Debian](https://www.debian.org/intro/about) versions.
Docker CE 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作系统：
* Buster 10 * Buster 10
* Stretch 9 * Stretch 9
#### 卸载旧版本 #### Uninstall the Old Versions
旧版本的 Docker 称为 `docker` 或者 `docker-engine`，使用以下命令卸载旧版本： The old versions of Docker are called `docker` or `docker-engine`, you can have them uninstalled with the following command:
```bash ```bash
$ sudo apt-get remove docker \ $ sudo apt-get remove docker \
@ -21,9 +20,9 @@ $ sudo apt-get remove docker \
docker.io docker.io
``` ```
### 使用 APT 安装 ### Install with apt
由于 apt 源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。 Since the apt source uses HTTPS to make sure that the software is not modified maliciously during download, we have to add the apt source via HTTPS as well as the CA certificate.
```bash ```bash
$ sudo apt-get update $ sudo apt-get update
@ -37,19 +36,19 @@ $ sudo apt-get install \
software-properties-common software-properties-common
``` ```
鉴于国内网络问题，强烈建议使用国内源，官方源请在注释中查看。 Due to the network issues in China mainland, it is highly recommended for Chinese users to use Chinese sources. Please refer to the official sources in the comments(they are replaced by a Chinese source).
为了确认所下载软件包的合法性，需要添加软件源的 GPG 密钥。 To verify the validity of the package downloaded, we have to add the GPG key for the package source.
```bash ```bash
$ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/debian/gpg | sudo apt-key add - $ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/debian/gpg | sudo apt-key add -
# 官方源 # Official source
# $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add - # $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
``` ```
然后，我们需要向 `source.list` 中添加 Docker CE 软件源： After that, we need to add the Docker CE source to `source.list`:
```bash ```bash
$ sudo add-apt-repository \ $ sudo add-apt-repository \
@ -57,18 +56,18 @@ $ sudo add-apt-repository \
$(lsb_release -cs) \ $(lsb_release -cs) \
stable" stable"
# 官方源 # Official source
# $ sudo add-apt-repository \ # $ sudo add-apt-repository \
# "deb [arch=amd64] https://download.docker.com/linux/debian \ # "deb [arch=amd64] https://download.docker.com/linux/debian \
# $(lsb_release -cs) \ # $(lsb_release -cs) \
# stable" # stable"
``` ```
>以上命令会添加稳定版本的 Docker CE APT 源，如果需要测试或每日构建版本的 Docker CE 请将 stable 改为 test 或者 nightly。 > The above commands will add the APT source for the stable version of Docker CE. If you need the `test` or `nightly` source, please replace with them to meet your own needs.
#### 安装 Docker CE #### Install Docker CE
更新 apt 软件包缓存，并安装 `docker-ce`。 Update apt cache and install `docker-ce`.
```bash ```bash
$ sudo apt-get update $ sudo apt-get update
@ -76,43 +75,43 @@ $ sudo apt-get update
$ sudo apt-get install docker-ce $ sudo apt-get install docker-ce
``` ```
### 使用脚本自动安装 ### Install with Automatic Scripts
在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Debian 系统上可以使用这套脚本安装： To simplify the installation process during test or development, Docker official provides a convenient installation script, you can install docker on Debian with the following script:
```bash ```bash
$ curl -fsSL get.docker.com -o get-docker.sh $ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh --mirror Aliyun $ sudo sh get-docker.sh --mirror Aliyun
``` ```
执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker CE 的 Edge 版本安装在系统中。 After execution, the script will have everything prepared, and have installed the stable version on your OS.
### 启动 Docker CE ### Start Docker CE
```bash ```bash
$ sudo systemctl enable docker $ sudo systemctl enable docker
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
### 建立 docker 用户组 ### Add Docker Usergroups
默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。 Command `docker` uses [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) to communicate with Docker engine by default. Only users of `root` and `docker` groups can communicate with Unix socket of the Docker engine.`root` user is not directly used on Linux systems in general for security. Therefore, it is better to add users who need to use `docker` to the `docker` user group.
建立 `docker` 组： create `docker` group:
```bash ```bash
$ sudo groupadd docker $ sudo groupadd docker
``` ```
将当前用户加入 `docker` 组： add current user to `docker` group:
```bash ```bash
$ sudo usermod -aG docker $USER $ sudo usermod -aG docker $USER
``` ```
退出当前终端并重新登录，进行如下测试。 Exit current terminal and relogin to test.
### 测试 Docker 是否安装正确 ### Verify the Installation
```bash ```bash
$ docker run hello-world $ docker run hello-world
@ -145,12 +144,12 @@ For more examples and ideas, visit:
https://docs.docker.com/get-started/ https://docs.docker.com/get-started/
``` ```
若能正常输出以上信息，则说明安装成功。 If it shows the above message, it means your installation is successful.
### 镜像加速 ### Registry Mirror(In China)
如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。 If you pull docker images very slowly, then you can configure [Registry Mirror](mirror.md).
### 参考文档 ### References
* [Docker 官方 Debian 安装文档](https://docs.docker.com/install/linux/docker-ce/debian/) * [Docker Official Installation Documents for Debian](https://docs.docker.com/install/linux/docker-ce/debian/)

68
install/fedora.md
View File

@ -1,20 +1,21 @@
## Fedora 安装 Docker CE ## Install Docker CE on Fedora
>警告：切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker. > WARNING: DO NOT install Docker with dnf directly without configuring dnf source.
### 准备工作 ### Prerequisites
#### 系统要求 #### OS Requirement
Docker CE 支持以下版本的 [Fedora](https://fedoraproject.org/) 操作系统：
Docker CE supports the following [Fedora](https://fedoraproject.org/) versions:
* 28 * 28
* 29 * 29
* 30 * 30
#### 卸载旧版本 #### Uninstall the Old Versions
旧版本的 Docker 称为 `docker` 或者 `docker-engine`，使用以下命令卸载旧版本： The old versions of Docker are called `docker` or `docker-engine`, you can have them uninstalled with the following command:
```bash ```bash
$ sudo dnf remove docker \ $ sudo dnf remove docker \
@ -29,17 +30,16 @@ $ sudo dnf remove docker \
docker-engine docker-engine
``` ```
### 使用 dnf 安装 ### Install with dnf
执行以下命令安装依赖包： Execute the following command to install the dependencies.
```bash ```bash
$ sudo dnf -y install dnf-plugins-core $ sudo dnf -y install dnf-plugins-core
``` ```
Due to the network issues in China mainland, it is highly recommended for Chinese users to use Chinese sources. Please refer to the official sources in the comments(they are replaced by a Chinese source).
鉴于国内网络问题，强烈建议使用国内源，官方源请在注释中查看。 Use the following command to add `dnf` source.
执行下面的命令添加 `dnf` 软件源：
```bash ```bash
$ sudo dnf config-manager \ $ sudo dnf config-manager \
@ -47,40 +47,40 @@ $ sudo dnf config-manager \
https://mirrors.ustc.edu.cn/docker-ce/linux/fedora/docker-ce.repo https://mirrors.ustc.edu.cn/docker-ce/linux/fedora/docker-ce.repo
# 官方源 # Official source
# $ sudo dnf config-manager \ # $ sudo dnf config-manager \
# --add-repo \ # --add-repo \
# https://download.docker.com/linux/fedora/docker-ce.repo # https://download.docker.com/linux/fedora/docker-ce.repo
``` ```
如果需要测试版本的 Docker CE 请使用以下命令： If you want to use the `test` version of Docker CE, use the following command:
```bash ```bash
$ sudo dnf config-manager --set-enabled docker-ce-test $ sudo dnf config-manager --set-enabled docker-ce-test
``` ```
如果需要每日构建版本的 Docker CE 请使用以下命令： As for `nightly` version:
```bash ```bash
$ sudo dnf config-manager --set-enabled docker-ce-nightly $ sudo dnf config-manager --set-enabled docker-ce-nightly
``` ```
你也可以禁用测试版本的 Docker CE You are also free to disable the test version of Docker CE:
```bash ```bash
$ sudo dnf config-manager --set-disabled docker-ce-test $ sudo dnf config-manager --set-disabled docker-ce-test
``` ```
#### 安装 Docker CE #### Install Docker CE
更新 `dnf` 软件源缓存，并安装 `docker-ce`。 Update `dnf` source cache，and then install `docker-ce`.
```bash ```bash
$ sudo dnf update $ sudo dnf update
$ sudo dnf install docker-ce $ sudo dnf install docker-ce
``` ```
你也可以使用以下命令安装指定版本的 Docker You can also use the following command to install a certain docker verion you want:
```bash ```bash
$ dnf list docker-ce --showduplicates | sort -r $ dnf list docker-ce --showduplicates | sort -r
@ -90,43 +90,43 @@ docker-ce.x86_64 18.06.1.ce-3.fc28 docker-ce-stable
$ sudo dnf -y install docker-ce-18.06.1.ce $ sudo dnf -y install docker-ce-18.06.1.ce
``` ```
### 使用脚本自动安装 ### Install with Automatic Scripts
在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Debian 系统上可以使用这套脚本安装： To simplify the installation process during test or development, Docker official provides a convenient installation script, you can install docker on Fedora with the following script:
```bash ```bash
$ curl -fsSL get.docker.com -o get-docker.sh $ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh --mirror Aliyun $ sudo sh get-docker.sh --mirror Aliyun
``` ```
执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker CE 最新版本安装在系统中。 After execution, the script will have everything prepared, and have installed the stable version on your OS.
### 启动 Docker CE ### Start Docker CE
```bash ```bash
$ sudo systemctl enable docker $ sudo systemctl enable docker
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
### 建立 docker 用户组 ### Add Docker Usergroups
默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。 Command `docker` uses [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) to communicate with Docker engine by default. Only users of `root` and `docker` groups can communicate with Unix socket of the Docker engine.`root` user is not directly used on Linux systems in general for security. Therefore, it is better to add users who need to use `docker` to the `docker` user group.
建立 `docker` 组： create `docker` group:
```bash ```bash
$ sudo groupadd docker $ sudo groupadd docker
``` ```
将当前用户加入 `docker` 组： add current user to `docker` group:
```bash ```bash
$ sudo usermod -aG docker $USER $ sudo usermod -aG docker $USER
``` ```
退出当前终端并重新登录，进行如下测试。 Exit current terminal and relogin to test.
### 测试 Docker 是否安装正确 ### Verify the Installation
```bash ```bash
$ docker run hello-world $ docker run hello-world
@ -159,12 +159,12 @@ For more examples and ideas, visit:
https://docs.docker.com/get-started/ https://docs.docker.com/get-started/
``` ```
若能正常输出以上信息，则说明安装成功。 If it shows the above message, it means your installation is successful.
### 镜像加速 ### Registry Mirror(In China)
如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。 If you pull docker images very slowly, then you can configure [Registry Mirror](mirror.md).
### 参考文档 ### References
* [Docker 官方 Fedora 安装文档](https://docs.docker.com/install/linux/docker-ce/fedora)。 * [Docker Official Installation Documents for Fedora](https://docs.docker.com/install/linux/docker-ce/fedora)

45
install/mac.md
View File

@ -1,46 +1,46 @@
## macOS 安装 Docker Desktop CE ## Install Docker Desktop CE on maxOS
### 系统要求 ### OS Requirement
[Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/) 要求系统最低为 macOS El Capitan 10.11。 The minimum OS version requirement [Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/) is macOS El Capitan 10.11.
### 安装 ### Installation
#### 使用 Homebrew 安装 #### Install with Homebrew
[Homebrew](https://brew.sh/) 的 [Cask](https://caskroom.github.io/) 已经支持 Docker Desktop for Mac，因此可以很方便的使用 Homebrew Cask 来进行安装： The [Cask](https://caskroom.github.io/) of [Homebrew](https://brew.sh/) has already supported Docker Desktop for Mac, so we can instrall it with Homebrew Cask easily.
```bash ```bash
$ brew cask install docker $ brew cask install docker
``` ```
#### 手动下载安装 #### Download and Install Manually
如果需要手动下载，请点击以下链接下载 [Stable](https://download.docker.com/mac/stable/Docker.dmg) 或 [Edge](https://download.docker.com/mac/edge/Docker.dmg) 版本的 Docker Desktop for Mac。 If you need to download `Docker Desktop for Mac` manually, please click the [Stable](https://download.docker.com/mac/stable/Docker.dmg) or [Edge](https://download.docker.com/mac/edge/Docker.dmg) link to downlaod it.
如同 macOS 其它软件一样，安装也非常简单，双击下载的 `.dmg` 文件，然后将那只叫 [Moby](https://blog.docker.com/2013/10/call-me-moby-dock/) 的鲸鱼图标拖拽到 `Application` 文件夹即可（其间需要输入用户密码）。 Just as other softwares on macOS, the installation of Docker Desktop for macOS is easy. You only need to double click the `.dmg` file, and then drag the whale([Moby](https://blog.docker.com/2013/10/call-me-moby-dock/)) icon to the `Applications` folder. During the process, you will be prompted to enter your password for your mac.
![](_images/install-mac-dmg.png) ![](_images/install-mac-dmg.png)
### 运行 ### Run
从应用中找到 Docker 图标并点击运行。 Find the Docker icon from your applications, and double click the icon to run Docker Desktop.
![](_images/install-mac-apps.png) ![](_images/install-mac-apps.png)
运行之后，会在右上角菜单栏看到多了一个鲸鱼图标，这个图标表明了 Docker 的运行状态。 After running, there should be a whale icon on the top right bar of your mac desktop. This icon indicates the running status of Docker.
![](_images/install-mac-menubar.png) ![](_images/install-mac-menubar.png)
第一次点击图标，可能会看到这个安装成功的界面，点击 "Got it!" 可以关闭这个窗口。 For the first time clicking on the icon, you may see the successful installation window. Clicking on "Got it!" will close the window.
![](_images/install-mac-success.png) ![](_images/install-mac-success.png)
以后每次点击鲸鱼图标会弹出操作菜单。 Clicking on the whale icon each time afterwards will show you the operation menu.
![](_images/install-mac-menu.png) ![](_images/install-mac-menu.png)
启动终端后，通过命令可以检查安装后的 Docker 版本。 After opening the terminal, you can check the newly-installed Docker version with commands.
```bash ```bash
$ docker --version $ docker --version
@ -51,27 +51,28 @@ $ docker-machine --version
docker-machine version 0.16.1, build cce350d7 docker-machine version 0.16.1, build cce350d7
``` ```
如果 `docker version`、`docker info` 都正常的话，可以尝试运行一个 [Nginx 服务器](https://hub.docker.com/_/nginx/)： If `docker version` and `docker info` shows no error nor warning, you can try to run an [Nginx Server](https://hub.docker.com/_/nginx/).
```bash ```bash
$ docker run -d -p 80:80 --name webserver nginx $ docker run -d -p 80:80 --name webserver nginx
``` ```
服务运行后，可以访问 <http://localhost>，如果看到了 "Welcome to nginx!"，就说明 Docker Desktop for Mac 安装成功了。 When the sever is up and running, you can visit <http://localhost>, if you see "Welcome to nginx!", it means the installation of Docker Desktop for macOS is successful.
![](_images/install-mac-example-nginx.png) ![](_images/install-mac-example-nginx.png)
要停止 Nginx 服务器并删除执行下面的命令： To stop the Nginx server and delete it, you can execute the following commands:
```bash ```bash
$ docker stop webserver $ docker stop webserver
$ docker rm webserver $ docker rm webserver
``` ```
### 镜像加速 ### Registry Mirror(In China)
如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。 If you pull docker images very slowly, then you can configure [Registry Mirror](mirror.md).
### 参考链接 ### References
* [官方文档](https://docs.docker.com/docker-for-mac/install/) * [Official Document](https://docs.docker.com/docker-for-mac/install/)

40
install/mirror.md
View File

@ -1,20 +1,21 @@
## 镜像加速器 ## Mirror Accelerators
国内从 Docker Hub 拉取镜像有时会遇到困难，此时可以配置镜像加速器。国内很多云服务商都提供了国内加速器服务，例如： You may have difficulty pulling images from Docker Hub if you are in China. To resolve this issue, you may configure mirror accelerators. There are many cloud service providers that provide accelerators in China, for example,
* [Azure 中国镜像 `https://dockerhub.azk8s.cn`](https://github.com/Azure/container-service-for-azure-china/blob/master/aks/README.md#22-container-registry-proxy) * [Azure China Mirrors `https://dockerhub.azk8s.cn`](https://github.com/Azure/container-service-for-azure-china/blob/master/aks/README.md#22-container-registry-proxy)
* [阿里云加速器(需登录账号获取)](https://cr.console.aliyun.com/cn-hangzhou/mirrors) * [Alibaba Cloud Accelerator(Login Required)](https://cr.console.aliyun.com/cn-hangzhou/mirrors)
* [七牛云加速器 `https://reg-mirror.qiniu.com`](https://kirk-enterprise.github.io/hub-docs/#/user-guide/mirror) * [Qiniu Cloud Accelerator `https://reg-mirror.qiniu.com`](https://kirk-enterprise.github.io/hub-docs/#/user-guide/mirror)
> 由于镜像服务可能出现宕机，建议同时配置多个镜像。 > Since some mirror services may be down sometimes, it is recommended to configure multiple mirrors simultaneously.
> 国内各大云服务商均提供了 Docker 镜像加速服务，建议根据运行 Docker 的云平台选择对应的镜像加速服务，具体请参考官方文档。 > Most of the cloud service giants in China provide Docker image acceleration services, you can choose acceleration services based on which platform you are running Docker on. For more detailed information, you may refer to their official documents.
We take Azure China Mirrors `https://dockerhub.azk8s.cn` as an example to introduce more.
我们以 Azure 中国镜像 `https://dockerhub.azk8s.cn` 为例进行介绍。
### Ubuntu 16.04+、Debian 8+、CentOS 7 ### Ubuntu 16.04+、Debian 8+、CentOS 7
对于使用 [systemd](https://www.freedesktop.org/wiki/Software/systemd/) 的系统，请在 `/etc/docker/daemon.json` 中写入如下内容（如果文件不存在请新建该文件） For Operating Systems using [systemd](https://www.freedesktop.org/wiki/Software/systemd/), please write the following contents inside `/etc/docker/daemon.json`. And if the file does not exist, please create the file.
```json ```json
{ {
@ -24,41 +25,40 @@
] ]
} }
``` ```
> Note, make sure the file is in valid json format, otherwise Docker will be unable to start.
> 注意，一定要保证该文件符合 json 规范，否则 Docker 将不能启动。 Then restart the service.
之后重新启动服务。
```bash ```bash
$ sudo systemctl daemon-reload $ sudo systemctl daemon-reload
$ sudo systemctl restart docker $ sudo systemctl restart docker
``` ```
>注意：如果您之前查看旧教程，修改了 `docker.service` 文件内容，请去掉您添加的内容（`--registry-mirror=https://dockerhub.azk8s.cn`）。 > Note: if you refered to the old tutorial previously, and modified the content of `docker.service`, please remove the added contents(`--registry-mirror=https://dockerhub.azk8s.cn`).
### Windows 10 ### Windows 10
对于使用 Windows 10 的系统，在系统右下角托盘 Docker 图标内右键菜单选择 `Settings`，打开配置窗口后左侧导航菜单选择 `Daemon`。在 `Registry mirrors` 一栏中填写加速器地址 `https://dockerhub.azk8s.cn`，之后点击 `Apply` 保存后 Docker 就会重启并应用配置的镜像地址了。 For windows 10, choose `Settings` in the list after click on the Docker icon at the right-bottom of the desktop. Then choose `Daemon`, and inside the `Registry mirrors`, fill in `https://dockerhub.azk8s.cn`. And finally click `Apply` to save and apply the changes.
### macOS ### macOS
对于使用 macOS 的用户，在任务栏点击 Docker Desktop 应用图标 -> Perferences... -> Daemon -> Registry mirrors。在列表中填写加速器地址 `https://dockerhub.azk8s.cn`。修改完成之后，点击 `Apply & Restart` 按钮，Docker 就会重启并应用配置的镜像地址了。 For macOS users, click Docker Desktop icon at the task bar -> Perferences... -> Daemon -> Registry mirrors. Then fill in the accelerator address `https://dockerhub.azk8s.cn` in the list. After the modification, click on `Apply & Restart` button, Docker will restart and apply the new mirror address.
### 检查加速器是否生效 ### Verify the Accelerator
执行 `$ docker info`，如果从结果中看到了如下内容，说明配置成功。 After executing `$docker info`, if you can see the following result, you have successfully configured it.
```bash ```bash
Registry Mirrors: Registry Mirrors:
https://dockerhub.azk8s.cn/ https://dockerhub.azk8s.cn/
``` ```
### gcr.io 镜像 ### gcr.io Mirror
国内无法直接获取 `gcr.io/*` 镜像，我们可以将 `gcr.io/<repo-name>/<image-name>:<version>` 替换为 `gcr.azk8s.cn/<repo-name>/<image-name>:<version>` ,例如 In China, we cannot fetch `gcr.io/*` mirrors direclty, but we can replace `gcr.io/<repo-name>/<image-name>:<version>` with `gcr.azk8s.cn/<repo-name>/<image-name>:<version>`, for example
```bash ```bash
# $ docker pull gcr.io/google_containers/hyperkube-amd64:v1.9.2 # $ docker pull gcr.io/google_containers/hyperkube-amd64:v1.9.2
$ docker pull gcr.azk8s.cn/google_containers/hyperkube-amd64:v1.9.2 $ docker pull gcr.azk8s.cn/google_containers/hyperkube-amd64:v1.9.2
``` ```

61
install/raspberry-pi.md
View File

@ -1,20 +1,21 @@
## 树莓派卡片电脑安装 Docker CE ## Install Docker CE on Raspberry Pi SoC
>警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker. > WARNING: DO NOT install Docker with apt directly without configuring apt source.
### 系统要求
Docker CE 不仅支持 `x86_64` 架构的计算机，同时也支持 `ARM` 架构的计算机，本小节内容以树莓派单片电脑为例讲解 `ARM` 架构安装 Docker CE。 ### OS Requirement
Docker CE 支持以下版本的 [Raspbian](https://www.raspberrypi.org/downloads/raspbian/) 操作系统： Docker CE supports not only `x86_64` architecture computers, but also `ARM` ones. In this section, we will take Raspberry Pi SoC as an example to explain how to install Docker CE on `ARM` computers.
Docker CE supports the following [Raspbian](https://www.raspberrypi.org/downloads/raspbian/) versions.
* Raspbian Stretch * Raspbian Stretch
*注：* `Raspbian` 是树莓派的开发与维护机构 [树莓派基金会](http://www.raspberrypi.org/) 推荐用于树莓派的首选系统，其基于 `Debian`。 *NOTE:* `Raspbian` is the top OS on Raspberry Pi recommended by [Raspberry Pi Foundation](https://www.raspberrypi.org/), which is the development and maintenance organization for Raspberry Pi. Raspbian is based on `Debian`.
### 使用 APT 安装 ### Install with apt
由于 apt 源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。 Since the apt source uses HTTPS to make sure that the software is not modified maliciously during download, we have to add the apt source via HTTPS as well as the CA certificate.
```bash ```bash
$ sudo apt-get update $ sudo apt-get update
@ -28,19 +29,19 @@ $ sudo apt-get install \
software-properties-common software-properties-common
``` ```
鉴于国内网络问题，强烈建议使用国内源，官方源请在注释中查看。 Due to the network issues in China mainland, it is highly recommended for Chinese users to use Chinese sources. Please refer to the official sources in the comments(they are replaced by a Chinese source).
为了确认所下载软件包的合法性，需要添加软件源的 GPG 密钥。 To verify the validity of the package downloaded, we have to add the GPG key for the package source.
```bash ```bash
$ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/raspbian/gpg | sudo apt-key add - $ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/raspbian/gpg | sudo apt-key add -
# 官方源 # Official source
# $ curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo apt-key add - # $ curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo apt-key add -
``` ```
然后，我们需要向 `source.list` 中添加 Docker CE 软件源： After that, we need to add the Docker CE source to `source.list`:
```bash ```bash
$ sudo add-apt-repository \ $ sudo add-apt-repository \
@ -49,18 +50,18 @@ $ sudo add-apt-repository \
stable" stable"
# 官方源 # Official Source
# $ sudo add-apt-repository \ # $ sudo add-apt-repository \
# "deb [arch=armhf] https://download.docker.com/linux/raspbian \ # "deb [arch=armhf] https://download.docker.com/linux/raspbian \
# $(lsb_release -cs) \ # $(lsb_release -cs) \
# stable" # stable"
``` ```
>以上命令会添加稳定版本的 Docker CE APT 源，如果需要测试或每日构建版本的 Docker CE 请将 stable 改为 test 或者 nightly。 > The above commands will add the APT source for the stable version of Docker CE. If you need the `test` or `nightly` source, please replace with them to meet your own needs.
#### 安装 Docker CE #### Install Docker CE
更新 apt 软件包缓存，并安装 `docker-ce`。 Update apt cache and install `docker-ce`.
```bash ```bash
$ sudo apt-get update $ sudo apt-get update
@ -68,43 +69,43 @@ $ sudo apt-get update
$ sudo apt-get install docker-ce $ sudo apt-get install docker-ce
``` ```
### 使用脚本自动安装 ### Install with Automatic Scripts
在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Raspbian 系统上可以使用这套脚本安装： To simplify the installation process during test or development, Docker official provides a convenient installation script, you can install docker on Raspbian with the following script:
```bash ```bash
$ curl -fsSL get.docker.com -o get-docker.sh $ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh --mirror Aliyun $ sudo sh get-docker.sh --mirror Aliyun
``` ```
执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker CE 的 Edge 版本安装在系统中。 After execution, the script will have everything prepared, and have installed the stable version on your OS.
### 启动 Docker CE ### Start Docker CE
```bash ```bash
$ sudo systemctl enable docker $ sudo systemctl enable docker
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
### 建立 docker 用户组 ### Add Docker Usergroups
默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。 Command `docker` uses [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) to communicate with Docker engine by default. Only users of `root` and `docker` groups can communicate with Unix socket of the Docker engine.`root` user is not directly used on Linux systems in general for security. Therefore, it is better to add users who need to use `docker` to the `docker` user group.
建立 `docker` 组： create `docker` group:
```bash ```bash
$ sudo groupadd docker $ sudo groupadd docker
``` ```
将当前用户加入 `docker` 组： add current user to `docker` group:
```bash ```bash
$ sudo usermod -aG docker $USER $ sudo usermod -aG docker $USER
``` ```
退出当前终端并重新登录，进行如下测试。 Exit current terminal and relogin to test.
### 测试 Docker 是否安装正确 ### Verify the Installation
```bash ```bash
$ docker run arm32v7/hello-world $ docker run arm32v7/hello-world
@ -137,10 +138,10 @@ For more examples and ideas, visit:
https://docs.docker.com/get-started/ https://docs.docker.com/get-started/
``` ```
若能正常输出以上信息，则说明安装成功。 If it shows the above message, it means your installation is successful.
*注意：* ARM 平台不能使用 `x86` 镜像，查看 Raspbian 可使用镜像请访问 [arm32v7](https://hub.docker.com/u/arm32v7/)。 *NOTE:* ARM platform cannot use `x86` mirrors, to view a list of the mirrors supported on Raspbian, please visit [arm32v7](https://hub.docker.com/u/arm32v7/).
### 镜像加速 ### Registry Mirror(In China)
如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。 If you pull docker images very slowly, then you can configure [Registry Mirror](mirror.md).

28
install/ubuntu.md
View File

@ -1,12 +1,12 @@
## Install Docker CE on Ubuntu ## Install Docker CE on Ubuntu
>warning: Don't install Docker CE directly using apt without configuring Docker APT source. > warning: Don't install Docker CE directly using apt without configuring Docker APT source.
### Preparation ### Prerequisites
#### System requirements #### System requirements
Docker CE supports [Ubuntu](https://www.ubuntu.com/server) versions: Docker CE supported [Ubuntu](https://www.ubuntu.com/server) versions:
* Disco 19.04 * Disco 19.04
* Cosmic 18.10 * Cosmic 18.10
@ -39,7 +39,7 @@ $ sudo apt-get install \
software-properties-common software-properties-common
``` ```
If you are in China, it is strongly recommended to use chinese sources. The official sources are in the comments. If you are in China, it is strongly recommended to use Chinese sources. The official sources are in the comments.
In order to confirm the validity of the downloaded package, we need to add the `GPG` key of the software source. In order to confirm the validity of the downloaded package, we need to add the `GPG` key of the software source.
@ -67,7 +67,7 @@ $ sudo add-apt-repository \
# stable" # stable"
``` ```
>The above commands will add stable Docker CE APT source. If you need test or nightly version of Docker, you can change the stable to test or nightly. > The above commands will add stable Docker CE APT source. If you need the `test` or `nightly` version of Docker, you can change `stable` to `test` or `nightly`.
#### Install Docker CE #### Install Docker CE
@ -81,14 +81,14 @@ $ sudo apt-get install docker-ce
### Auto install by script ### Auto install by script
Docker Offical has provided a set of convenient install scripts which can be installed on Ubuntu system for test or dev environments. Docker Offical has provided a set of convenient installation scripts which can be installed on Ubuntu for test or dev environments.
```bash ```bash
$ curl -fsSL get.docker.com -o get-docker.sh $ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh --mirror Aliyun $ sudo sh get-docker.sh --mirror Aliyun
``` ```
Script will make everythings ok and install Edge version of Docker CE for system after this command. The script will have everything prepared and have installed the stable version of Docker CE for the system after execution.
### Launcher Docker CE ### Launcher Docker CE
@ -97,9 +97,9 @@ $ sudo systemctl enable docker
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
### Add docker user group ### Add Docker Usergroups
Command `docker` uses [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) to communicate with Docker engine default. Only users of `root` and `docker` groups can communicate Unix socket of Docker engine.`root` user is not directly used on Linux systems in general for security. Therefore, it is better to add users who need to use `docker` to the `docker` user group. Command `docker` uses [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) to communicate with Docker engine by default. Only users of `root` and `docker` groups can communicate with Unix socket of the Docker engine.`root` user is not directly used on Linux systems in general for security. Therefore, it is better to add users who need to use `docker` to the `docker` user group.
create `docker` group: create `docker` group:
@ -115,7 +115,7 @@ $ sudo usermod -aG docker $USER
Exit current terminal and relogin to test. Exit current terminal and relogin to test.
### Test whether Docker is installed correctly ### Verify the Installation
```bash ```bash
$ docker run hello-world $ docker run hello-world
@ -148,12 +148,12 @@ For more examples and ideas, visit:
https://docs.docker.com/get-started/ https://docs.docker.com/get-started/
``` ```
If it shows above message, it means successful installation. If it shows above the message, it means your installation is successful.
### Registry Mirror(In China) ### Registry Mirror(In China)
If you pull docker images very slowly, then you can configurate [Registry Mirror](mirror.md). If you pull docker images very slowly, then you can configure [Registry Mirror](mirror.md).
### Links ### References
* [Offical Docker Docs](https://docs.docker.com/install/linux/docker-ce/ubuntu/) * [Docker Official Installation Documents for Ubuntu](https://docs.docker.com/install/linux/docker-ce/ubuntu/)

12
install/windows.md
View File

@ -2,15 +2,15 @@
### System requirements ### System requirements
[Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/install/) needs Windows 10 Pro 64 bit and activates Hyper-V [Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/install/) requires Windows 10 Pro 64-bit that activates [Hyper-V](https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/about/).
### Install ### Install
Download Docker Desktop for Windows [Stable](https://download.docker.com/win/stable/Docker%20Desktop%20Installer.exe) or [Edge](https://download.docker.com/win/edge/Docker%20Desktop%20Installer.exe), then double-click Docker for `Docker Desktop Installer.exe` to install. Download Docker Desktop for Windows [Stable](https://download.docker.com/win/stable/Docker%20Desktop%20Installer.exe) or [Edge](https://download.docker.com/win/edge/Docker%20Desktop%20Installer.exe), then double-click `Docker Desktop Installer.exe` to install.
### Running ### Running
Search Docker in Windows and click Docker for Windows to run. Search Docker in Windows and click `Docker for Windows` to run.
![](_images/install-win-docker-app-search.png) ![](_images/install-win-docker-app-search.png)
@ -18,14 +18,14 @@ There is a whale icon in the Windows taskbar after running Docker CE.
![](_images/install-win-taskbar-circle.png) ![](_images/install-win-taskbar-circle.png)
Wait a moment and click Got it to start using Docker CE. Wait a moment and click "Got it" to start using Docker CE.
![](_images/install-win-success-popup-cloud.png) ![](_images/install-win-success-popup-cloud.png)
### Registry Mirror(In China) ### Registry Mirror(In China)
If you pull docker images very slowly, then you can configurate [Registry Mirror](mirror.md). If you pull docker images very slowly, then you can configure [Registry Mirror](mirror.md).
### Links ### Links
* [Docs](https://docs.docker.com/docker-for-windows/install/) * [Docker Offical Docs](https://docs.docker.com/docker-for-windows/install/)