place1/kube-tools

Kube Tools 镜像文档

镜像概述

Kube Tools 镜像基于 docker:stable 构建，集成了一系列 Kubernetes 及容器相关的 CLI 工具，旨在为开发和运维人员提供一个开箱即用的一站式操作环境，减少工具安装与配置的时间成本。

核心功能与特性

该镜像包含以下关键工具：

• 容器工具：docker (基于 docker:stable)
• Kubernetes 工具：kubectl、skaffold、helm
• 云原生工具：pulumi、vault、aws-iam-authenticator
• 基础工具：bash (默认入口点)、git、openssh、nodejs、npm、curl、jq
• 兼容性工具：libc6-compat (用于 Golang 二进制文件兼容)

使用场景

• Kubernetes 集群日常管理与操作（通过 kubectl 执行命令）
• 应用部署与发布（使用 helm 管理 Helm Chart，skaffold 实现持续部署）
• CI/CD 流程集成（作为构建或部署阶段的运行环境）
• 云资源管理与配置（通过 pulumi 进行基础设施即代码操作）
• 安全凭证管理（使用 vault 处理敏感信息）

使用方法

基本运行方式

通过以下命令启动容器并进入交互式 bash 环境：

bash
docker run -it --rm kube-tools:latest bash

挂载配置文件

为使工具能访问本地配置（如 Kubernetes 集群配置、Docker 凭证等），建议挂载相关目录：

bash
docker run -it --rm \
  -v ~/.kube:/root/.kube \          # 挂载 Kubernetes 配置
  -v ~/.docker:/root/.docker \      # 挂载 Docker 配置
  -v ~/.ssh:/root/.ssh \            # 挂载 SSH 密钥（用于 git 操作）
  -v ~/.vault:/root/.vault \        # 挂载 Vault 配置
  kube-tools:latest bash

执行具体命令

可直接在容器中执行工具命令，例如：

bash
# 检查 kubectl 版本
docker run --rm kube-tools:latest kubectl version --client

# 使用 helm 列出已安装的 Chart
docker run --rm -v ~/.kube:/root/.kube kube-tools:latest helm list --all-namespaces

在 CI/CD 中使用

可作为 CI/CD 流水线的执行环境，例如在 GitLab CI 中：

yaml
deploy-job:
  image: kube-tools:latest
  script:
    - kubectl apply -f k8s/deployment.yaml
    - helm upgrade my-app ./charts/my-app --namespace default

注意事项

• 镜像中的工具版本与基础镜像 docker:stable 保持一致，如需特定版本，建议通过 docker run 命令中的参数或自定义 Dockerfile 调整。
• 敏感配置文件（如 ~/.kube/config、~/.vault）挂载时需确保权限正确，避免容器内权限问题。
• nodejs 和 npm 可用于运行前端构建脚本或 Node.js 相关工具链。