reverend/kubectl-proxy

kubectl proxy边车容器镜像

镜像概述

该Docker镜像基于Alpine Linux构建，集成了Kubernetes命令行工具kubectl，核心功能是运行kubectl proxy服务，作为边车容器（Sidecar）辅助Kubernetes集群内的应用访问Kubernetes API Server。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 内置kubectl：预安装最新稳定版kubectl工具
• 默认代理服务：启动时自动运行kubectl proxy --port=8080，提供API代理
• 边车模式适配：设计用于与主应用容器协同部署，简化API访问配置

使用场景

• Kubernetes集群中Pod内应用需要访问Kubernetes API Server的场景
• 作为边车容器与主应用容器部署，避免主应用直接处理API认证与网络配置
• 开发或测试环境中快速部署kubectl proxy服务，简化API访问流程

使用方法

基本运行方式

通过以下命令启动容器，将本地8080端口映射到容器内的代理服务端口：

bash
docker run -d -p 8080:8080 --name kubectl-proxy sidecar-kubectl-proxy

在Kubernetes中作为边车容器部署

在Pod定义中添加边车容器：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: app-with-proxy
spec:
  containers:
  - name: main-app
    image: your-main-app-image
  - name: kubectl-proxy
    image: sidecar-kubectl-proxy
    ports:
    - containerPort: 8080

自定义代理端口

如需修改代理端口，可覆盖默认命令：

bash
docker run -d -p 8888:8888 --name kubectl-proxy sidecar-kubectl-proxy /kubectl proxy --port=8888

注意事项

• 容器需具备访问Kubernetes API Server的权限，在Kubernetes环境中建议通过ServiceAccount配置RBAC权限
• 如需使用自定义kubeconfig，可通过挂载文件方式注入：-v /path/to/kubeconfig:/root/.kube/config
• 镜像中的kubectl版本为构建时的最新稳定版，如需特定版本，需修改Dockerfile中的版本获取逻辑