[N/A] feat: fix pre install document.

Author: guangzhengli

README.md

@@ -28,8 +28,11 @@ k8s 作为云原生时代的操作系统，学习它的必要性不言而喻，
 - [kubernetes tutorials](#kubernetes-tutorials)
   - [准备工作](#准备工作)
     - [安装 docker](#安装-docker)
+      - [推荐安装方法](#推荐安装方法)
+      - [其它安装方法](#其它安装方法)
     - [安装 minikube](#安装-minikube)
-    - [安装 k8s CLI 和 Terminal based UI](#安装-k8s-cli-和-terminal-based-ui)
+      - [启动 minikube](#启动-minikube)
+    - [安装 kubectl](#安装-kubectl)
     - [注册 docker hub 账号登录](#注册-docker-hub-账号登录)
   - [Container](#container)
   - [Pod](#pod)
@@ -62,35 +65,49 @@ k8s 作为云原生时代的操作系统，学习它的必要性不言而喻，
 
 ## 准备工作
 
-由于我本地环境是 MacOS 11.6.2 Intel 版本，教程也是在本地环境进行。windows 或 linux 环境的小伙伴需要自行安装 docker 和 minikube。
+在开始本教程之前，需要配置好本地环境，以下是需要安装的依赖和包。
 
 ### 安装 docker
 
-因为 docker desktop 各种协议和法律问题，已经不建议大家直接安装 desktop 使用，建议只安装 CLI。注意：如果本地已经安装了 docker desktop，那么可以忽略这一步，下一步也可以简化。
+首先我们需要安装 `docker` 来打包镜像，如果你本地已经安装了 `docker`，那么你可以选择跳过这一小节。
 
-```bash
-# Install Docker CLI
-brew install docker
-brew install docker-compose
-```
+#### 推荐安装方法
+
+目前使用 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 来安装 docker 还是最简单的方案，打开官网下载对应你电脑操作系统的包即可 (https://www.docker.com/products/docker-desktop/)，
+
+当安装完成后，可以通过 `docker run hello-world` 来快速校验是否安装成功！
+
+#### 其它安装方法
+
+目前  Docker 公司宣布  [Docker Desktop](https://www.docker.com/products/docker-desktop/) 只对个人开发者或者小型团体免费 (2021年起对大型公司不再免费)，所以如果你不能通过  [Docker Desktop](https://www.docker.com/products/docker-desktop/) 的方式下载安装 `docker`，可以参考 [这篇文章](https://dhwaneetbhatt.com/blog/run-docker-without-docker-desktop-on-macos) 只安装  [Docker CLI](https://github.com/docker/cli)。
 
 ### 安装 minikube
 
-[minikube](https://minikube.sigs.k8s.io/docs/) 用于在本地环境中运行 Kubernetes 集群。在 macOS 上，minikube 可以基于多种虚拟化技术上，可以选择[hyperkit](https://minikube.sigs.k8s.io/docs/drivers/hyperkit/)，这里因为我本地之前已经安装过 virtualbox (brew install --cask virtualbox)，所以我用的是 virtualbox 虚拟化技术。而且如果你本地之前已经安装了 docker desktop 的话，可以不需要下载 `hyperkit` 或者 `virtualbox`。
+我们还需要搭建一套 k8s 本地集群 (使用云厂商或者其它 k8s 集群都可) 。本地搭建 k8s 集群的方式推荐使用 [minikube](https://minikube.sigs.k8s.io/docs/)。
 
->注意：如果本地已经安装了 docker desktop，那么可以使用 minikube start --vm-driver docker --container-runtime=docker 来快速启动 minikube
+可以根据 [minikube 快速安装](https://minikube.sigs.k8s.io/docs/start/) 来进行下载安装，这里简单列举 MacOS 的安装方式，Linux & Windows 操作系统可以参考[官方文档](https://minikube.sigs.k8s.io/docs/start/) 快速安装。
 
-```bash
-# Install hyperkit and minikube (check which vm-driver to use, if install docker desktop already, you can just use vm-driver=docker instead of install hyperkiy)
-brew install hyperkit
+```shell
 brew install minikube
 ```
 
-```bash
-# Start minikube 
+#### 启动 minikube
+
+因为 minikube 支持很多容器和虚拟化技术 ([Docker](https://minikube.sigs.k8s.io/docs/drivers/docker/), [Hyperkit](https://minikube.sigs.k8s.io/docs/drivers/hyperkit/), [Hyper-V](https://minikube.sigs.k8s.io/docs/drivers/hyperv/), [KVM](https://minikube.sigs.k8s.io/docs/drivers/kvm2/), [Parallels](https://minikube.sigs.k8s.io/docs/drivers/parallels/), [Podman](https://minikube.sigs.k8s.io/docs/drivers/podman/), [VirtualBox](https://minikube.sigs.k8s.io/docs/drivers/virtualbox/), or [VMware Fusion/Workstation](https://minikube.sigs.k8s.io/docs/drivers/vmware/))，也是问题出现比较多的地方，所以这里还是稍微说明一下。
+
+如果你使用 `docker` 的方案是上面推荐的 [Docker Desktop](https://www.docker.com/products/docker-desktop/) ，那么你以下面的命令启动 minikube 即可，需要耐心等待下载依赖。
+
+```shell
+minikube start --vm-driver docker --container-runtime=docker
+```
+
+启动完成后，运行 `minikube status` 查看当前状态确定是否启动成功！
+
+如果你本地只有 Docker CLI，判断标准如果执行 `docker ps` 等命令，返回错误 `Cannot connect to the Docker daemon at unix:///Users/xxxx/.colima/docker.sock. Is the docker daemon running?` 那么就需要操作下面的命令。
+
+```shell
+brew install hyperkit
 minikube start --vm-driver hyperkit --container-runtime=docker
-# minikube start --vm-driver virtualbox --container-runtime=docker
-# minikube start --vm-driver docker --container-runtime=docker
 
 # Tell Docker CLI to talk to minikube's VM
 eval $(minikube docker-env)
@@ -102,19 +119,21 @@ echo "`minikube ip` docker.local" | sudo tee -a /etc/hosts > /dev/null
 docker run hello-world
 ```
 
-**minikube Cheatsheet**
+**minikube 命令速查**
 
 `minikube stop` 不会删除任何数据，只是停止 VM 和 k8s 集群。
 
 `minikube delete` 删除所有 minikube 启动后的数据。
 
-`minikube ip` 集群和 docker enginer 运行的 IP 地址。
+`minikube ip` 查看集群和 docker enginer 运行的 IP 地址。
 
-`minikube pause` 暂停当前的资源和集群
+`minikube pause` 暂停当前的资源和 k8s 集群
 
 `minikube status` 查看当前集群状态
 
-### 安装 k8s CLI 和 Terminal based UI
+### 安装 kubectl
+
+这一步是可选的，如果不安装的话，后续所有 `kubectl` 相关的命令，使用 `minikube kubectl` 命令替代即可。
 
 如果你不想使用 `minikube kubectl` 或者配置相关环境变量来进行下面的教学的话，可以考虑直接安装 `kubectl`。
 
@@ -124,7 +143,7 @@ brew install kubectl
 
 ### 注册 docker hub 账号登录
 
-在 docker hun(https://hub.docker.com/) 中注册账号，并且使用 login 登录账号。
+因为默认 minikube 使用的镜像地址是 DockerHub，所以我们还需要在 docker hun(https://hub.docker.com/) 中注册账号，并且使用 login 命令登录账号。
 
 ```shell
 docker login

docs/pre.md

@@ -1,34 +1,48 @@
 ## 准备工作
 
-由于我本地环境是 MacOS 11.6.2 Intel 版本，教程也是在本地环境进行。windows 或 linux 环境的小伙伴需要自行安装 docker 和 minikube。
+在开始本教程之前，需要配置好本地环境，以下是需要安装的依赖和包。
 
 ### 安装 docker
 
-因为 docker desktop 各种协议和法律问题，已经不建议大家直接安装 desktop 使用，建议只安装 CLI。注意：如果本地已经安装了 docker desktop，那么可以忽略这一步，下一步也可以简化。
+首先我们需要安装 `docker` 来打包镜像，如果你本地已经安装了 `docker`，那么你可以选择跳过这一小节。
 
-```bash
-# Install Docker CLI
-brew install docker
-brew install docker-compose
-```
+#### 推荐安装方法
+
+目前使用 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 来安装 docker 还是最简单的方案，打开官网下载对应你电脑操作系统的包即可 (https://www.docker.com/products/docker-desktop/)，
+
+当安装完成后，可以通过 `docker run hello-world` 来快速校验是否安装成功！
+
+#### 其它安装方法
+
+目前  Docker 公司宣布  [Docker Desktop](https://www.docker.com/products/docker-desktop/) 只对个人开发者或者小型团体免费 (2021年起对大型公司不再免费)，所以如果你不能通过  [Docker Desktop](https://www.docker.com/products/docker-desktop/) 的方式下载安装 `docker`，可以参考 [这篇文章](https://dhwaneetbhatt.com/blog/run-docker-without-docker-desktop-on-macos) 只安装  [Docker CLI](https://github.com/docker/cli)。
 
 ### 安装 minikube
 
-[minikube](https://minikube.sigs.k8s.io/docs/) 用于在本地环境中运行 Kubernetes 集群。在 macOS 上，minikube 可以基于多种虚拟化技术上，可以选择[hyperkit](https://minikube.sigs.k8s.io/docs/drivers/hyperkit/)，这里因为我本地之前已经安装过 virtualbox (brew install --cask virtualbox)，所以我用的是 virtualbox 虚拟化技术。而且如果你本地之前已经安装了 docker desktop 的话，可以不需要下载 `hyperkit` 或者 `virtualbox`。
+我们还需要搭建一套 k8s 本地集群 (使用云厂商或者其它 k8s 集群都可) 。本地搭建 k8s 集群的方式推荐使用 [minikube](https://minikube.sigs.k8s.io/docs/)。
 
->注意：如果本地已经安装了 docker desktop，那么可以使用 minikube start --vm-driver docker --container-runtime=docker 来快速启动 minikube
+可以根据 [minikube 快速安装](https://minikube.sigs.k8s.io/docs/start/) 来进行下载安装，这里简单列举 MacOS 的安装方式，Linux & Windows 操作系统可以参考[官方文档](https://minikube.sigs.k8s.io/docs/start/) 快速安装。
 
-```bash
-# Install hyperkit and minikube (check which vm-driver to use, if install docker desktop already, you can just use vm-driver=docker instead of install hyperkiy)
-brew install hyperkit
+```shell
 brew install minikube
 ```
 
-```bash
-# Start minikube 
+#### 启动 minikube
+
+因为 minikube 支持很多容器和虚拟化技术 ([Docker](https://minikube.sigs.k8s.io/docs/drivers/docker/), [Hyperkit](https://minikube.sigs.k8s.io/docs/drivers/hyperkit/), [Hyper-V](https://minikube.sigs.k8s.io/docs/drivers/hyperv/), [KVM](https://minikube.sigs.k8s.io/docs/drivers/kvm2/), [Parallels](https://minikube.sigs.k8s.io/docs/drivers/parallels/), [Podman](https://minikube.sigs.k8s.io/docs/drivers/podman/), [VirtualBox](https://minikube.sigs.k8s.io/docs/drivers/virtualbox/), or [VMware Fusion/Workstation](https://minikube.sigs.k8s.io/docs/drivers/vmware/))，也是问题出现比较多的地方，所以这里还是稍微说明一下。
+
+如果你使用 `docker` 的方案是上面推荐的 [Docker Desktop](https://www.docker.com/products/docker-desktop/) ，那么你以下面的命令启动 minikube 即可，需要耐心等待下载依赖。
+
+```shell
+minikube start --vm-driver docker --container-runtime=docker
+```
+
+启动完成后，运行 `minikube status` 查看当前状态确定是否启动成功！
+
+如果你本地只有 Docker CLI，判断标准如果执行 `docker ps` 等命令，返回错误 `Cannot connect to the Docker daemon at unix:///Users/xxxx/.colima/docker.sock. Is the docker daemon running?` 那么就需要操作下面的命令。
+
+```shell
+brew install hyperkit
 minikube start --vm-driver hyperkit --container-runtime=docker
-# minikube start --vm-driver virtualbox --container-runtime=docker
-# minikube start --vm-driver docker --container-runtime=docker
 
 # Tell Docker CLI to talk to minikube's VM
 eval $(minikube docker-env)
@@ -40,19 +54,21 @@ echo "`minikube ip` docker.local" | sudo tee -a /etc/hosts > /dev/null
 docker run hello-world
 ```
 
-**minikube Cheatsheet**
+**minikube 命令速查**
 
 `minikube stop` 不会删除任何数据，只是停止 VM 和 k8s 集群。
 
 `minikube delete` 删除所有 minikube 启动后的数据。
 
-`minikube ip` 集群和 docker enginer 运行的 IP 地址。
+`minikube ip` 查看集群和 docker enginer 运行的 IP 地址。
 
-`minikube pause` 暂停当前的资源和集群
+`minikube pause` 暂停当前的资源和 k8s 集群
 
 `minikube status` 查看当前集群状态
 
-### 安装 k8s CLI 和 Terminal based UI
+### 安装 kubectl
+
+这一步是可选的，如果不安装的话，后续所有 `kubectl` 相关的命令，使用 `minikube kubectl` 命令替代即可。
 
 如果你不想使用 `minikube kubectl` 或者配置相关环境变量来进行下面的教学的话，可以考虑直接安装 `kubectl`。
 
@@ -62,7 +78,7 @@ brew install kubectl
 
 ### 注册 docker hub 账号登录
 
-在 docker hun(https://hub.docker.com/) 中注册账号，并且使用 login 登录账号。
+因为默认 minikube 使用的镜像地址是 DockerHub，所以我们还需要在 docker hun(https://hub.docker.com/) 中注册账号，并且使用 login 命令登录账号。
 
 ```shell
 docker login