Kubernetes 安装常见问题FAQ

不念不忘少年蓝@ 2022-05-21 07:46 267阅读 0赞

### 文章目录 ###

*  Kubernetes 安装常见问题FAQ
 *   *  前言
     *  Linux 问题
     *   *  Swap 问题
         *  SELinux 问题
         *  Firewalld 问题
         *  重启后问题
         *  端口问题
         *  磁盘空间问题
         *  内存问题
         *  CPU问题
     *  Docker问题
     *   *  Docker版本问题
         *  cgroup问题
     *  XX上网问题
     *   *  gcr.io 镜像拉取问题
     *  网络问题
     *   *  访问官方CentOS Yum源慢
         *  访问官方Docker Yum慢或Docker镜像仓库慢
         *  访问官方Kubernetes Yum源慢
         *  网络重名问题
     *  文档问题
     *   *  Kubernetes 官方文档不详细或不同步
     *  参考文档
     *  后记
     *   *  一键部署Kubernetes集群

# Kubernetes 安装常见问题FAQ #

## 前言 ##

整理了Kubernetes集群安装过程中的常见问题FAQ。

常见问题可以分为以下几类：

*  Linux 问题
 *  Docker 问题
 *  科学上网问题
 *  网络问题
 *  文档问题

## Linux 问题 ##

以CentOS7为例。

### Swap 问题 ###

Q: 如果不禁用Swap，将会导致kubelet不能正常工作。

运行`journalctl -xefu kubelet` 查看kubelet日志，检查kubelet启动失败的原因是不是因为Swap没有被禁用。

如果是Swap没有被禁用导致kubelet出错，请参考下面步骤：

检查Swap：

# 查看Swap
    free -m
    cat /proc/swaps

临时禁用Swap，机器重启后不生效：

# 关闭Swap，机器重启后不生效
    swapoff -a

永久禁用Swap：

# 修改/etc/fstab永久关闭Swap
    # Redhat
    sed -i "s/\/dev\/mapper\/rhel-swap/\#\/dev\/mapper\/rhel-swap/g" /etc/fstab
    # CentOS
    sed -i "s/\/dev\/mapper\/centos-swap/\#\/dev\/mapper\/centos-swap/g" /etc/fstab
    # 修改后重新挂载全部挂载点
    mount -a

### SELinux 问题 ###

Q: 如果不禁用SELinux，可能会导致Kubernetes集群无法正常安装。

需要禁用SELinux的原因：

> Disabling SELinux by running `setenforce 0` is required to allow containers to access the host filesystem, which is required by pod networks for example. You have to do this until SELinux support is improved in the kubelet.

在安全的环境中，可以将SELinux永久关闭。

查看SELinux状态：

# Permissive 表示SELinux已经被关闭；Enfocing 表示SELinux为打开状态
    getenforce

运行`setenforce 0` 临时关闭SELinux。

永久关闭SELinux：

sed -i "s/SELINUX=enforcing/SELINUX=disabled/g" /etc/selinux/config

### Firewalld 问题 ###

Q: 如果不禁用Firewalld防火墙，可能会导致Kubernetes集群不能正常工作。

A: Kubernetes的Master和Node之间有大量的网络通信，安全的做法是在防火墙上配置各组件需要相互通信的端口，在安全的网络环境中较为简单的做法是禁用Firewalld防火墙。

运行`systemctl status firewalld` 查看Firewalld防火墙状态。

禁用Firewalld防火墙：

systemctl stop firewalld
    systemctl disable firewalld

### 重启后问题 ###

Q: 重启Linux后，Kubernetes 集群不能正常工作。

A: 运行`journalctl -xefu kubelet` 查看kubelet日志, 和运行`kubectl describe` 命令查看出错的Pod等资源的错误信息来定位问题。

常见的原因是在上面的Linux问题中只是临时禁用了配置项，并没有做到永久禁用。

### 端口问题 ###

