{"id":13452395,"url":"https://github.com/databricks/click","last_synced_at":"2025-05-14T18:06:35.617Z","repository":{"id":31107704,"uuid":"96584339","full_name":"databricks/click","owner":"databricks","description":"The \"Command Line Interactive Controller for Kubernetes\"","archived":false,"fork":false,"pushed_at":"2024-01-08T20:14:15.000Z","size":1159,"stargazers_count":1501,"open_issues_count":35,"forks_count":84,"subscribers_count":282,"default_branch":"master","last_synced_at":"2025-05-08T05:19:02.391Z","etag":null,"topics":["cli","kubectl","kubernetes","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/databricks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-07T23:50:56.000Z","updated_at":"2025-05-01T13:14:49.000Z","dependencies_parsed_at":"2024-01-08T20:43:05.653Z","dependency_job_id":null,"html_url":"https://github.com/databricks/click","commit_stats":{"total_commits":466,"total_committers":14,"mean_commits":"33.285714285714285","dds":0.08154506437768239,"last_synced_commit":"545365cc1298ef34f85ed4aec8ba3fcf5bd4cf62"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fclick","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fclick/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fclick/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fclick/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/databricks","download_url":"https://codeload.github.com/databricks/click/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254198514,"owners_count":22030965,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","kubectl","kubernetes","rust"],"created_at":"2024-07-31T07:01:22.942Z","updated_at":"2025-05-14T18:06:30.610Z","avatar_url":"https://github.com/databricks.png","language":"Rust","readme":"# Click\n-----\nClick is the Command Line Interactive Controller for Kubernetes.\nIts purpose is to manage a large number of Kubernetes clusters/objects quickly and efficiently.\n\n## Code Status\n![Master Status](https://github.com/databricks/click/actions/workflows/push-actions.yml/badge.svg?branch=master)\n\n## CHANGELOG\nSee the [CHANGELOG](CHANGELOG.md) for a release history.\n\n\n## Demo Screencast\n![A demo gif that shows a few features](https://imgur.com/ft4WHcL.gif)\n\n# Usage Model\nClick is a REPL. When running Click, there is a current active config which\nincludes the current Kubernetes context, and optionally a namespace\nand Kubernetes object. Commands are then applied to the active config\nso it's not necessary to keep specifying what objects to target.\n\n# Installing\nYou'll need rust and cargo. See\n[here](https://doc.rust-lang.org/cargo/getting-started/installation.html) for instructions on how to\nget them.\n\nClick is on crates.io, so you can just run `cargo install click` to install it.\n\nAlternatively, to build it yourself, clone the click repository and run `cargo build`.\n\n## Arch Linux\n\nThere is an [aur](https://aur.archlinux.org/packages/click/) available.\n\n# Running\nIf you used `cargo install`, you can just run `click` (assuming `~/.cargo/bin` is in your PATH).\n\nIf you built from source, run `./target/debug/click`, or do `cargo run`.\n\nClick looks in ~/.kube/config by default for your Kubernetes\nconfiguration. It also stores its own config in the .kube dir. You\ncan change this with the --config option. If `KUBECONFIG` is set, it will use any files found there\nas the kubernetes config files.\n\nOnce you're in the REPL, type `help` to see what you can do.\n\n# Prompt\nThe order of the prompt is \\[context\\]\\[namespace\\]\\[object\\].\n\nThe object changes color depending on what type of object it is. (e.g yellow for pods, blue for\nnodes and so on)\n\n# Supported Authentication\nClick currently supports the following ways of authenticating to a Kubernetes clusters:\n\n* token\n* username / password\n* private key / certificate\n* gke style authentication provider\n\n## GKE Support\nFor Google Kubernetes Engine, Click supports reading the token already in the kube config file.  If\nthat token has expired, Click will request a new token and use that. It does not save the new token\nback into the config file (yet).\n\n## Why am I getting a BadDER error\nIf your Kubernetes cluster is using Node Authorization\n(https://kubernetes.io/docs/admin/authorization/node/) your API Server may be using a certificate\nwith a DNS name like \"system:something\".  This is technically a bad cert as DNS names can't have a\ncolon in them. Since the WebPKI crate is more strict than Go, Click will not accept the cert\nfrom the API Server even though kubectl will.\n\nTo temporarily patch WebPKI to accept the cert:\n1. Build Click\n2. Run the `fix_bad_der.sh` script that is in the util directory\n3. Run `cargo clean`\n4. Rebuild Click\n","funding_links":[],"categories":["Rust","API/CLI adaptors","cli"],"sub_categories":["[Jenkins](#jenkins)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatabricks%2Fclick","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatabricks%2Fclick","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatabricks%2Fclick/lists"}