Kuber
A Julia Kubernetes Client.
An easy to use API to access Kubernetes clusters from Julia. The Kuber.Kubernetes
submodule has the complete set of low level APIs and entities.
Most of the low level APIs fit into a common usage pattern. Kuber.jl makes it possible to use all of them with only a few intuitive verb based APIs. Verbs act on entities. Entities can be identified by names or selector patterns, or otherwise can apply to all entities of that class. Verbs can take additional parameters, e.g. when creating or updating entities.
API and Entity naming convention follows the standard Kubernetes API and Model naming conventions.
Here are a few helpful resources:
Entities:
Any Kubernetes entity supported. APIs identify an entity by symbol named as per Kubernetes naming convention.
:Namespace
:Pod
:ReplicationController
:Service
:PersistentVolume
:Job
...
Methods/Verbs:
Kubernetes APIs are mapped to these easy to use verbs, familiar to Julia users.
get
: list or fetch entitieslist
: list entitiesput!
: create entitiesupdate!
: update existing entitiesdelete!
: delete existing entitiessel
: creates a label selector to use with other verbs
All verbs have the signature: verb(ctx::KuberContext, T::Symbol, args...; kwargs...)
.
Helper methods:
A Kubernetes context can be manipulated with:
set_server
: Set the API server locationset_ns
: Set the namespace to deal with
Other convenience methods:
kuber_type
: identify the Julia object corresponding to the Kubernetes specificationkuber_obj
: instantiate a Julia object from for the supplied Kubernetes specification- Helper methods for accessing metrics