KubeLB CLI

Note

🚧 Beta Software - This CLI is currently in beta stage and is not yet ready for production use. Features may change as we continue development and gather feedback. Please report any issues you encounter!

The KubeLB CLI provides tools to manage KubeLB load balancers and create secure tunnels to expose local services through the KubeLB infrastructure(Requires KubeLB Enterprise Edition).

For more information, please refer to the KubeLB CLI documentation.

Installation

Prerequisites

• Go 1.24.5+

Build from source

make build

This will create the binary in ./bin/kubelb.

Install to system

make install

This will install the binary to your Go bin directory.

Configuration

The KubeLB CLI supports multiple ways to configure kubeconfig and tenant settings, with the following precedence (highest to lowest):

Kubeconfig Configuration

1. --kubeconfig flag: Explicitly specify kubeconfig path
2. KUBECONFIG environment variable: Standard Kubernetes environment variable

Tenant Configuration

1. --tenant, -t flag: Explicitly specify tenant name
2. TENANT_NAME environment variable: Set tenant via environment variable
3. Error if neither provided: Tenant is required for most commands (error message includes both flag and environment variable options)

Examples

# Using flags
kubelb loadbalancer list --tenant mycompany --kubeconfig ./kubeconfig

# Using environment variables
export TENANT_NAME=mycompany
export KUBECONFIG=./kubeconfig
kubelb loadbalancer list

# Mixed (flags override environment variables)
export TENANT_NAME=from-env
kubelb loadbalancer list --tenant from-flag  # Uses "from-flag"

# Tenant namespace examples
kubelb loadbalancer list --tenant mycompany          # Uses namespace: tenant-mycompany
kubelb loadbalancer list --tenant tenant-mycompany  # Uses namespace: tenant-mycompany (no double prefix)

Global Flags

• --kubeconfig: Path to kubeconfig file
• --tenant, -t: Tenant name (creates namespace tenant-{name}, or uses as-is if already prefixed)
• --timeout: Timeout for operations (e.g., 30s, 5m)

CLI Reference

For more information, please refer to the CLI Reference.