docker-kubectl

![github-actions]([] ![github-release]([] ![docker-image-size]([***]

镜像概述和主要用途

docker-kubectl 是一个容器化的 kubectl 工具，集成了多种实用工具，适用于在容器环境中执行 Kubernetes 集群管理操作。该镜像提供多种 Kubernetes 版本的 kubectl 二进制文件，并可选集成常用辅助工具，避免在本地环境手动安装和配置依赖，简化跨环境的 Kubernetes 资源管理流程。

核心功能和特性

• 多版本支持：提供从 Kubernetes 1.14 到 1.34 等多个版本的 kubectl，满足不同集群版本的兼容性需求。
• 工具集成：部分标签变体预安装了 envsubst、git、jq、kustomize、sops、ssh、yq 等工具，支持配置渲染、资源处理、加密解密等场景。
• 轻量级基础：所有镜像变体均基于 Alpine Linux，镜像体积小，启动速度快。
• 灵活标签：提供基础版（仅含 kubectl）和增强版（含附加工具）两种标签类型，可按需选择。

使用场景和适用范围

• CI/CD 流水线：在自动化部署流程中执行 kubectl 命令，管理 Kubernetes 资源。
• 本地开发环境：快速切换不同版本的 kubectl，避免本地环境版本冲突。
• 多工具协同操作：需结合 git（拉取配置）、jq/yq（JSON/YAML 处理）、kustomize（资源定制）等工具进行 Kubernetes 资源管理的场景。
• 临时集群管理：在无本地 kubectl 安装的环境中，通过容器快速接入并管理 Kubernetes 集群。

标签说明

所有变体均基于 Alpine Linux 构建。

使用方法和配置示例

前置条件

使用前需确保本地环境已安装 Docker，且拥有 Kubernetes 集群的访问配置文件（kubeconfig），通常位于 ~/.kube/config。

Docker Run 命令示例

1. 基础版（仅 kubectl）

执行 kubectl 命令查看集群节点：

docker run --rm -v ~/.kube/config:/root/.kube/config theohbrothers/docker-kubectl:latest get nodes

2. 增强版（含附加工具）

使用 jq 处理 kubectl 输出，提取 Pod 名称：

docker run --rm -v ~/.kube/config:/root/.kube/config theohbrothers/docker-kubectl:1.34.1-envsubst-git-jq-kustomize-sops-ssh-yq \
  sh -c "kubectl get pods -n default -o json | jq -r '.items[].metadata.name'"

3. 挂载本地目录并使用 git 和 kustomize

拉取 Git 仓库中的 Kubernetes 配置，通过 kustomize 构建并应用：

docker run --rm -v ~/.kube/config:/root/.kube/config -v $(pwd):/workspace -w /workspace \
  theohbrothers/docker-kubectl:1.34.1-envsubst-git-jq-kustomize-sops-ssh-yq \
  sh -c "git clone [***] && cd k8s-config && kustomize build . | kubectl apply -f -"

Docker Compose 配置示例

创建 docker-compose.yml 文件，定义一个可交互的 kubectl 环境：

version: '3'
services:
  kubectl:
    image: theohbrothers/docker-kubectl:1.34.1-envsubst-git-jq-kustomize-sops-ssh-yq
    volumes:
      - ~/.kube/config:/root/.kube/config
      - ./k8s-config:/workspace
    working_dir: /workspace
    tty: true  # 启用交互终端
    stdin_open: true  # 保持标准输入打开

启动并进入容器：

docker-compose up -d
docker-compose exec kubectl sh
# 在容器内执行命令，如：kubectl get pods、kustomize build . 等

开发指南

环境要求

需安装 Windows PowerShell 或 pwsh。

生成镜像变体

# 安装 Generate-DockerImageVariants 模块：[***]
Install-Module -Name Generate-DockerImageVariants -Repository PSGallery -Scope CurrentUser -Force -Verbose

# 编辑 ./generate 目录下的模板文件

# 生成镜像变体
Generate-DockerImageVariants .

版本管理

versions.json 文件包含 Semver 版本列表，每行一个版本。

更新 versions.json

./Update-Versions.ps1

自动化版本更新与发布

更新 versions.json 并为每个变更版本创建 PR，自动合并通过检查的 PR，最终创建标签发布并关闭里程碑：

$env:GITHUB_TOKEN = 'xxx'  # 替换为有效的 GitHub Token
./Update-Versions.ps1 -PR -AutoMergeQueue -AutoRelease

测试运行

添加 -WhatIf 参数执行 dry run，验证命令效果：

./Update-Versions.ps1 -WhatIf