Docker Desktop for Mac/Windows 启用 Kubernetes

中文 | English

欢迎体验阿里云容器服务 Kubernetes Serverless版（ASK）免费试用计划，开启您的云上云原生实践之旅。 https://free.aliyun.com/?product=9596839

说明:

需要安装 Docker Desktop 的 Mac 或 Windows 版本，如果没有请下载 Docker CE 最新版本
当前 master 分支已在 Docker for Mac/Windows 4.30.0（包含 Docker 26.1.1 和 Kubernetes v1.29.2）版本上测试通过
如需测试其他版本，请查看 Docker Desktop 版本，Docker -> About Docker Desktop
- 如 Kubernetes 版本为 v1.29.2，请使用以下命令切换到 v1.29.2 分支 git checkout v1.29.2
- 如 Kubernetes 版本为 v1.29.1，请使用以下命令切换到 v1.29.1 分支 git checkout v1.29.1
- 如 Kubernetes 版本为 v1.28.2，请使用以下命令切换到 v1.28.2 分支 git checkout v1.28.2
- 如 Kubernetes 版本为 v1.27.2，请使用以下命令切换到 v1.27.2 分支 git checkout v1.27.2
- 如 Kubernetes 版本为 v1.25.9，请使用以下命令切换到 v1.25.9 分支 git checkout v1.25.9
- 如 Kubernetes 版本为 v1.25.4，请使用以下命令切换到 v1.25.4 分支 git checkout v1.25.4
- 如 Kubernetes 版本为 v1.25.2，请使用以下命令切换到 v1.25.2 分支 git checkout v1.25.2
- 如 Kubernetes 版本为 v1.25.0，请使用以下命令切换到 v1.25.0 分支 git checkout v1.25.0
- 如 Kubernetes 版本为 v1.24.2，请使用以下命令切换到 v1.24.2 分支 git checkout v1.24.2
- 如 Kubernetes 版本为 v1.24.0，请使用以下命令切换到 v1.24.0 分支 git checkout v1.24.0
- 如 Kubernetes 版本为 v1.23.4，请使用以下命令切换到 v1.23.4 分支 git checkout v1.23.4
- 如 Kubernetes 版本为 v1.22.5，请使用以下命令切换到 v1.22.5 分支 git checkout v1.22.5
- 如 Kubernetes 版本为 v1.22.4，请使用以下命令切换到 v1.22.4 分支 git checkout v1.22.4
- 如 Kubernetes 版本为 v1.21.5，请使用以下命令切换到 v1.21.5 分支 git checkout v1.21.5
- 如 Kubernetes 版本为 v1.21.4，请使用以下命令切换到 v1.21.4 分支 git checkout v1.21.4
- 如 Kubernetes 版本为 v1.21.3，请使用以下命令切换到 v1.21.3 分支 git checkout v1.21.3
- 如 Kubernetes 版本为 v1.21.2，请使用以下命令切换到 v1.21.2 分支 git checkout v1.21.2
- 如 Kubernetes 版本为 v1.21.1，请使用以下命令切换到 v1.21.1 分支 git checkout v1.21.1
如果Kubernetes版本为v1.19.3，请使用以下命令切换到v1.19.3分支 git checkout v1.19.3
如果Kubernetes版本为v1.19.2，请使用以下命令切换到v1.19.2分支 git checkout v1.19.2
如果Kubernetes版本为v1.18.8，请使用以下命令切换到v1.18.8分支 git checkout v1.18.8
如果Kubernetes版本为v1.18.6，请使用以下命令切换到v1.18.6分支 git checkout v1.18.6
如果Kubernetes版本为v1.18.3，请使用以下命令切换到v1.18.3分支 git checkout v1.18.3
如果Kubernetes版本为v1.16.5，请使用以下命令切换到v1.16.5分支 git checkout v1.16.5
如果Kubernetes版本为v1.15.5，请使用以下命令切换到v1.15.5分支 git checkout v1.15.5
如果Kubernetes版本为v1.15.4，请使用以下命令切换到v1.15.4分支 git checkout v1.15.4
如果Kubernetes版本为v1.14.8，请使用以下命令切换到v1.14.8分支 git checkout v1.14.8
如果Kubernetes版本为v1.14.7，请使用以下命令切换到v1.14.7分支 git checkout v1.14.7
如果Kubernetes版本为v1.14.6，请使用以下命令切换到v1.14.6分支 git checkout v1.14.6
如果Kubernetes版本为v1.14.3，请使用以下命令切换到v1.14.3分支 git checkout v1.14.3
如果Kubernetes版本为v1.14.1，请使用以下命令切换到v1.14.1分支 git checkout v1.14.1
如果Kubernetes版本为v1.13.0，请使用以下命令切换到v1.13.0分支 git checkout v1.13.0
如果Kubernetes版本为v1.10.11，请使用以下命令切换到v1.10.11分支 git checkout v1.10.11 注意：
如果发现K8s版本与您的环境不一致，可以修改images.properties文件指明所需镜像版本，
欢迎提交 Pull Request

