Microk8s 安装 与使用指南
我们已经知道，Kubernetes 是基于容器的应用程序的首选编排平台，可以自动部署和扩展这些应用程序，并简化维护操作。但是，Kubernetes也有其自身的复杂性挑战。那么，企业如何利用容器化来解决物联网的复杂性，而不会最终导致Kubernetes更加复杂呢？
Canonical的MicroK8s是一个功能强大的，云原生计算基金会认证的Kubernetes发行版。以下是一些关键原因，我觉得，为什么它已经成为一个强大的企业边缘计算平台：
- 以快照包的形式交付：这些是用于桌面、云和 IoT 的应用程序包，易于安装，并通过自动更新进行保护，并且可以安装在任何支持 snap 的 Linux 发行版上。这使得MicroK8非常适合在构成物联网的各种硬件上运行。
- 严格的限制：这确保了与底层操作系统的完全隔离，以及一个严格安全的生产级 Kubernetes 环境，所有这些都在一个小的占用空间内，非常适合边缘网关。
- 生产级附加组件：Istio，Knative，CoreDNS，Prometheus，Jaeger，Linkerd，Cilium和Helm可作为附加组件使用，这些附加组件易于设置，只需几行命令。
- Kubeflow 还可以作为 MicroK8s 的附加组件，用于改进人工智能 （AI） 和机器学习 （ML） 功能。
凭借其降低复杂性的能力，MicroK8s将加速物联网和边缘部署。将物联网设备视为分布式容器化应用程序，使开发人员能够专注于应用程序而不是基础架构，并使运营团队的生活更轻松。
MicroK8s 允许您将 Kubernetes 安装群集在一起，以便它们可以形成单个群集，并将工作负载放在一个或多个这些节点上。 简而言之，Kubernetes 是：
- 便携式：公共云、私有云、混合云、多云
- 可扩展：模块化、可插拔、可挂钩、可组合
- 自我修复：自动放置、自动重启、自动复制、自动扩展
在本文中，我们将介绍可以在边缘，物联网和设备上运行的轻量级Kbernetes引擎MicroK8。microk8s是一个非常轻量级的k8s发行版，小巧轻量安装快速是他的特点，microk8s是使用snap包安装的，所以他在Ubuntu上的体验是最好的，毕竟microk8s是Canonical公司开发的产品。
以下内容来自：https://docs.microsoft.com/zh-cn/azure/architecture/operator-guides/aks/choose-bare-metal-kubernetes
MicroK8 作为单个快照包交付，可在支持 Snap 支持的 Linux 计算机上轻松安装。 备用安装适用于 Windows、macOS 和 raspberry PI/ARM。 安装后，microk8s 会创建一个单节点群集，该群集可以使用 MicroK8s 工具进行管理。 它使用自己的 kubectl 打包，并且某些加载项可以启用 (，例如 helm、dns、Ingress、metallb 块等) 。 还支持多节点、Windows节点和高可用性 (HA) 方案。 注意事项：
- 有多种资源要求，具体取决于要运行 MicroK8s 的位置。 有关最低资源要求 ，请参阅产品文档 。 例如：
- Ubuntu：4 GB RAM、20 GB 磁盘空间
- Windows：4 GB RAM、40 GB 磁盘空间
- Windows工作负荷仅支持使用 Calico CNI 的 MicroK8s 群集。
- MicroK8s 多节点群集上的每个节点都需要其自己的环境才能运行，无论是单个计算机上的单独 VM 还是容器，还是同一网络上的其他计算机。
- 在某些 ARM 硬件上运行 MicroK8s 时，可能会出现困难。 参考 文档 以获取潜在的补救措施。
在国内由于众所周知的原因，安装microk8s后会发现 gcr.io的docker image无法下载的问题.(详细安装步骤参见 https://microk8s.io/#quick-start)，首先需要安装 pullk8s 工具，此工具可以通过 hub.docker.com 的 opsdockerimage 仓库下载k8s所需的 k8s.gcr.io 或 gcr.io 镜像，每天更新一次，包括所有image 的全平台的所有tags。
git clone https://github.com/OpsDocker/pullk8s.git
cd pullk8s
sudo cp pullk8s /usr/local/bin/pullk8s
sudo chmod +x /usr/local/bin/pullk8s如果您需要修改 hostname，可执行如下指令：
修改 hostname hostnamectl set-hostname your-new-host-name 查看修改结果 hostnamectl status
在下面的步骤中，我们将安装MicroK8s集群，它将安装一组有限的组件，如api-server，controller-manager，scheduler，kubelet，cni，kube-proxy。其他服务，如 kube-dns 和 dashboard 也可以使用 microk8s.enable 命令运行。
ubuntu@VM-0-8-ubuntu:~$ sudo snap install microk8s --classic --channel=1.21/stable
microk8s (1.21/stable) v1.21.11 from Canonical✓ installed详细的权限设置可以 参看 microk8s 官网 https://microk8s.io/docs， 出于简化的目的，我们可以用 kubectl 替代 microk8s.kubectl
ubuntu@VM-0-8-ubuntu:~$ sudo snap alias microk8s.kubectl kubectl
Added:
- microk8s.kubectl as kubectl检查microk8s 是否安装成功：
ubuntu@VM-0-8-ubuntu:~$ sudo kubectl get nodes -w
NAME STATUS ROLES AGE VERSION
microk8snode NotReady <none> 2m19s v1.21.11-3+2bdf0a81ac1652
^Cubuntu@VM-0-8-ubuntu:~sudo kubectl describe node microk8snode
Name: microk8snode
Roles: <none>
Labels: beta.kubernetes.io/arch=amd64
beta.kubernetes.io/os=linux
kubernetes.io/arch=amd64
kubernetes.io/hostname=microk8snode
kubernetes.io/os=linux
microk8s.io/cluster=true
Annotations: node.alpha.kubernetes.io/ttl: 0
volumes.kubernetes.io/controller-managed-attach-detach: true
CreationTimestamp: Sat, 30 Apr 2022 20:47:49 +0800
Taints: node.kubernetes.io/not-ready:NoSchedule
Unschedulable: false
Lease:
HolderIdentity: microk8snode
AcquireTime: <unset>
RenewTime: Sat, 30 Apr 2022 20:50:31 +0800
Conditions:
Type Status LastHeartbeatTime LastTransitionTime Reason Message
---- ------ ----------------- ------------------ ------ -------
MemoryPressure False Sat, 30 Apr 2022 20:47:59 +0800 Sat, 30 Apr 2022 20:47:49 +0800 KubeletHasSufficientMemory kubelet has sufficient memory available
DiskPressure False Sat, 30 Apr 2022 20:47:59 +0800 Sat, 30 Apr 2022 20:47:49 +0800 KubeletHasNoDiskPressure kubelet has no disk pressure
PIDPressure False Sat, 30 Apr 2022 20:47:59 +0800 Sat, 30 Apr 2022 20:47:49 +0800 KubeletHasSufficientPID kubelet has sufficient PID available
Ready False Sat, 30 Apr 2022 20:47:59 +0800 Sat, 30 Apr 2022 20:47:49 +0800 KubeletNotReady container runtime network not ready: NetworkReady=false reason:NetworkPluginNotReady message:Network plugin returns error: cni plugin not initialized
Addresses:
InternalIP: 10.0.0.8
Hostname: microk8snode发现错误是 container runtime network not ready: NetworkReady=false reason:NetworkPluginNotReady message:Network plugin returns error: cni plugin not initialized：具体原因就是拉镜像拉不到，具体可以看https://github.com/canonical/microk8s/issues/2042。我们就需要使用pullk8s 工具来解决，这个工具依赖docker 来拉镜像，安装好docker，然后运行 pullk8s check --microk8s检查被屏蔽的 gcr.io 或 k8s.gcr.io 容器名称：ubuntu@VM-0-8-ubuntu:~/pullk8s$ sudo snap install docker
docker 20.10.12 from Canonical✓ installed
ubuntu@VM-0-8-ubuntu:~/pullk8s$ sudo pullk8s check --microk8s
k8s.gcr.io/pause:3.1使用 pullk8s 拉取失败的镜像，并导入到 pod 空间中
buntu@VM-0-8-ubuntu:~/pullk8s$ sudo pullk8s pull k8s.gcr.io/pause:3.1 --microk8s
Pull pause:3.1 ...
Pull pause:3.1 ...
3.1: Pulling from opsdockerimage/pause
67ddbfb20a22: Pull complete
Digest: sha256:f78411e19d84a252e53bff71a4407a5686c46983a2c2eeed83929b888179acea
Status: Downloaded newer image for opsdockerimage/pause:3.1
docker.io/opsdockerimage/pause:3.1
Untagged: opsdockerimage/pause:3.1
Untagged: opsdockerimage/pause@sha256:f78411e19d84a252e53bff71a4407a5686c46983a2c2eeed83929b888179acea
unpacking k8s.gcr.io/pause:3.1 (sha256:0968e31df05b727234888883ba43ccaa4ec75566113c75065af5a6124b62d93c)...done查看Pod运行状态
ubuntu@VM-0-8-ubuntu:~/pullk8s$ sudo kubectl get nodes
NAME STATUS ROLES AGE VERSION
microk8snode Ready <none> 84m v1.21.11-3+2bdf0a81ac1652根据自己的需要，安装仪表板、DNS、私有化Registry、流量及路由控制器等k8s组件
ubuntu@VM-0-8-ubuntu:~/pullk8s$ sudo microk8s enable dashboard dns registry
Enabling Kubernetes Dashboard
Enabling Metrics-Server
clusterrole.rbac.authorization.k8s.io/system:aggregated-metrics-reader created
clusterrolebinding.rbac.authorization.k8s.io/metrics-server:system:auth-delegator created
rolebinding.rbac.authorization.k8s.io/metrics-server-auth-reader created
Warning: apiregistration.k8s.io/v1beta1 APIService is deprecated in v1.19+, unavailable in v1.22+; use apiregistration.k8s.io/v1 APIService
apiservice.apiregistration.k8s.io/v1beta1.metrics.k8s.io created
serviceaccount/metrics-server created
deployment.apps/metrics-server created
service/metrics-server created
clusterrole.rbac.authorization.k8s.io/system:metrics-server created
clusterrolebinding.rbac.authorization.k8s.io/system:metrics-server created检查组件的Pod是否安装成功，发现metrics-server 镜像拉不到
ubuntu@VM-0-8-ubuntu:~/pullk8s$ sudo kubectl get pods -n kube-system
NAME READY STATUS RESTARTS AGE
dashboard-metrics-scraper-78d7698477-64rpc 1/1 Running 1 14m
hostpath-provisioner-566686b959-m8fff 1/1 Running 1 14m
kubernetes-dashboard-85fd7f45cb-5c8x7 1/1 Running 1 14m
calico-kube-controllers-f7868dd95-nxfzn 1/1 Running 1 101m
calico-node-58n5l 1/1 Running 1 101m
coredns-7f9c69c78c-9nt4g 1/1 Running 1 14m
metrics-server-8bbfb4bdb-qj75c 0/1 ImagePullBackOff 0 16m使用 pullk8s 拉取失败的镜像，并导入到 pod 空间中
ubuntu@VM-0-8-ubuntu:~/pullk8s$ sudo pullk8s check --microk8s
k8s.gcr.io/metrics-server-amd64:v0.3.6
ubuntu@VM-0-8-ubuntu:~/pullk8s$ sudo pullk8s pull k8s.gcr.io/metrics-server-amd64:v0.3.6 --microk8s
Pull metrics-server-amd64:v0.3.6 ...
Pull metrics-server-amd64:v0.3.6 ...
v0.3.6: Pulling from opsdockerimage/metrics-server-amd64
e8d8785a314f: Pull complete
b2f4b24bed0d: Pull complete
Digest: sha256:c9c4e95068b51d6b33a9dccc61875df07dc650abbf4ac1a19d58b4628f89288b
Status: Downloaded newer image for opsdockerimage/metrics-server-amd64:v0.3.6
docker.io/opsdockerimage/metrics-server-amd64:v0.3.6
Untagged: opsdockerimage/metrics-server-amd64:v0.3.6
Untagged: opsdockerimage/metrics-server-amd64@sha256:c9c4e95068b51d6b33a9dccc61875df07dc650abbf4ac1a19d58b4628f89288b
unpacking k8s.gcr.io/metrics-server-amd64:v0.3.6 (sha256:c9cdfb8ea4ace4b65a9a151086e2d3903b22c5c40b01e5b097db73bd3d90d19e)...done查看Pod运行状态，全部正常：
ubuntu@VM-0-8-ubuntu:~/pullk8s$ sudo kubectl get pods -n kube-system
NAME READY STATUS RESTARTS AGE
dashboard-metrics-scraper-78d7698477-64rpc 1/1 Running 1 25m
hostpath-provisioner-566686b959-m8fff 1/1 Running 1 25m
kubernetes-dashboard-85fd7f45cb-5c8x7 1/1 Running 1 25m
calico-kube-controllers-f7868dd95-nxfzn 1/1 Running 1 111m
calico-node-58n5l 1/1 Running 1 111m
coredns-7f9c69c78c-9nt4g 1/1 Running 1 25m
metrics-server-8bbfb4bdb-qj75c 1/1 Running 0 26m查看microk8s状态
microk8s status
访问仪表板
1. 获取 token 密钥
# token=$(microk8s kubectl -n kube-system get secret | grep default-token | cut -d " " -f1)
# microk8s kubectl -n kube-system describe secret $token2. 映射端口到外部网卡
# microk8s kubectl port-forward -n kube-system --address=0.0.0.0 service/kubernetes-dashboard 10443:4433. 浏览器访问
其他常用命令：
命令 | 说明 |
|---|---|
microk8s dashboard-proxy | 配置仪表板访问代理 |
microk8s start | 启动 microk8s |
microk8s stop | 停止 microk8s |
snap alias microk8s.kubectl kubectl | 设置别名 |
microk8s kubectl get all --all-namespace | 查看所有命名空间所有pod及服务的状态 |
配置 microk8s 内置 docker 的 registry.mirrors
编辑 /var/snap/microk8s/current/args/containerd-template.toml 文件 在 endpoint 添加 新的 国内 registry.mirrors ， 如 "https://docker.mirrors.ustc.edu.cn"
...
[plugins.cri.registry]
[plugins.cri.registry.mirrors]
[plugins.cri.registry.mirrors."docker.io"]
endpoint = [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com",
"https://mirror.ccs.tencentyun.com",
"https://registry-1.docker.io"
]部署示例应用程序
此时，您拥有一个功能齐全的 Kubernetes 集群。以下命令将部署nginx Web应用程序。
kubectl create deployment nginx --image=nginx:alpine --replicas=1
部署 nginx 后，可以使用以下命令公开应用程序。
kubectl expose deployment nginx --port 80 –target-port 80 --type NodePort --selector=app=nginx --name nginx
我们可以启动lynx，一个基于终端的Web浏览器，使用以下命令访问Nginx应用程序。
MicroK8s 为您提供了故障排除工具，以检查出了什么问题。请务必查看常见问题部分，以获取有关解决常见问题的帮助。
通过下列命令来设置 kubeconfig 文件：
cd $HOME
mkdir .kube
cd .kube
microk8s config > config