Q: 端口被禁止或被占用都可能导致Kubernetes集群不能正常工作。

A: 请参考 [https://kubernetes.io/docs/tasks/tools/install-kubeadm/][https_kubernetes.io_docs_tasks_tools_install-kubeadm] ， 搜索"Check required ports" 查看Kubernetes必须的端口。

可以在Linux上运行`netstat -tnlp` 目前的端口使用情况。

### 磁盘空间问题 ###

Q: 如果磁盘空间不足，也会导致Kubernetes集群不能正常工作。

A: 可以通过`df -h` 命令查看磁盘分区使用情况，也可以通过`du -sh` 命令查看目录和文件大小。

### 内存问题 ###

Q: 如果内存不足，也会导致Kubernetes集群不能正常工作。

A: 可以使用`top` 命令、`free -mh` 命令或`vmstat 3` 命令查看内存情况。

### CPU问题 ###

Q: 如果CPU负载过高，也会导致Kubernetes集群不能正常工作。

A: 可以使用`top` 命令、或`vmstat 3` 命令查看CPU负载情况。

## Docker问题 ##

### Docker版本问题 ###

Q: 使用Kubernetes不支持的Docker版本可能会导致未知问题。

A: Kubernetes 目前（v1.11.0) 推荐的最新的Docker版本是17.03。

> On each of your machines, install Docker. Version 17.03 is recommended, but 1.11, 1.12 and 1.13 are known to work as well. Versions 17.06+ *might work*, but have not yet been tested and verified by the Kubernetes node team. Keep track of the latest verified Docker version in the Kubernetes release notes.

可以通过`kubectl version` 查看Kubernetes版本，通过`docker version` 查看Docker版本。

### cgroup问题 ###

Q: 如果kubelet的cgroup和Docker的cgroup不一致，会导致Kubernetes集群无法正常工作。

A: 需要保持kubelet的cgroup和Docker的cgroup一致。

运行`docker info | grep -i cgroup` 查看Docker的cgroup。

运行`ps -ef | grep kubelet | grep -i cgroup` 查看kubelet的cgroup。

如果kubelet的cgroup和Docker的cgroup不一致，运行下面的命令修改kubelet的cgroup：

sed -i "s/cgroup-driver=systemd/cgroup-driver=cgroupfs/g" /etc/systemd/system/kubelet.service.d/10-kubeadm.conf

修改cgroup后需要通过以下命令重启kubelet。

systemctl daemon-reload
    systemctl restart kubelet

## XX上网问题 ##

### gcr.io 镜像拉取问题 ###

Q: 在安装Kubernetes时会因为无法拉取gcr.io镜像，导致安装过程一直等待或报出无关错误。

A: 在已知镜像名称和标签的情况，可以通过阿里云镜像仓库 + GitHub 用Dockerfile重新打包gcr.io 镜像，然后安装时从阿里云镜像仓库直接下载再重命名为gcr.io镜像。

在未知镜像名称和标签的情况，需要先找一台可以科学上网的机器来装一遍，再通过`docker images` 查看准确的镜像名称和标签。

参考文档：

*  [Kubernetes国内镜像、下载安装包和拉取gcr.io镜像][Kubernetes_gcr.io]
 *  [kubeadm 镜像版本][kubeadm]

## 网络问题 ##

### 访问官方CentOS Yum源慢 ###

Q: 访问官方CentOS Yum源太慢了。

A: 使用阿里云CentOS Yum源。

参考文档：

*  [使用国内Yum源][Yum]

### 访问官方Docker Yum慢或Docker镜像仓库慢 ###

Q: 访问官方Docker Yum源或Docker镜像仓库太慢了。

A: 使用阿里云Docker Yum源和阿里云镜像仓库、镜像加速器。

参考文档：

[Docker国内Yum源和国内镜像仓库][Docker_Yum]

### 访问官方Kubernetes Yum源慢 ###