启用 Kubernetes

为 Docker daemon 配置镜像加速，可参考阿里云镜像服务或使用中科大镜像加速地址https://docker.mirrors.ustc.edu.cn

镜像加速

可选步骤：为 Kubernetes 配置 CPU 和内存资源，建议分配 4GB 或更多内存。

资源配置

从阿里云镜像服务下载 Kubernetes 所需的镜像

在 Mac 上执行以下脚本：

./load_images.sh

在 Windows 上，使用 PowerShell：

 .\load_images.ps1

说明：

如果因为安全策略无法执行 PowerShell 脚本，请以管理员身份运行 PowerShell 并执行 Set-ExecutionPolicy RemoteSigned 命令。
如有需要，可以通过修改 images.properties 文件自行加载所需的镜像。

启用 Kubernetes，并等待 Kubernetes 开始运行 k8s

提示：

在 Mac 上：

如果在 Kubernetes 部署过程中遇到问题，可以通过以下命令获取 Docker Desktop 应用的实时日志信息：

pred='process matches ".*(ocker|vpnkit).*"
  || (process in {"taskgated-helper", "launchservicesd", "kernel"} && eventMessage contains[c] "docker")'
/usr/bin/log stream --style syslog --level=debug --color=always --predicate "$pred"

在 Windows 上：

如果在 Kubernetes 部署过程中遇到问题，可以在 C:\ProgramData\DockerDesktop 下的 service.txt 查看 Docker 日志，在 C:\Users\yourUserName\AppData\Local\Docker 下的 log.txt 查看 Kubernetes 日志。

问题诊断：

如果发现 Kubernetes 一直处于启动状态，请参考：

Issue 3769(评论) 或 Issue 3649(评论)
- 在 macOS 上，执行 rm -fr '~/Library/Group\ Containers/group.com.docker/pki'
- 在 Windows 上，删除 'C:\ProgramData\DockerDesktop\pki' 目录和 'C:\Users\yourUserName\AppData\Local\Docker\pki' 目录
Issue 1962(评论)

K8S 进入容器方法

K8s 如何进入一个包含多个容器的 pod 的方法：

kubectl --namespace=kube-system exec -it kube-dns-1336009800-15b1h --container nginx -- sh

或

kubectl --namespace=kube-system exec -it kube-dns-1336009800-15b1h  -c  nginx -- sh

注释：--namespace 为命名空间，kube-dns 为 pod 的名字，-c 或 --container 为 Pod 中的一个容器名字

配置 Kubernetes

可选步骤：将 Kubernetes 运行上下文切换至 docker-desktop（之前版本的 context 为 docker-for-desktop）

kubectl config use-context docker-desktop

验证 Kubernetes 集群状态

kubectl cluster-info
kubectl get nodes

配置 Kubernetes 控制台

部署 Kubernetes dashboard

kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.5.1/aio/deploy/recommended.yaml

或

kubectl apply -f kubernetes-dashboard.yaml

检查 kubernetes-dashboard 应用状态

kubectl get pod -n kubernetes-dashboard

启动 API Server 访问代理

kubectl proxy

通过以下 URL 访问 Kubernetes dashboard

http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/

配置控制台访问令牌

授权 kube-system 默认服务账号

kubectl apply -f kube-system-default.yaml

对于 Mac 环境

TOKEN=$(kubectl -n kube-system describe secret default| awk '$1=="token:"{print $2}')
kubectl config set-credentials docker-desktop --token="${TOKEN}"
echo $TOKEN

对于 Windows 环境

$TOKEN=((kubectl -n kube-system describe secret default | Select-String "token:") -split " +")[1]
kubectl config set-credentials docker-desktop --token="${TOKEN}"
echo $TOKEN

登录 dashboard 时

选择令牌

输入上文控制台输出的内容

或者选择 Kubeconfig 文件，路径如下：

Mac: $HOME/.kube/config
Win: %UserProfile%\.kube\config

点击登录，进入 Kubernetes Dashboard

配置 Ingress

说明：如果测试 Istio，不需要安装 Ingress

安装 Ingress

源地址安装说明

