hacklab/kubectl

kubectl Docker镜像

镜像概述和主要用途

该镜像将kubectl工具封装在Docker容器中，提供独立、隔离的Kubernetes命令行环境，用于执行Kubernetes集群管理操作。适用于需要在容器化环境中集成kubectl命令的场景，尤其适合持续部署流程中的自动化操作。

核心功能和特性

• 独立环境：无需在主机系统安装kubectl，避免系统依赖冲突
• 版本一致性：提供稳定的kubectl版本，确保部署环境一致性
• 轻量级：基于精简基础镜像，减少资源占用
• 易于集成：可直接集成到CI/CD管道，支持自动化部署流程

使用场景和适用范围

• 持续部署流程中执行Kubernetes资源创建、更新、删除等操作
• 跨平台Kubernetes集群管理（Windows、macOS、Linux均适用）
• CI/CD管道中的自动化部署步骤（如GitLab CI、GitHub Actions等）
• 临时Kubernetes集群访问（无需在本地安装配置kubectl）

使用方法和配置说明

1. 拉取镜像

bash
docker pull hacklab/kubectl:latest

2. 配置集群访问

需将Kubernetes集群配置文件（kubeconfig）挂载到容器中，或通过环境变量设置集群访问信息。

方式一：挂载本地kubeconfig文件

bash
docker run --rm -v ~/.kube/config:/root/.kube/config hacklab/kubectl:latest kubectl get pods

方式二：通过环境变量指定kubeconfig

bash
docker run --rm -e KUBECONFIG=/kubeconfig -v /path/to/your/kubeconfig:/kubeconfig hacklab/kubectl:latest kubectl get nodes

3. 执行kubectl命令

直接在docker run命令后添加kubectl子命令，例如：

bash
# 查看集群节点
docker run --rm -v ~/.kube/config:/root/.kube/config hacklab/kubectl:latest kubectl get nodes

# 部署应用
docker run --rm -v ~/.kube/config:/root/.kube/config hacklab/kubectl:latest kubectl apply -f deployment.yaml

# 查看Pod状态
docker run --rm -v ~/.kube/config:/root/.kube/config hacklab/kubectl:latest kubectl get pods -n default

4. 在CI/CD管道中使用示例（GitLab CI）

在.gitlab-ci.yml中添加如下步骤：

yaml
deploy:
  stage: deploy
  image: hacklab/kubectl:latest
  script:
    - kubectl config use-context my-cluster
    - kubectl apply -f k8s/deployment.yaml
    - kubectl rollout status deployment/my-app
  only:
    - main

注意事项

• 确保挂载的kubeconfig文件具有足够权限访问目标Kubernetes集群
• 如需使用特定版本的kubectl，可通过指定标签拉取对应版本镜像（如hacklab/kubectl:v1.24.0）
• 容器默认以root用户运行，可通过--user参数指定非root用户执行