Docker Desktop for Mac/Windows 开启 Kubernetes

中文 | English

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

说明:

近期从 k8s.gcr.io 拉取镜像的成功率高了很多，如果您通过如下命令 docker pull k8s.gcr.io/pause:3.8 测试镜像拉取成功，本项目相关部分可以直接跳过。
需安装 Docker Desktop 的 Mac 或者 Windows 版本，如果没有请下载下载 Docker CE最新版本
当前 master 分支已经在 Docker for Mac/Windows 4.24.1 (包含 Docker CE 24.0.2 和 Kubernetes 1.27.2) 版本测试通过
如果需要测试其他版本，请查看 Docker Desktop版本，Docker -> About Docker Desktop
- 如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 开始运行

TIPS：

在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(comment) 或 Issue 3649(comment)
- 在macOS上面，执行 rm -fr '~/Library/Group\ Containers/group.com.docker/pki'
- 在Windows上面删除 'C:\ProgramData\DockerDesktop\pki' 目录和 'C:\Users\yourUserName\AppData\Local\Docker\pki' 目录
Issue 1962(comment)

配置 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 apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.2.0/deploy/static/provider/cloud/deploy.yaml

或

kubectl apply -f ingress-nginx-controller.yaml

验证

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： helm/helm#7028

在 Mac OS 上安装

通过 brew 安装

# Use homebrew on Mac
brew install helm

# Add helm repo
helm repo add stable http://mirror.azure.cn/kubernetes/charts/

# Update charts repo
helm repo update

在Windows上安装

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

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

# Change helm repo
helm repo add stable http://mirror.azure.cn/kubernetes/charts/

# Update charts repo
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 1.5.0

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

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

.\getLatestIstio.ps1

安装 Istio

istioctl manifest apply --set profile=demo

检查 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 -

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Docker Desktop for Mac/Windows 开启 Kubernetes

开启 Kubernetes

配置 Kubernetes

配置 Kubernetes 控制台

部署 Kubernetes dashboard

配置控制台访问令牌

登录dashboard的时候

配置 Ingress

安装 Ingress

测试示例应用

删除 Ingress

安装 Helm

在 Mac OS 上安装

通过 brew 安装

在Windows上安装

测试 Helm (可选)

配置 Istio

下载 Istio 1.5.0

安装 Istio

检查 Istio 状态

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

安装 Book Info 示例

删除实例应用

卸载 Istio

About

Releases

Packages

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 163 Commits
images		images
sample		sample
.gitignore		.gitignore
README.md		README.md
README_en.md		README_en.md
getLatestIstio.ps1		getLatestIstio.ps1
images.properties		images.properties
ingress-nginx-controller.yaml		ingress-nginx-controller.yaml
k8s命令		k8s命令
kube-system-default.yaml		kube-system-default.yaml
kubernetes-dashboard.yaml		kubernetes-dashboard.yaml
load_images.ps1		load_images.ps1
load_images.sh		load_images.sh

LuoYY/k8s-for-docker-desktop

Folders and files

Latest commit

History

Repository files navigation

Docker Desktop for Mac/Windows 开启 Kubernetes

开启 Kubernetes

配置 Kubernetes

配置 Kubernetes 控制台

部署 Kubernetes dashboard

配置控制台访问令牌

登录dashboard的时候

配置 Ingress

安装 Ingress

测试示例应用

删除 Ingress

安装 Helm

在 Mac OS 上安装

通过 brew 安装

在Windows上安装

测试 Helm (可选)

配置 Istio

下载 Istio 1.5.0

安装 Istio

检查 Istio 状态

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

安装 Book Info 示例

删除实例应用

卸载 Istio

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

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

Packages