/helm-kubectl

Docker Hub image with helm and kubectl on top of alpine linux with bash

Primary LanguageDockerfileMIT LicenseMIT

helm-kubernetes Docker hub image

ci Docker Stars Docker Pulls

Supported tags and release links

  • 3.15.4 - helm v3.15.4, kubectl v1.30.3, alpine 3.20

The image tags below are dynamic and overwritten with the latest helm image under that semVer:

  • 3.<minor#> - helm v3.<minor#>.x, kubectl v1.x, alpine 3.x. Example: 3.15
  • 3 - helm 3.x, kubectl 1.x, alpine 3.x

Releases from Helm 2.3.1 to 3.15.3 and the above dynamic tags can be found on Docker Hub tags page.

Overview

This lightweight alpine docker image provides kubectl and helm binaries for working with a Kubernetes cluster. A local configured kubectl is a prerequisite to use helm per helm documentation. This image is useful for general helm administration such as deploying helm charts and managing releases. It is also perfect for any automated deployment pipeline needing to use helm which supports docker images such as Concourse CI, Jenkins on Kubernetes, Travis CI, and Circle CI. Having bash installed allows for better support for troubleshooting by being able to exec / terminal in and run desired shell scripts. Git installed allows installation of helm plugins.

If it is desired to only use kubectl and have kubectl as the entry command (versus this image as bash entry command), I recommend checking out this image instead: lachlanevenson/kubectl

Run

Example to just run helm on entry:
docker run --rm dtzar/helm-kubectl helm
By default kubectl will try to use /root/.kube/config file for connection to the kubernetes cluster, but does not exist by default in the image.

Example for use with personal administration or troubleshooting with volume mount for kubeconfig files:
docker run -it -v ~/.kube:/root/.kube dtzar/helm-kubectl
The -v maps your host docker machine Kubernetes configuration directory (~/.kube) to the container's Kubernetes configuration directory (root/.kube).

Build

For doing a manual local build of the image:
make docker_build