kubernetes1122/kube-proxy

k8s.gcr.io/kube-proxy:v1.12.2 镜像文档

镜像概述

k8s.gcr.io/kube-proxy:v1.12.2是Kubernetes集群的核心网络组件镜像，用于在集群每个节点上运行kube-proxy服务。该组件负责维护节点网络规则，实现Kubernetes Service资源的网络代理、负载均衡及流量转发，是保障集群内部服务通信的关键组件。此镜像适用于Kubernetes 1.12版本集群部署。

核心功能与特性

• 网络规则管理：动态维护节点iptables/ipvs规则，实现Service与Pod之间的网络映射
• Service代理：提供Service资源的TCP/UDP流量代理，支持ClusterIP、NodePort等Service类型
• 负载均衡：对Service后端Pod进行流量分发，实现基本负载均衡功能
• 版本兼容性：兼容Kubernetes 1.12版本控制平面组件，支持Docker 1.11.1、1.12.1、1.13.1、17.03、17.06、17.09、18.06等版本

使用场景与适用范围

• Kubernetes 1.12版本集群部署与运维
• 集群节点网络代理服务部署
• Service资源网络规则管理与流量转发
• 需通过kubeadm工具初始化的Kubernetes集群环境

使用方法与配置说明

环境准备（Debian/Ubuntu系统）

1. 更新系统并安装依赖：

   bash
   apt-get update && apt-get install -y apt-transport-https
   

2. 添加Kubernetes apt源（使用阿里云镜像源）：

   bash
   curl https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | apt-key add - 
   cat <<EOF >/etc/apt/sources.list.d/kubernetes.list
   deb https://mirrors.aliyun.com/kubernetes/apt/ kubernetes-xenial main
   EOF  
   

3. 安装kubeadm、kubelet和kubectl：

   bash
   apt-get update
   apt-get install -y kubelet kubeadm kubectl
   

镜像拉取

1. 查看Kubernetes 1.12.2版本所需镜像列表（包含kube-proxy）：

   bash
   kubeadm config images list --kubernetes-version=v1.12.2
   

   输出包含：k8s.gcr.io/kube-proxy:v1.12.2

2. 使用镜像仓库配置拉取（解决国内网络访问限制）： 创建配置文件config.yaml，指定镜像仓库：

   yaml
   apiVersion: kubeadm.k8s.io/v1alpha3
   kind: ClusterConfiguration
   imageRepository: docker.io/kubernetes1122
   kubernetesVersion: v1.12.2
   

3. 拉取镜像：

   bash
   kubeadm config images pull --config=./config.yaml
   

集群初始化与组件部署

1. 使用配置文件初始化Kubernetes集群（包含kube-proxy部署）：

   bash
   sudo kubeadm init --config=./config.yaml
   

2. 初始化成功后，按提示配置kubectl：

   bash
   mkdir -p $HOME/.kube
   sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
   sudo chown $(id -u):$(id -g) $HOME/.kube/config
   

3. 部署网络插件（完成后kube-proxy可正常工作）：

   bash
   kubectl apply -f [网络插件YAML文件]  # 例如Calico、Flannel等，具体参考Kubernetes官方文档
   

节点加入集群

其他节点可通过以下命令加入集群（初始化成功后输出的命令）：

bash
kubeadm join 192.168.137.238:6443 --token <token> --discovery-token-ca-cert-hash sha256:<hash>

常见问题处理

• 镜像拉取失败：检查网络连接或使用国内镜像源（如阿里云、anjia0532/gcr.io_mirror等）
• kubelet启动失败：通过systemctl status kubelet或journalctl -xeu kubelet查看日志
• 控制平面组件异常：使用docker ps -a | grep kube | grep -v pause查看容器状态，通过docker logs <容器ID>检查日志

版本兼容性说明

• 支持的Docker版本：1.11.1、1.12.1、1.13.1、17.03、17.06、17.09、18.06
• 兼容的Kubernetes版本：1.12.x系列
• 操作系统：Debian/Ubuntu等基于apt的Linux发行版