Skuber is a Scala client library for Kubernetes. It provides a fully featured, high-level and strongly typed Scala API for managing Kubernetes cluster resources (such as Pods, Services, Deployments, ReplicaSets, Ingresses etc.) via the Kubernetes REST API server.
- Comprehensive set of case classes for representing core and extended Kubernetes resource kinds
- 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 typeFuture[Deployment]
- Fluent API for creating and updating specifications of Kubernetes resources
- Uses standard
kubeconfig
files for configuration - see the Configuration guide for details
See the programming guide for more details.
This example creates a nginx service (accessed via port 30001 on each Kubernetes cluster node) that is backed by five nginx replicas.
import skuber._
import skuber.json.format._
val nginxSelector = Map("app" -> "nginx")
val nginxContainer = Container("nginx",image="nginx").exposePort(80)
val nginxController= ReplicationController("nginx",nginxContainer,nginxSelector)
.withReplicas(5)
val nginxService = Service("nginx")
.withSelector(nginxSelector)
.exposeOnNodePort(30001 -> 80)
import scala.concurrent.ExecutionContext.Implicits.global
val k8s = k8sInit
val createOnK8s = for {
svc <- k8s create nginxService
rc <- k8s create nginxController
} yield (rc,svc)
createOnK8s onComplete {
case Success(_) => System.out.println("Successfully created nginx replication controller & service on Kubernetes cluster")
case Failure(ex) => System.err.println("Encountered exception trying to create resources on Kubernetes cluster: " + ex)
}
k8s.close
The client supports v1.0 through v1.3 of the Kubernetes API, so should work against all supported Kubernetes releases in use today.
You need Java 8 to run Skuber.
You can include the current Skuber release in your application by adding the following to your sbt
project:
resolvers += Resolver.url(
"bintray-skuber",
url("http://dl.bintray.com/oriordan/skuber"))(
Resolver.ivyStylePatterns)
libraryDependencies += "io.doriordan" %% "skuber" % "1.3.0"
The current release has been built for Scala 2.11 - other Scala language versions such as 2.12 will be supported in future.
Building the library from source is very straightforward. Simply run sbt test
in the root directory of the project to build the library (and examples) and run the unit tests to verify the build.
The quickest way to get started with Skuber:
-
If you don't already have Kubernetes installed, then follow the instructions here to install minikube, which is now the recommended way to run Kubernetes locally.
-
Ensure Skuber configures itself from the default Kubeconfig file (
$HOME/.kube/config
) :export SKUBER_CONFIG=file
-
Try one or more of the examples: if you have cloned this repository run
sbt
in the top-level directory to start sbt in interactive mode and then:
> project examples
> run
[warn] Multiple main classes detected. Run 'show discoveredMainClasses' to see the list
Multiple main classes detected, select one to run:
[1] skuber.examples.deployment.DeploymentExamples
[2] skuber.examples.fluent.FluentExamples
[3] skuber.examples.guestbook.Guestbook
[4] skuber.examples.scale.ScaleExamples
[5] skuber.examples.ingress.NginxIngress
Enter number:
For other Kubernetes setups, see the Configuration guide for details on how to tailor the configuration for your clusters security, namespace and connectivity requirements.
The coverage of the core Kubernetes API functionality by Skuber is extensive.
Support of more recent extensions group functionality is not yet entirely complete: full support (with examples) is included for Deployments, Horizontal pod autoscaling and Ingress / HTTP load balancing; support for other Extensions API group features including Daemon Sets and Jobs is added over time.
This code is licensed under the Apache V2.0 license, a copy of which is included here.
skuber's People
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ๐๐๐
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google โค๏ธ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.