k8s-for-docker-desktop-master.zip

# Docker Desktop for Mac/Windows 开启 Kubernetes 中文 | [English](README_en.md) 说明: * 需安装 Docker Desktop 的 Mac 或者 Windows 版本，如果没有请下载[下载 Docker CE最新版本](https://store.docker.com/search?type=edition&offering=community) * 当前 master 分支已经在 Docker for Mac/Windows 4.33.0 (包含 Docker 27.1.1 和 Kubernetes v1.30.2) 版本测试通过 * 如果需要测试其他版本，请查看 Docker Desktop版本，Docker -> About Docker Desktop  * 如Kubernetes版本为 v1.30.2, 请使用下面命令切换 [v1.30.2 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.30.2) ```git checkout v1.30.2``` * 如Kubernetes版本为 v1.29.2, 请使用下面命令切换 [v1.29.2 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.29.2) ```git checkout v1.29.2``` * 如Kubernetes版本为 v1.29.1, 请使用下面命令切换 [v1.29.1 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.29.1) ```git checkout v1.29.1``` * 如Kubernetes版本为 v1.28.2, 请使用下面命令切换 [v1.28.2 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.28.2) ```git checkout v1.28.2``` * 如Kubernetes版本为 v1.27.2, 请使用下面命令切换 [v1.27.2 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.27.2) ```git checkout v1.27.2``` * 如Kubernetes版本为 v1.25.9, 请使用下面命令切换 [v1.25.9 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.25.9) ```git checkout v1.25.9``` * 如Kubernetes版本为 v1.25.4, 请使用下面命令切换 [v1.25.4 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.25.4) ```git checkout v1.25.4``` * 如Kubernetes版本为 v1.25.2, 请使用下面命令切换 [v1.25.2 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.25.2) ```git checkout v1.25.2``` * 如Kubernetes版本为 v1.25.0, 请使用下面命令切换 [v1.25.0 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.25.0) ```git checkout v1.25.0``` * 如Kubernetes版本为 v1.24.2, 请使用下面命令切换 [v1.24.2 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.24.2) ```git checkout v1.24.2``` * 如Kubernetes版本为 v1.24.0, 请使用下面命令切换 [v1.24.0 分支](https://github.com/AliyunContainerService/k8s-for-docker-desktop/tree/v1.24.0) ```git checkout v1.24.0``` 注： * 如果发现K8s版本尚未提供，您可以修改```images.properties```文件指明所需镜像版本，并欢迎提交 Pull Request * 通过如下命令可以获取指定K8s版本所需镜像 ```kubeadm config images list --kubernetes-version v1.30.2``` * 可以访问 Docker Hub 获取所需如下镜像版本 tag [docker/desktop-kubernetes](https://hub.docker.com/r/docker/desktop-kubernetes/tags), [docker/desktop-vpnkit-controller](https://hub.docker.com/r/docker/desktop-vpnkit-controller/tags), [docker/desktop-storage-provisioner](https://hub.docker.com/r/docker/desktop-storage-provisioner/tags) 。 * 欢迎体验阿里云容器服务 阿里云容器计算服务 ACS （Alibaba Cloud Container Compute Service，ACS）, 开启云上Kubernetes实践之旅。https://www.aliyun.com/product/acs ### 开启 Kubernetes 为 Kubernetes 配置 CPU 和 内存资源，建议分配 4GB 或更多内存。  从阿里云镜像服务下载 Kubernetes 所需要的镜像 在 Mac 上执行如下脚本 ```bash ./load_images.sh ``` 在Windows上，使用 PowerShell ```powershell .\load_images.ps1 ``` 说明: * 如果因为安全策略无法执行 PowerShell 脚本，请在 “以管理员身份运行” 的 PowerShell 中执行 ```Set-ExecutionPolicy RemoteSigned``` 命令。 * 如果需要，可以通过修改 ```images.properties``` 文件自行加载你自己需要的镜像 开启 Kubernetes，并等待 Kubernetes 开始运行  **TIPS**： 在Mac上: 如果在Kubernetes部署的过程中出现问题，可以通过docker desktop应用日志获得实时日志信息： ```bash 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)](https://github.com/docker/for-win/issues/3769#issuecomment-486046718) 或 [Issue 3649(comment)](https://github.com/docker/for-mac/issues/3649#issuecomment-497441158) * 在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)](https://github.com/docker/for-win/issues/1962#issuecomment-431091114) **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) ```shell kubectl config use-context docker-desktop ``` 验证 Kubernetes 集群状态 ```shell kubectl cluster-info kubectl get nodes ``` ### 配置 Kubernetes 控制台 #### 部署 Kubernetes dashboard ```shell kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.5.1/aio/deploy/recommended.yaml ``` 或 ```shell kubectl apply -f kubernetes-dashboard.yaml ``` 检查 kubernetes-dashboard 应用状态 ```shell kubectl get pod -n kubernetes-dashboard ``` 开启 API Server 访问代理 ```shell kubectl proxy ``` 通过如下 URL 访问 Kubernetes dashboard http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/ #### 配置控制台访问令牌 授权`kube-system`默认服务账号 ```shell kubectl apply -f kube-system-default.yaml ``` 对于Mac环境 ```shell TOKEN=$(kubectl -n kube-system describe secret default| awk '$1=="token:"{print $2}') kubectl config set-credentials docker-desktop --token="${TOKEN}" echo $TOKEN ``` 对于Windows环境 ```shell $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 [源地址安装说明](https://github.com/kubernetes/ingress-nginx/blob/master/docs/deploy/index.md) 验证 ```shell kubectl get pods --all-namespaces -l app.kubernetes.io/name=ingress-nginx ``` #### 测试示例应用 部署测试应用，详情参见[社区文章](https://matthewpalmer.net/kubernetes-app-developer/articles/kubernetes-ingress-guide-nginx-example.html) ```shell kubectl create -f sample/apple.yaml kubectl create -f sample/banana.yaml kubectl create -f sample/ingress.yaml ``` 测试示例应用 ```bash