Q: 访问官方Kubernetes Yum源太慢了。

A: 使用阿里云Kubernetes Yum源。

参考文档：

[Kubernetes国内镜像、下载安装包和拉取gcr.io镜像][Kubernetes_gcr.io]

### 网络重名问题 ###

Q: Hostname、 IP，、Mac地址和product\_uuid重名会导致Kubernetes无法正常工作。

A: 运行`uname -n` 查看Hostname，可以运行`hostnamectl set-hostname` 来修改Hostname。

运行`ip addr show` 查看IP地址，并通过修改`/etc/sysconfig/network-scripts` 目录下的网卡配置文件（比如ifcfg-ens33）来修改IP地址，修改后需要通过`systemctl restart network` 重启网卡。

参考文档：

*  [VMware workstation和VMware fusion安装CentOS7后联网问题][VMware workstation_VMware fusion_CentOS7]

运行`ip link` 查看Mac地址。

运行`sudo cat /sys/class/dmi/id/product_uuid` 查看product\_uuid。

## 文档问题 ##

### Kubernetes 官方文档不详细或不同步 ###

Q: Kubernetes官方文档已经非常详细，但是仍然有不够清楚或不同步的问题。

1.  确保先阅读最新的官方文档，而不是一些过时的中文文档。
2.  通过 [微软必应搜索国际版][Link 1] 来搜，而不要要Baidu来搜。
3.  访问Kubernetes GitHub repository上面的Issue list查看最新的问题反馈：
    
     *  [kubernetes Issues][]
     *  [kubeadm Issues][]
4.  最常见又最怪异的错通常是因为XX的原因，找一台可以XX上网的机器，在VMware虚拟机中先装一遍，看是不是有依赖特别的镜像、包或配置文件。

## 参考文档 ##

*  [https://kubernetes.io/docs/setup/independent/troubleshooting-kubeadm/][https_kubernetes.io_docs_setup_independent_troubleshooting-kubeadm]
 *  [https://kubernetes.io/docs/setup/independent/create-cluster-kubeadm/][https_kubernetes.io_docs_setup_independent_create-cluster-kubeadm]
 *  [https://kubernetes.io/docs/tasks/tools/install-kubeadm/][https_kubernetes.io_docs_tasks_tools_install-kubeadm]

## 后记 ##

### 一键部署Kubernetes集群 ###

为了避免安装Kubernetes过程中重复踩坑，我整理了一键部署Kubernetes集群的脚本，请参见：

[使用kubeadm一键部署kubernetes集群 v1.10.3 v1.11.0][kubeadm_kubernetes_ v1.10.3 v1.11.0]

[https_kubernetes.io_docs_tasks_tools_install-kubeadm]: https://kubernetes.io/docs/tasks/tools/install-kubeadm/
[Kubernetes_gcr.io]: https://blog.csdn.net/nklinsirui/article/details/80581286
[kubeadm]: https://blog.csdn.net/nklinsirui/article/details/80651300
[Yum]: https://blog.csdn.net/nklinsirui/article/details/80146083
[Docker_Yum]: https://blog.csdn.net/nklinsirui/article/details/80490537
[VMware workstation_VMware fusion_CentOS7]: https://blog.csdn.net/nklinsirui/article/category/7630425
[Link 1]: https://cn.bing.com
[kubernetes Issues]: https://github.com/kubernetes/kubernetes/issues
[kubeadm Issues]: https://github.com/kubernetes/kubeadm/issues
[https_kubernetes.io_docs_setup_independent_troubleshooting-kubeadm]: https://kubernetes.io/docs/setup/independent/troubleshooting-kubeadm/
[https_kubernetes.io_docs_setup_independent_create-cluster-kubeadm]: https://kubernetes.io/docs/setup/independent/create-cluster-kubeadm/
[kubeadm_kubernetes_ v1.10.3 v1.11.0]: https://blog.csdn.net/nklinsirui/article/details/80602724