Ingress to Gateway API migration (#21)

Signed-off-by: Waleed Malik <ahmedwaleedmalik@gmail.com>

Author: ahmedwaleedmalik

.prow/verify.yaml

@@ -22,7 +22,7 @@ presubmits:
       preset-goproxy: "true"
     spec:
       containers:
-        - image: quay.io/kubermatic/build:go-1.25-node-22-2
+        - image: quay.io/kubermatic/build:go-1.25-node-22-kind-0.30-6
           command:
             - make
           args:
@@ -41,7 +41,7 @@ presubmits:
       preset-kubelb-cli: "true"
     spec:
       containers:
-        - image: quay.io/kubermatic/build:go-1.25-node-22-2
+        - image: quay.io/kubermatic/build:go-1.25-node-22-kind-0.30-6
           command:
             - make
           args:

CLAUDE.md

@@ -0,0 +1,80 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build Commands
+
+```bash
+make build              # Build binary to bin/kubelb
+make test               # Run all tests
+go test ./internal/...  # Run specific package tests
+go test -run TestName ./internal/logger/  # Run single test
+make lint               # Run golangci-lint
+make verify-all         # All checks (boilerplate, imports, licenses, shfmt)
+make install            # Install to Go bin directory
+```
+
+## Architecture
+
+### Edition Detection Flow
+
+CLI auto-detects KubeLB backend edition (CE vs EE) at startup via `PersistentPreRunE`:
+
+1. Check cache (`~/.kubelb/cache/`, 48h TTL)
+2. If miss: query TenantState resource for edition field
+3. Fallback: check if tunnel CRDs exist (EE-only)
+4. Load appropriate API types from `k8c.io/kubelb/api/{ce,ee}/`
+
+### Key Packages
+
+- `cmd/` - Cobra commands, config init happens in root.go PersistentPreRunE
+- `internal/edition/` - Edition detection logic
+- `internal/config/` - Kubeconfig/tenant resolution with precedence: flags > env vars > error
+- `internal/tunnel/connect.go` - HTTP/2 SSE client with auto-reconnect (exponential backoff, max 10 retries)
+- `internal/logger/` - Custom slog-based logging with CLI/JSON/text formats
+
+### Tenant Namespace
+
+Tenant names auto-prefix with `tenant-` if not already prefixed. Namespace = `tenant-{name}`.
+
+### Config Requirements
+
+No defaults for kubeconfig or tenant - both must be explicitly provided via flags or env vars (KUBECONFIG, TENANT_NAME).
+
+### Environment Variables
+
+All flags can be configured via env vars. Precedence: flags > env vars > defaults.
+
+**Global:**
+
+| Env Var | Flag | Default |
+|---------|------|---------|
+| `KUBECONFIG` | `--kubeconfig` | (required) |
+| `TENANT_NAME` | `--tenant` | (required) |
+| `KUBELB_INSECURE_SKIP_VERIFY` | - | `false` |
+| `KUBELB_LOG_LEVEL` | `--log-level` | - |
+| `KUBELB_LOG_FORMAT` | `--log-format` | `cli` |
+| `KUBELB_LOG_PATH` | `--log-file` | - |
+
+**Ingress conversion (`kubelb ingress`):**
+
+| Env Var | Flag | Default |
+|---------|------|---------|
+| `KUBELB_GATEWAY_NAME` | `--gateway-name` | `kubelb` |
+| `KUBELB_GATEWAY_NAMESPACE` | `--gateway-namespace` | `kubelb` |
+| `KUBELB_GATEWAY_CLASS` | `--gateway-class` | `kubelb` |
+| `KUBELB_INGRESS_CLASS` | `--ingress-class` | (all) |
+| `KUBELB_DOMAIN_REPLACE` | `--domain-replace` | - |
+| `KUBELB_DOMAIN_SUFFIX` | `--domain-suffix` | - |
+| `KUBELB_PROPAGATE_EXTERNAL_DNS` | `--propagate-external-dns` | `true` |
+| `KUBELB_GATEWAY_ANNOTATIONS` | `--gateway-annotations` | - |
+| `KUBELB_DISABLE_ENVOY_GATEWAY_FEATURES` | `--disable-envoy-gateway-features` | `false` |
+| `KUBELB_COPY_TLS_SECRETS` | `--copy-tls-secrets` | `true` |
+
+### Commands Skipping Config
+
+version, help, completion, docs - skip kubeconfig/tenant loading.
+
+## Module Path
+
+`k8c.io/kubelb-cli`

Makefile

@@ -75,7 +75,7 @@ run-version: build
 
 update-docs:
 	@echo "Updating docs..."
-	./$(BUILD_DIR)/$(BINARY_NAME) docs --output=./docs/cli
+	./$(BUILD_DIR)/$(BINARY_NAME) docs --hugo --output=./docs/cli
 
 
 .PHONY: snapshot

cmd/docs.go

@@ -1,5 +1,5 @@
 /*
-Copyright 2025 The KubeLB Authors.
+Copyright 2026 The KubeLB Authors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -19,37 +19,59 @@ package cmd
 import (
 	"fmt"
 	"os"
+	"path/filepath"
+	"strings"
+	"time"
 
 	"github.com/spf13/cobra"
 	"github.com/spf13/cobra/doc"
 )
 
 func docsCmd() *cobra.Command {
 	var outputDir string
+	var hugoFormat bool
 
 	cmd := &cobra.Command{
 		Use:   "docs",
 		Short: "Generate markdown documentation for all commands",
 		Long: `Generate markdown documentation for all CLI commands and their parameters.
-This creates individual markdown files for each command with complete usage information.`,
-		RunE: func(root *cobra.Command, _ []string) error {
+This creates individual markdown files for each command with complete usage information.
+
+Use --hugo flag to generate Hugo-compatible documentation with front matter
+for integration with static site generators.`,
+		RunE: func(cmd *cobra.Command, _ []string) error {
 			if err := os.MkdirAll(outputDir, 0755); err != nil {
 				return fmt.Errorf("failed to create output directory: %w", err)
 			}
-			prepender := empty
-			linkHandler := identity
-			root.DisableAutoGenTag = true
-			err := doc.GenMarkdownTreeCustom(root, outputDir, prepender, linkHandler)
+
+			var prepender func(string) string
+			var linkHandler func(string) string
+
+			if hugoFormat {
+				prepender = hugoPrepender
+				linkHandler = hugoLinkHandler
+			} else {
+				prepender = empty
+				linkHandler = identity
+			}
+
+			rootCmd := cmd.Root()
+			rootCmd.DisableAutoGenTag = true
+			err := doc.GenMarkdownTreeCustom(rootCmd, outputDir, prepender, linkHandler)
 			if err != nil {
 				return fmt.Errorf("failed to generate documentation: %w", err)
 			}
 
 			fmt.Printf("Documentation generated successfully in: %s\n", outputDir)
+			if hugoFormat {
+				fmt.Println("Hugo format enabled - files include front matter and Hugo-compatible links")
+			}
 			return nil
 		},
 	}
 
 	cmd.Flags().StringVarP(&outputDir, "output", "o", "./docs", "Output directory for generated documentation")
+	cmd.Flags().BoolVar(&hugoFormat, "hugo", false, "Generate Hugo-compatible docs with front matter")
 	return cmd
 }
 
@@ -60,3 +82,30 @@ func identity(s string) string {
 func empty(_ string) string {
 	return ""
 }
+
+// hugoPrepender adds Hugo front matter to generated docs
+func hugoPrepender(filename string) string {
+	// Extract command name from filename (e.g., "kubelb_tunnel_connect.md" -> "kubelb tunnel connect")
+	name := strings.TrimSuffix(filepath.Base(filename), ".md")
+	title := strings.ReplaceAll(name, "_", " ")
+
+	// Calculate weight based on command depth (more underscores = higher weight = appears later)
+	depth := strings.Count(name, "_")
+	weight := 10 + (depth * 20)
+
+	date := time.Now().Format("2006-01-02T00:00:00+00:00")
+
+	return fmt.Sprintf(`+++
+title = "%s"
+date = %s
+weight = %d
++++
+
+`, title, date, weight)
+}
+
+// hugoLinkHandler converts links to Hugo-compatible format
+// Changes: "kubelb_tunnel.md" -> "../kubelb_tunnel" (relative path, no .md extension)
+func hugoLinkHandler(name string) string {
+	return "../" + strings.TrimSuffix(name, ".md")
+}