@mittwald/kubernetes

Kubernetes client library

Stats

StarsIssuesVersionUpdatedCreatedSize
@mittwald/kubernetes
3.3.03 months ago4 years agoMinified + gzip package size for @mittwald/kubernetes in KB

Readme

Kubernetes client for Node.JS

npm version Build Status

Contents

Installation

You can install this package via NPM:

$ npm install @mittwald/kubernetes

Usage

Setup

External configuration using a kubeconfig file:

import {FileBasedConfig, KubernetesRESTClient, KubernetesAPI} from "@mittwald/kubernetes";

const config = new FileBasedConfig("/home/mhelmich/.kube/config");
const client = new KubernetesRESTClient(config);
const api = new KubernetesAPI(client);

Internal configuration (when the client is running within a Kubernetes cluster):

import {InClusterConfig, KubernetesRESTClient, KubernetesAPI} from "@mittwald/kubernetes";

const config = new InClusterConfig();
const client = new KubernetesRESTClient(config);
const api = new KubernetesAPI(client);

General usage

api.core().v1().pods.namespace("default").list().then(pods => {
    console.log("Found " + pods.length + " Pods:");

    pods.forEach(pod => {
        console.log(pod.metadata.name);
    });
});

Rate-limiting API access

import {
    InClusterConfig, 
    KubernetesRESTClient, 
    RatelimitingKubernetesRESTClient, 
    KubernetesAPI,
} from "@mittwald/kubernetes";

const config = new InClusterConfig();
const client = new KubernetesRESTClient(config);
const limitedClient = new RatelimitingKubernetesRESTClient(client);
const api = new KubernetesAPI(limitedClient);

Watching resources

api.core().v1().pods.namespace("default").watch({"some-label": "foo"}, ev => {
    console.log(`Pod: ${ev.type}: ${ev.object}`);    
});

Accessing CRDs

If you have a package that offers a client for Custom Resource Definitions (take a look at the @mittwald/kubernetes-rook package as an example), you can use the extend method to add the respective API client:

import {RookCustomResourceAPI} from "@mittwald/kubernetes-rook";

// ...
let extendedAPI = api.extend("rook", new RookCustomResourceAPI(client));

Supported resources

This library supports a reasonable subset of Kubernetes resources (these were implemented on an as-needed basis). Feel free to open a new issue or pull request to add support for additional API objects.

  • core/v1
    • pods
    • configMaps
    • endpoints
    • namespaces
    • nodes
    • persistentVolumes
    • persistentVolumeClaims
    • services
    • secrets
    • serviceAccounts
  • apps/v1
    • daemonSets
    • deployments
    • replicaSets
    • statefulSets
  • apps/v1beta1
    • deployments
    • statefulSets
  • batch/v1
    • jobs
  • batch/v1beta1
    • cronJobs
  • extensions/v1beta1
    • daemonSets
    • ingresses
    • networkPolicies
    • replicaSets
  • rbac/v1
    • clusterRoles
    • clusterRoleBindings
    • roles
    • roleBindings
  • autoscaling/v1
    • horizontalPodAutoscalers
  • apiextensions.k8s.io/v1beta1
    • customResourceDefinitions
  • admissionRegistration.k8s.io/v1
    • validatingWebhookConfigurations
    • mutatingWebhookConfigurations

References

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.