txn2/kubefwd

This patch release builds on v1.23.0, which introduced auto-reconnect on pod changes, graceful shutdown handling, and multi-platform Docker images. Version 1.23.2 focuses on improving pod discovery timing, upgrading core dependencies, and enhancing documentation.

What's New

New Command Line Flags (#254, #277)

--retry-interval (default: 10s)

When no pods are found for a service (e.g., pods are still starting), kubefwd will now retry at this configurable interval instead of waiting for the full resync period.

# Faster retry for development environments
sudo -E kubefwd svc -n dev --retry-interval=5s

--resync-interval (default: 5m)

Configurable interval for forced service resync. Previously hardcoded to 5 minutes.

# More frequent resyncs for dynamic environments
sudo -E kubefwd svc -n dev --resync-interval=1m

Combined Example

# Quick retry with frequent resync - ideal for local development
sudo -E kubefwd svc -n dev --retry-interval=5s --resync-interval=1m

Service Update Handler (#277)

The service update handler is now functional. When a service's selector or ports change, kubefwd will automatically trigger an immediate resync to pick up the new pod configuration. This is particularly useful when:

• Service selectors are updated to target different pods
• Service ports are added, removed, or modified
• Rolling out configuration changes without restarting kubefwd

Dependency Upgrades

txeh v1.7.0 (from v1.3.0)

The hosts file management library has been upgraded with several important fixes:

• Windows 9-host-per-line limit: Properly handles Windows' limitation of 9 hostnames per line in the hosts file
• Race condition fixes: Improved thread safety for concurrent hosts file modifications
• Path detection improvements: Better detection of hosts file location across platforms
• Panic fix: Resolves a panic that could occur during hosts file parsing (#278)

Kubernetes Client Libraries v0.31.0 (from v0.23.5)

Major upgrade to Kubernetes client libraries providing:

• Support for Kubernetes 1.31 clusters
• Improved API compatibility and stability
• Updated dependencies and security fixes
• Better error handling and diagnostics

Documentation

• Added comprehensive selector usage examples in README
• Documented label selectors (-l), field selectors (-f), and combined patterns
• Examples for common use cases like forwarding specific services or filtering by labels

Issues Closed

• #254 - No pods running error: Fixed timing issue where kubefwd would fail to find pods when services start before pods are ready. The new --retry-interval flag allows configuring faster retries.

• #277 - More granular control on kubefwd resync behavior: Added --resync-interval and --retry-interval flags, and implemented a functional service update handler that triggers resync on selector/port changes.

• #278 - Panic in txeh hosts file parsing: Fixed by upgrading txeh to v1.7.0.

Changelog Since v1.23.0

| Commit | Description |
|--------|-------------|
| 0231874 | Add configurable retry/resync intervals for pod discovery |
| 5ee69c1 | Upgrade txeh to v1.7.0 and Kubernetes client libraries to v0.31.0 |
| 77d98cb | Document selector usage in README with examples |
| 65555cc | Restore Homebrew formula for existing users (v1.23.1) |

Installation

Homebrew (macOS/Linux)

brew update
brew upgrade txn2/tap/kubefwd

Direct Download

Download binaries from the GitHub Releases page.

Docker

docker pull txn2/kubefwd:v1.23.2
# or
docker pull txn2/kubefwd:latest

Package Managers

• APK (Alpine): kubefwd_amd64.apk, kubefwd_arm64.apk
• DEB (Debian/Ubuntu): kubefwd_amd64.deb, kubefwd_arm64.deb
• RPM (RHEL/Fedora): kubefwd_amd64.rpm, kubefwd_arm64.rpm

Full Changelog

For the complete list of changes since the major v1.23.0 release, see:

• v1.23.0 Release Notes - Major release with auto-reconnect, graceful shutdown, and multi-platform Docker support
• v1.23.1 Release Notes - Homebrew formula fix
• Compare v1.23.0...v1.23.2

Changelog

• 0231874bc7fa9dac71a0c49181d8b8cc540370ad Add configurable retry/resync intervals for pod discovery (#254, #277)
• 77d98cbfd7a6b1aea8a2846d0a62978a7e278a0f Document selector usage in README with examples for labels, fields, and combined selector patterns
• 5ee69c14737bb33d073e9ac74c586d80e3b51fb9 Upgrade txeh to v1.7.0 and Kubernetes client libraries to v0.31.0