Skip to content

hagay3/skuber

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.

skuber logo

Scala client for the Kubernetes API.


Maven Central Latest release date Commit Activity Discord

Read the Dcoumentation.


Quick start

This example lists pods in kube-system namespace:

import skuber._
import skuber.json.format._
import akka.actor.ActorSystem
import scala.util.{Success, Failure}

implicit val system = ActorSystem()
implicit val dispatcher = system.dispatcher

val k8s = k8sInit
val listPodsRequest = k8s.list[PodList](Some("kube-system"))
listPodsRequest.onComplete {
  case Success(pods) => pods.items.foreach { p => println(p.name) }
  case Failure(e) => throw(e)
}

Documentation

Read the documentation and join discord community to ask your questions!

Note: Since Akka license is no more an "Open Source” license, akka version won't be bumped until there will be an equivalent alternative.

Currently, skuber implemented with akka 2.6.19 and the license is open-sourced.

Features

  • Uses standard kubeconfig files for configuration - see the configuration guide for details
  • Scala 3.2, 2.13, 2.12 support
  • Refreshing EKS tokens Refresh EKS Token guide
  • Comprehensive support for Kubernetes API model represented as Scala case classes
  • Support for core, extensions and other Kubernetes API groups
  • Full support for converting resources between the case class and standard JSON representations
  • Client API for creating, reading, updating, removing, listing and watching resources on a Kubernetes cluster
  • The API is asynchronous and strongly typed e.g. k8s get[Deployment]("nginx") returns a value of type Future[Deployment]
  • Fluent API for creating and updating specifications of Kubernetes resources

Prerequisites

  • Java 8
  • Kubernetes cluster

A Kubernetes cluster is needed at runtime. For local development purposes, minikube is recommended. To get minikube follow the instructions here

Release

You can use the latest release by adding to your build:

  • Scala 3.2, 2.13, 2.12 support
libraryDependencies += "io.github.hagay3" %% "skuber" % "3.0.5"

Building

Building the library from source is very straightforward. Simply run sbt testin the root directory of the project to build the library (and examples) and run the unit tests to verify the build.

CI + Build

The CI parameters defined in build.sbt.

ci.yaml and clean.yaml are generated automatically with sbt-github-actions plugin.

Run sbt githubWorkflowGenerate && bash infra/ci/fix-workflows.sh in order to regenerate ci.yaml and clean.yaml.

CI Running against the following k8s versions

  • v1.19.6
  • v1.20.11
  • v1.21.5
  • v1.22.9
  • v1.23.6
  • v1.24.1

skuber supports all other k8s versions, not all of them tested under CI.

https://kubernetes.io/releases/

Support

I'm trying to be responsive to any new issues, you can create github issue or contact me.

Skuber chat on discord: https://discord.gg/byEh56vFJR

Email: hagay3@gmail.com