GithubHelp home page GithubHelp logo

anilpothula / click Goto Github PK

View Code? Open in Web Editor NEW

This project forked from databricks/click

0.0 0.0 0.0 989 KB

The "Command Line Interactive Controller for Kubernetes"

License: Apache License 2.0

Shell 0.16% Rust 99.84%

click's Introduction

Click


Click is the Command Line Interactive Controller for Kubernetes. Its purpose is to manage a large number of Kubernetes clusters/objects quickly and efficiently.

Code Status

Master Status

CHANGELOG

See the CHANGELOG for a release history.

Demo Screencast

A demo gif that shows a few features

Usage Model

Click is a REPL. When running Click, there is a current active config which includes the current Kubernetes context, and optionally a namespace and Kubernetes object. Commands are then applied to the active config so it's not necessary to keep specifying what objects to target.

Installing

You'll need rust and cargo. See here for instructions on how to get them.

Click is on crates.io, so you can just run cargo install click to install it.

Alternatively, to build it yourself, clone the click repository and run cargo build.

Arch Linux

There is an aur available.

Running

If you used cargo install, you can just run click (assuming ~/.cargo/bin is in your PATH).

If you built from source, run ./target/debug/click, or do cargo run.

Click looks in ~/.kube/config by default for your Kubernetes configuration. It also stores its own config in the .kube dir. You can change this with the --config option. If KUBECONFIG is set, it will use any files found there as the kubernetes config files.

Once you're in the REPL, type help to see what you can do.

Prompt

The order of the prompt is [context][namespace][object].

The object changes color depending on what type of object it is. (e.g yellow for pods, blue for nodes and so on)

Supported Authentication

Click currently supports the following ways of authenticating to a Kubernetes clusters:

  • token
  • username / password
  • private key / certificate
  • gke style authentication provider

GKE Support

For Google Kubernetes Engine, Click supports reading the token already in the kube config file. If that token has expired, Click will request a new token and use that. It does not save the new token back into the config file (yet).

Why am I getting a BadDER error

If your Kubernetes cluster is using Node Authorization (https://kubernetes.io/docs/admin/authorization/node/) your API Server may be using a certificate with a DNS name like "system:something". This is technically a bad cert as DNS names can't have a colon in them. Since the WebPKI crate is more strict than Go, Click will not accept the cert from the API Server even though kubectl will.

To temporarily patch WebPKI to accept the cert:

  1. Build Click
  2. Run the fix_bad_der.sh script that is in the util directory
  3. Run cargo clean
  4. Rebuild Click

click's People

Contributors

nicklan avatar lofim avatar zachschuermann avatar markj-db avatar flaviofcruz avatar iria1 avatar aarondav avatar svar29 avatar wchau avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo 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.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.