☸️ kubectl-plugins

SYSTEM STATUS: [ ACTIVE_EXPANSION ]
INTERFACE: Kubernetes API v1.28+
UPTIME: Continuous synchronization with cluster logic

---

🌌 Overview

This repository serves as a Tactical Command Nexus for custom kubectl extensions. Designed to bypass standard orchestration limits, these plugins provide high-fidelity diagnostic data and streamlined resource manipulation.

🔌 Available Modules

Extension	Status	Function
kubectl-ssh	🟢 Stable	Swift ssh and quick nsenter
kubectl-ctx-switch	🟡 Beta	Context-aware namespace pivoting
kubectl-trace-log	🔴 Dev	Real-time pod-to-node signal tracing

🛠️ Installation

A plugin is a standalone executable file, whose name begins with kubectl-. To install a plugin, move its executable file to anywhere on your PATH.

# Clone the repo
git clone https://github.com/tenaghirmb/kubectl-plugin.git

# Inject into system path
sudo chmod +x ./kubectl-ssh
sudo mv ./kubectl-ssh /usr/local/bin

# Check for plugin warnings and make sure plugins are visible by `kubectl`
kubectl plugin list

---

📄 Instructions

❶ kubectl ssh

Supports

1. fast ssh onto kubernetes nodes

2. nsenter into any pod's container linux namespace

Some dir paths might need revising according to actual situation.

Usage

Provider-agnostic way of opening a remote shell to a Kubernetes node.

Enables you to access a node even when it doesn't run an SSH server or when you don't have the required credentials. Also, the way you log in is always the same, regardless of what provides the Kubernetes cluster (e.g. Minikube, Kind, Docker Desktop, GKE, AKS, EKS, ...)

You must have cluster-admin rights to use this plugin.

The primary focus of this plugin is to provide access to nodes, but it also provides a quick way of running a shell inside a pod.

Examples:

  # Open a shell to node of a single-node cluster (e.g. Docker Desktop)
  kubectl ssh node

  # Open a shell to node of a multi-node cluster (e.g. GKE)
  kubectl ssh node my-worker-node-1

  # Execute the command ls on a node my-worker-node-1
  kubectl ssh node my-worker-node-1 ls

  # Nsenter into network namespace of a pod
  kubectl ssh pod my-pod

Usage:
  kubectl ssh node [nodeName] [command]
  kubectl ssh pod [podName] [-n namespace] [-c container]