kubedepot

README

KubeDepot

A web service that provides kubeconfig YAML files on request.

Features

• List all available kubeconfigs
• Get a specific kubeconfig
• Merge multiple kubeconfigs

Usage

Deploy the application using the Helm chart. Check out the KubeDepot Helm Chart Usage for detailed chart configuration information.

helm repo add kubedepot https://rgeraskin.github.io/kubedepot/
helm install kubedepot kubedepot/kubedepot # This won't work without kubeconfigs

Configuration

You can configure the application using these environment variables:

• CONFIGS_DIR: Directory containing kubeconfig files (default: ./configs)
• PORT: HTTP server port (default: 8080)
• WEB_DIR: Directory containing web templates (default: ./web)
• DEBUG: Enable debug mode (default: false)

Development

Building the Application

1. Clone the repository
2. Run go mod tidy to fetch all dependencies
3. Build the application: go build -o ./kubedepot ./cmd/kubedepot/

The application includes embedded web templates for container deployment, but you can also use external templates from the WEB_DIR during development.

Starting the Server

# Start with default settings
./kubedepot

# Or with custom settings
CONFIGS_DIR=/path/to/configs PORT=9090 ./kubedepot

API Endpoints

List All Configs

GET /json/list
GET /yaml/list

Returns a list of all available kubeconfigs in either JSON or YAML format.

Get Configs

GET /json/get?name=<config-name>
GET /yaml/get?name=<config-name>
GET /yaml/get?name=<config-name>&name=<config-name2>

Returns kubeconfig(s) in either JSON or YAML format. You can specify multiple name parameters to merge configs.

If you don't provide a name parameter, all available configs will be merged.

Web Interface

GET /

Provides a simple web interface to browse and download available kubeconfigs.

Storage

Kubeconfig files are stored as YAML files in the configured CONFIGS_DIR. File names should have a .yaml extension.