rke2-kubeconfig

A CLI tool to fetch RKE2 kubeconfig from a remote node, rename clusters/contexts/users with custom naming, merge into your local kubeconfig, and optionally test connectivity.

Features

• 🔧 Automatic Fetch: Retrieve RKE2 kubeconfig over SSH.
• 🛠️ Custom Naming: Override cluster, context, and user names.
• 📂 Secure Merge: Merge into any kubeconfig file with unique entries.
• 💾 Backup: Optional automatic backups of existing configs.
• 🚀 Test Connectivity: Run kubectl get nodes to verify context.
• 📋 Interactive CLI: Rich --help, --version, and verbose modes.

Installation

pip install rke2-kubeconfig

Or install from source:

git clone https://github.com/chris17453/rke2-kubeconfig.git
cd rke2-kubeconfig
pip install .

Usage

rke2-kubeconfig <host>[@<user>] [SSH_KEY] [options]

# Merge using SSH agent with default 'root' user
rke2-kubeconfig 10.0.0.140 --test

# Specify user, key, and custom name with verbose output
rke2-kubeconfig admin@10.0.0.140 ~/.ssh/id_rsa.pem -n prod-node -v

For full list of options:

rke2-kubeconfig --help