Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Easily Manage Kubernetes Objects.

Project description

KubeObject

A simple to use wrapping on top of Kubernetes custom resources with object oriented semantics.

KubeObject allows you to use Kubernetes Custom Objects in an object oriented way. It works by defining an object, by instantiating it with a name and namespace and then "bounding" this object to a Kubernetes object by creating it, or loading it, if it already exists.

Quick Start

In the following example we create an "Istio" object, which will manage one of the Custom Objects defined by the Istio operator. A simple lifecycle is explained below.

# Builds the object, but it is "unbound", this is, it is not
# referring to an actual object in Kubernetes.
istio = CustomObject("my-istio", "my-namespace", plural="istios", api_version="istio.banzaicloud.io/v1beta1")

# Let's pass the simplest spec we can
istio["spec"] = {"version": "1.1.0", "mtls": True}

# And now create it; after creation the object is "bound"
istio.create()

Updating the object's Spec and checking the object's Status is one of our goals as well, like in the following example:

# The Istio operator should have started working on deploying
# this new Custom Resource. Let's get the status of the object
print(istio["status"])

# This is empty, because since calling `create()` we have not
# updated from the actual object in Kubernetes. Let's get an
# up-to-date object.
istio.reload()

# I want to avoid calling `reload()` everytime I need a new
# version
istio.auto_reload = True

# Now we'll wait until the object has reached a given status:
while istio["status"]["Status"] == "Reconciling": time.sleep(5)

# Check the Status after "Reconciling"
print("Our status is:", istio["status"]["Status"])

After doing all its work, the Istio object might need to be deleted:

istio.delete()

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kubeobject, version 0.1.9
Filename, size File type Python version Upload date Hashes
Filename, size kubeobject-0.1.9-py3.7.egg (30.3 kB) File type Egg Python version 3.7 Upload date Hashes View
Filename, size kubeobject-0.1.9-py3-none-any.whl (17.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size kubeobject-0.1.9.tar.gz (10.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page