Kubegen generates Kubernetes clients in the form of resource based client modules directly into your project.
I have been co-maintaining the k8s library for some time now and while it is very dynamic and mighty, I always found it a bit big and clumsy for simple use cases. With Kubegen
I went down a different road. Kubegen
generates per resource client modules into your project. They are super straight-forward to use:
# list ConfigMaps in the default namespace:
{:ok, resp} = MyApp.K8sClient.Core.V1.ConfigMap.list("default")
# get the ConfigMap with name "my-config" in namespace "default":
{:ok, resp} = MyApp.K8sClient.Core.V1.ConfigMap.get("default", "my-config")
The generated modules use Kubereq to load the Kubernetes configuration and prepare the Req.Request
for operations on the resource. Finally, it’s plain Req
to make the HTTP requests and most function return {:ok, Req.Response.t()}
in the happy case.
Generate your first Client Module
Generating your first client is quite straight-foward. Have a look at the project’s README.md
on detailed instructions. But in a nutshell, the library offers a Mix task (mix kubegen
) which reads some entries from your application configuration and generates the configured modules.
Generating clients for ConfigMap, Deployment, ClusterRole and a CRD looks like this:
Where’s the Kubernetes Configuration?
As part of the configuration you need to tell Kubegen
how the Kubeconfig is loaded. Kubereq
comes with a default loading pipeline which does the job in most basic setups (i.e. load the current context from $HOME/.kube/config
or when running on a Kuberenetes cluster).