octopusdeploy/kubectl

kubectl工具容器镜像

镜像概述

该镜像为实用工具容器，预安装了kubectl命令行工具，旨在简化在Kubernetes集群环境中运行脚本的流程。通过该容器，用户可直接执行与Kubernetes集群交互的脚本，无需在本地环境单独配置kubectl及相关依赖。

核心功能和特性

• 内置kubectl工具：预安装最新稳定版kubectl，支持标准Kubernetes集群操作命令
• 轻量级设计：基于精简基础镜像构建，减少资源占用
• 脚本执行支持：可直接运行外部挂载的Shell/Python等类型脚本
• 集群兼容性：兼容主流Kubernetes版本（1.21+）
• 配置灵活性：支持通过环境变量或挂载文件自定义kubectl配置

使用场景和适用范围

• Kubernetes集群自动化运维脚本执行
• CI/CD流水线中的集群资源操作（如部署、伸缩、状态检查）
• 临时集群管理任务（如批量资源创建、日志收集、故障排查）
• 跨环境集群操作脚本的统一运行环境
• 开发/测试环境中的Kubernetes API交互验证

使用方法和配置说明

基本运行方法

通过挂载本地kubeconfig文件连接集群并执行kubectl命令：

bash
docker run -v /path/to/local/kubeconfig:/root/.kube/config my-kubectl-utility:latest kubectl get pods --all-namespaces

执行自定义脚本

挂载脚本目录并运行指定脚本：

bash
docker run -v /path/to/kubeconfig:/root/.kube/config -v /path/to/scripts:/scripts my-kubectl-utility:latest /scripts/deploy-app.sh

docker-compose配置示例

yaml
version: '3.8'
services:
  kubectl-script:
    image: my-kubectl-utility:latest
    volumes:
      - ./kubeconfig:/root/.kube/config  # 挂载集群配置
      - ./cluster-scripts:/scripts       # 挂载脚本目录
    environment:
      - KUBECTL_NAMESPACE=default        # 默认命名空间
      - LOG_LEVEL=info                   # 日志级别
    command: /scripts/cleanup-resources.sh  # 要执行的脚本路径

环境变量配置

高级使用技巧

1. 持久化配置：通过数据卷挂载/root/.kube目录，保存kubectl配置和历史记录
2. 交互式操作：添加-it参数进入容器交互式终端：

   bash
   docker run -it -v /path/to/kubeconfig:/root/.kube/config my-kubectl-utility:latest /bin/sh
   

3. 定时任务集成：结合crontab或Kubernetes CronJob，定期执行集群维护脚本

注意事项

• 确保挂载的kubeconfig文件具有足够权限执行目标操作
• 生产环境中建议使用非root用户运行容器，可通过--user参数指定
• 定期更新镜像以获取kubectl安全补丁和功能更新