K8S.cr

A Kubernetes Binding lib for Crystal-lang forked from psykube/pyrite. Forked due to possibly destructive changes to change namespaces and adapt for use with Kube::Client

.github/workflows/ci.yml .github/workflows/docs.yml GitHub release Chat on Telegram

This library contains generated classes for Kubernetes resources for various Kubernetes API versions, as well as a Hashdiff module for comparing hashes of Kubernetes resources.

Installation

Add this to your application's shard.yml:

dependencies:
  k8s:
    github: spoved/k8s.cr

Documentation

View the Documentation for the version you are using:

https://spoved.github.io/k8s.cr/

Usage

K8S.cr should support Kubernetes API from 1.11.0 and beyond. In order to use the bindings, you will want to include the VERSION that best maps to your k8s api version. Requiring more than one version at this time will result in an error.

require "k8s/versions/v1.20"

CRD Generation

To generate resources for a CRD, you can use the crd_gen.cr file.

# First dump the CRDs to a file
kubectl get crds -o yaml > crds.yaml

# Then generate the resources
./lib/k8s/bin/gen_crd.cr -- ./crds.yaml

Contributing

  1. Fork it ( https://github.com/spoved/k8s.cr/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors