kiwigrid/gcloud-kubectl-helm

gcloud-kubectl-helm

Docker镜像集成了https://cloud.google.com/sdk/docs/%E3%80%81https://%5B***]

https://img.shields.io/docker/pulls/kiwigrid/gcloud-kubectl-helm.svg?style=plastic](https://hub.docker.com/r/kiwigrid/gcloud-kubectl-helm/) https://img.shields.io/docker/automated/kiwigrid/gcloud-kubectl-helm.svg?style=plastic](https://hub.docker.com/r/kiwigrid/gcloud-kubectl-helm/builds/)

镜像标签说明

• latest: 基于master分支的最新构建
• tag: 与git标签关联（实际为打包的HELM客户端和gcloud版本，例如2.10.0-217.0.0）

镜像概述和主要用途

该镜像整合了GCP命令行工具（gcloud）、Kubernetes命令行工具（kubectl）、Helm包管理器以及SOPS密钥加密工具，旨在为Google Cloud Platform（GCP）和Kubernetes集群的管理、部署及密钥安全处理提供一站式环境。适用于本地开发、CI/CD流水线等场景，简化多工具协同操作的环境配置。

核心功能和特性

• 多工具集成：同时包含gcloud、kubectl、helm和SOPS，满足GCP与K8s全流程操作需求
• 灵活认证：支持GCP服务账户密钥文件认证和个人账户交互式认证
• CI/CD友好：支持在CI/CD pipeline中启动容器并执行单条命令
• 扩展能力：可通过环境变量导入GPG密钥和添加Helm仓库

使用场景和适用范围

• 本地开发环境中管理GCP资源和Kubernetes集群
• CI/CD流水线中执行GCP认证、K8s集群配置、Helm部署等操作
• 需要SOPS加密/解密Kubernetes密钥的场景
• 多工具协同操作的自动化脚本执行

使用方法和配置说明

使用GCP服务账户和密钥文件

传递包含多个命令的脚本

bash
docker run -v /path/to/your/script.sh:/data/commands.sh:ro docker.xuanyuan.run/kiwigrid/gcloud-kubectl-helm

传递脚本和GCP密钥文件

bash
docker run -v /path/to/your/script.sh:/data/commands.sh:ro -v /path/to/your/key-file.json:/data/gcp-key-file.json:ro docker.xuanyuan.run/kiwigrid/gcloud-kubectl-helm

使用个人GCP账户的交互式操作

bash
docker run -ti -v /path/to/your/workspace:/data/ docker.xuanyuan.run/kiwigrid/gcloud-kubectl-helm bash
# 认证并粘贴令牌
$ gcloud auth application-default login

# 配置kubectl上下文
$ gcloud container clusters get-credentials

# 运行helm
$ helm install release /data/your/chart -f values.yaml
# 或使用SOPS加密的密钥文件
$ helm secrets install release /data/your/chart -f values.yaml -f secrets.myapp.yaml

CI/CD环境中的使用

在CI/CD流水线中使用此镜像非常便捷。建议在流水线开始时启动容器，之后可向运行中的容器传递单条命令。

bash
CONTAINER_NAME=gkh-container
# 启动容器
docker run \
  --volume /path/to/your/workdir:/workspace:ro \
  --workdir /workspace \
  --volume /path/to/your/gcp-key-file.json:/data/gcp-key-file.json:ro \
  --env GOOGLE_APPLICATION_CREDENTIALS=/data/gcp-key-file.json \
  --rm \
  -t \
  --name $CONTAINER_NAME \
  docker.xuanyuan.run/kiwigrid/gcloud-kubectl-helm:latest /bin/bash

# 执行任意命令
docker exec $CONTAINER_NAME gcloud auth activate-service-account --key-file=/data/gcp-key-file.json
docker exec $CONTAINER_NAME gcloud config set project my-gcp-project-id
docker exec $CONTAINER_NAME gcloud container clusters get-credentials my-gke-cluster --project my-gcp-project-id --zone my-gke-zone

docker exec $CONTAINER_NAME helm list
docker exec $CONTAINER_NAME gcloud deployment-manager deployments describe my-deployment

# 停止容器
docker kill $CONTAINER_NAME

命令文件示例

通过服务账户授权访问GCP并获取运行中集群的凭证：

bash
gcloud auth activate-service-account --key-file=/data/gcp-key-file.json
gcloud container clusters get-credentials <clusterName> --project <projectId> [--region=<region> | --zone=<zone>]

helm list
kubectl get pods --all-namespaces

导入GPG密钥

要从密钥服务器导入公钥，可将密钥ID以空格分隔添加到GPG_PUB_KEYS环境变量：

bash
docker run -e GPG_PUB_KEYS=<key id> kiwigrid/gcloud-kubectl-helm:latest

添加分布式Helm Chart仓库

要添加分布式Helm仓库，可设置REPO_YAML_URL环境变量，例如：

bash
docker run -e REPO_YAML_URL=https://raw.githubusercontent.com/helm/hub/master/config/repo-values.yaml docker.xuanyuan.run/kiwigrid/gcloud-kubectl-helm:latest

参考来源

本仓库的灵感来源于：

• https://github.com/eversC/gcloud-k8s-helm
• https://github.com/lfaoro/gcloud-kubectl-helm