验证

kubectl get pods --all-namespaces -l app.kubernetes.io/name=ingress-nginx

测试示例应用

部署测试应用，详情参见社区文章

kubectl create -f sample/apple.yaml
kubectl create -f sample/banana.yaml
kubectl create -f sample/ingress.yaml

测试示例应用

$ curl -kL http://localhost/apple
apple
$ curl -kL http://localhost/banana
banana

删除示例应用

kubectl delete -f sample/apple.yaml
kubectl delete -f sample/banana.yaml
kubectl delete -f sample/ingress.yaml

删除 Ingress

kubectl delete -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.2.0/deploy/static/provider/cloud/deploy.yaml

或

kubectl delete -f ingress-nginx-controller.yaml

安装 Helm

可以根据文档安装 helm v3 https://helm.sh/docs/intro/install/ 在国内由于helm的cdn节点使用的是谷歌云所以可能访问不到，可以参考已存在的官方issue： https://github.com/helm/helm/issues/7028

在 Mac OS 上安装

通过 brew 安装

# 在 Mac 上使用 homebrew
brew install helm

# 添加 helm 仓库
helm repo add stable http://mirror.azure.cn/kubernetes/charts/

# 更新 charts 仓库
helm repo update

在Windows上安装

如果在后续使用 helm 安装组件的过程中出现版本兼容问题，可以参考 通过二进制包安装 思路安装匹配的版本

# 在 Windows 上使用 Chocolatey
# 注：安装的时候需要保证网络能够访问googleapis这个域名
choco install kubernetes-helm

# 更改 helm 仓库
helm repo add stable http://mirror.azure.cn/kubernetes/charts/

# 更新 charts 仓库
helm repo update

测试 Helm (可选)

安装 Wordpress

helm install wordpress stable/wordpress

查看 wordpress 发布状态

helm status wordpress

卸载 wordpress 发布

helm uninstall wordpress

配置 Istio

说明：Istio Ingress Gateway和Ingress缺省的端口冲突，请移除Ingress并进行下面测试

可以根据文档安装 Istio https://istio.io/docs/setup/getting-started/

下载 Istio

例如下载Istio版本1.22.1（其他更新版本可以自行替换）, 执行如下命令：

curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.22.1 sh -
cd istio-1.22.1
export PATH=$PWD/bin:$PATH

注意： Windows环境未经严格测试。

在Windows上，您可以手工下载Istio安装包，或者把getLatestIstio.ps1拷贝到你希望下载 Istio 的目录，并执行 - 说明：根据社区提供的安装脚本修改而来

.\getLatestIstio.ps1

安装 Istio

istioctl install --set profile=demo -y

检查 Istio 状态

kubectl get pods -n istio-system

为 `default` 名空间开启自动 sidecar 注入

kubectl label namespace default istio-injection=enabled
kubectl get namespace -L istio-injection

安装 Book Info 示例

请参考 https://istio.io/docs/examples/bookinfo/

kubectl apply -f samples/bookinfo/platform/kube/bookinfo.yaml

查看示例应用资源

kubectl get svc,pod

确认示例应用在运行中

kubectl exec -it $(kubectl get pod -l app=ratings -o jsonpath='{.items[0].metadata.name}') -c ratings -- curl productpage:9080/productpage | grep -o "<title>.*</title>"

创建 Ingress Gateway

kubectl apply -f samples/bookinfo/networking/bookinfo-gateway.yaml

查看 Gateway 配置

kubectl get gateway

确认示例应用可以访问

export GATEWAY_URL=localhost:80
curl -s http://${GATEWAY_URL}/productpage | grep -o "<title>.*</title>"

可以通过浏览器访问

http://localhost/productpage

删除实例应用

samples/bookinfo/platform/kube/cleanup.sh

卸载 Istio

istioctl manifest generate --set profile=demo | kubectl delete -f -

k8s-for-docker-desktop

Docker Desktop for Mac/Windows 启用 Kubernetes

启用 Kubernetes

配置 Kubernetes

配置 Kubernetes 控制台

部署 Kubernetes dashboard

配置控制台访问令牌

登录 dashboard 时

配置 Ingress

安装 Ingress

测试示例应用

删除 Ingress

安装 Helm

在 Mac OS 上安装

通过 brew 安装

在Windows上安装

测试 Helm (可选)

配置 Istio

下载 Istio

安装 Istio

检查 Istio 状态

为 default 名空间开启自动 sidecar 注入

安装 Book Info 示例

删除实例应用

卸载 Istio

为 `default` 名空间开启自动 sidecar 注入