devopscorner/k8s-context

Kubernetes Change Context (k8s-context)

定制Kubernetes上下文切换（KUBECONFIG）工具镜像

!https://goreportcard.com/badge/github.com/devopscorner/k8s-context/src !all contributors !tags !download all !download latest !view !https://img.shields.io/badge/dynamic/json?color=success&label=clone&query=count&url=https://github.com/devopscorner/k8s-context/blob/master/clone.json?raw=True&logo=github !issues !pull requests !forks !stars ![license]([***]

---

镜像概述

k8s-context是一款用于定制Kubernetes上下文切换的工具镜像，旨在简化多Kubernetes集群环境下的配置管理。通过该镜像可便捷地合并、加载、切换KUBECONFIG文件，管理多个集群上下文，并支持查询和操作Kubernetes资源，适用于开发、测试及CI/CD场景中快速切换集群环境。

核心功能与特性

• KUBECONFIG管理：支持合并多个kubeconfig文件为单一配置，加载指定目录下的配置文件
• 上下文切换：交互式选择并切换Kubernetes集群上下文，支持指定kubeconfig文件路径
• 资源查询：查询Kubernetes核心资源（命名空间、服务、部署、Pod等），支持多命名空间过滤
• 资源详情：查看Pod日志、端口转发、节点信息等资源详情
• 多环境支持：基于Alpine构建，体积小巧，支持多种标签版本（含特定Golang和Alpine版本）

使用场景

• 多Kubernetes集群环境管理（开发/测试/生产集群切换）
• CI/CD管道中集成，实现跨集群部署与资源操作
• 开发环境快速切换不同集群上下文，简化多集群资源查询

可用标签

Alpine（活跃版本）

Alpine（已弃用版本）

命令帮助

 _    ___                            _            _
| | _( _ ) ___        ___ ___  _ __ | |_ _____  _| |_
| |/ / _ \/ __|_____ / __/ _ \| '_ \| __/ _ \ \/ / __|
|   < (_) \__ \_____| (_| (_) | | | | ||  __/>  <| |_
|_|\_\___/|___/      \___\___/|_| |_|\__\___/_/\_\\__|


===================================
[[  K8S-CONTEXT (K8C)  ]] - v1.1.9
===================================
用法:
  k8s-context [命令]

可用命令:
  completion  为指定shell生成自动补全脚本
  get         获取Kubernetes资源(ns, svc, deploy, po)
  help        查看命令帮助
  list        列出所有可用的Kubernetes上下文
  load        加载kubeconfig文件
  merge       合并多个kubeconfig文件
  show        描述/显示Kubernetes资源(po, logs, port, node)
  switch      切换到不同上下文
  version     打印k8s-context版本号

标志:
  -h, --help                k8s-context帮助
      --kubeconfig string   kubeconfig文件路径(默认 "/home/devopscorner/.kube/config")

使用 "k8s-context [命令] --help" 获取命令详情。

使用方法与配置说明

基本使用流程

1. 获取工具（从源码构建）

bash
# 克隆仓库
git clone https://github.com/devopscorner/k8s-context.git
# 或
git clone git@github.com:devopscorner/k8s-context.git

# 初始化
cd k8s-context
make init
# 或
cd src && go mod tidy

2. 设置环境变量

bash
export GO_APP=k8s-context
export SOURCES=$(sh find . -name '*.go' | grep -v /vendor/)
export VERSION=$(sh git describe --tags --always --dirty)
export GOPKGS=$(sh go list ./ | grep -v /vendor/)
export GO111MODULE=on
export LDFLAGS=-X github.com/devopscorner/k8s-context/config.Version=$(VERSION) -w -s

# Linux x86
export GOARCH=amd64
export GOOS=linux

# Mac Intel
export GOOS=darwin
export GOARCH=amd64

# Mac M1/M2 (Arm)
export GOOS=darwin
export GOARCH=arm64

3. 构建二进制文件

bash
# Linux x86
make build

# Mac Intel
make build-mac-amd

# Mac M1/M2 (Arm)
make build-mac-arm

# 或手动构建
cd src
GO111MODULE=$(GO111MODULE) GOOS=$(GOOS) GOARCH=$(GOARCH) CGO_ENABLED=0 go build -o build/$(GO_APP) $(BUILD_FLAGS) -ldflags "$(LDFLAGS)" ./main.go

4. 运行工具

bash
cd src/build
./k8c  # 查看命令帮助

核心命令示例

合并多个kubeconfig文件

bash
# 合并多个配置到默认kubeconfig
./k8c merge $HOME/.kube/config $HOME/.kube/config-staging-dev $HOME/.kube/config-staging-uat

加载并选择kubeconfig文件（