Debian K8S部署常见问题

在Debian上部署Kubernetes（K8s）时可能会遇到一些常见问题。以下是一些常见问题及其解决方案：

1. 服务访问失败

• 原因分析：可能是由于证书问题、端口映射错误、服务类型设置不正确等原因。
• 解决方法：检查证书是否正确配置，必要时更新证书。检查端口映射是否正确，删除并重新创建服务（kubectl delete svc service-name）。如果服务类型为 ClusterIP，确保外网可以访问，或者修改为 NodePort 类型。

2. Pod状态为 ErrImagePull

• 原因分析：可能是镜像不存在或镜像标签错误。
• 解决方法：检查镜像名称和标签是否正确。确保镜像存在于指定的仓库中，并且可以访问。如果使用私有仓库，确保 /etc/docker/certs.d/ 目录下有正确的证书文件。

3. 节点无法注册到Master节点

• 原因分析：可能是Token失效或配置文件错误。
• 解决方法：在Master节点上重新生成Token和配置文件，然后重新加入节点。确保 /etc/kubernetes/admin.conf 文件权限正确，并且 kubectl 配置正确。

4. 网络插件问题

• 原因分析：可能是网络插件配置文件错误或网络参数设置不正确。
• 解决方法：删除现有网络插件的配置文件和残留文件，然后重新部署。确保网络参数（如IP转发）已正确设置。

5. 内核参数问题

• 原因分析：可能是内核模块缺失或配置错误。
• 解决方法：加载必要的内核模块，如 br_netfilter。确保 /proc/sys/net/ipv4/ip_forward 设置为1。

6. Docker版本不匹配

• 原因分析：Docker版本与Kubernetes版本不兼容。
• 解决方法：安装与Kubernetes版本兼容的Docker版本。如果必须使用新版本Docker，可能需要降级Kubernetes组件到兼容的版本。

7. 资源不足

• 原因分析：节点磁盘空间不足，导致Pod被驱逐（Evicted）。
• 解决方法：清理磁盘空间，删除不必要的文件。增加节点磁盘空间或扩展存储。

8. kubectl 调试使用问题

• 原因分析：在生产环境中，需要对正在运行的Pod进行调试。
• 解决方法：使用 kubectl debug 命令进入Pod的调试模式，添加调试工具进行故障排查。

9. 时区不一致问题

• 解决方法：在部署工作负载时为容器指定TZ环境变量，例如：

  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: app
  spec:
    replicas: 1
    selector:
      matchLabels:
        app: app
    template:
      metadata:
        labels:
          app: app
      spec:
        containers:
        - name: app
          image: app
          env:
          - name: TZ
            value: Asia/Shanghai
  

  或者在Dockerfile里设置时区：

  FROM ubuntu:latest
  RUN apt update -y && \
      DEBIAN_FRONTEND="noninteractive" apt -y install tzdata && \
      ln -fs /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
      dpkg-reconfigure -f noninteractive tzdata
  

10. 证书问题

• 解决方法：如果使用自定义证书且证书不能被识别，可以尝试更新证书或禁用SSL验证（不推荐在生产环境中使用）。

11. 端口映射错误

• 解决方法：检查服务端口映射是否正确，删除并重新创建Service。

12. 网络故障

• 解决方法：检查网络连接，使用 ping 命令测试网络连接，确保系统可以访问外部网络。检查iptables，确保iptables配置正确，特别是在安装Docker时。

13. 文件系统问题

• 解决方法：检查和修复文件系统，使用 fsck 命令检查和修复文件系统，特别是在非正常关机后。

14. Kubernetes集群初始化失败

• 解决方法：确保关闭swap、防火墙，并正确配置sysctl参数和内核参数。添加镜像源，确保Kubernetes组件的镜像源配置正确，并更新源。

通过了解和解决这些常见问题，可以提高Kubernetes在Debian上的部署稳定性和安全性。