Merge branch 'kubernetes-sigs:main' into in-cluster-context-name

Author: iamhalje

ADOPTERS.md

@@ -11,6 +11,7 @@ If you would like your organization to be added to this list, please open a PR w
 | Organization                                 | Description                                                                                                                                                                                                                                                                                                                                                       |
 |----------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | [EPAM Systems, Inc.](https://epam.com/)      | EPAM leverages Headlamp for their [edp-headlamp](https://github.com/epam/edp-headlamp) project, integrating it within their [KubeRocketCI](https://docs.kuberocketci.io/) open-source solution to enhance the user interface and experience for managing Platform using Kubernetes-native approach.                                                               |
+| [KA-NABELL](https://www.ka-nabell.com/)      | KA-NABELL, Japan's largest trading card e-commerce platform, contributes to Headlamp and uses it as a central operations hub for its microservices DevOps teams. They develop and extend official plugins (including a Knative plugin) alongside custom Headlamp plugins to streamline day-to-day application operations and integrate with their broader cloud native toolchain (including CNCF ecosystem tools and services). |
 | [Microsoft](https://www.microsoft.com/) | Microsoft contributes to Headlamp, uses Headlamp internally, and also uses Headlamp as the basis for [AKS desktop](https://github.com/Azure/aks-desktop). |
 | [Millennium bcp](https://www.millenniumbcp.pt/) | Millennium bcp is utilizing Headlamp as a User Interface to enhance visibility and streamline the configuration and deployment of microservices and applications. |
 | [Oracle](https://www.oracle.com/) | [Oracle Cloud Native Environment (OCNE)](https://www.oracle.com/linux/cloud-native-environment/), based on open standards, specifications, and APIs defined by the Open Container Initiative and Cloud Native Computing Foundation (CNCF), includes a CNCF-certified Kubernetes module, container runtimes, virtualization, service mesh, storage, networking, observability, and diagnostics. Oracle leverages Headlamp and its plugin system for implementing its own [OCNE UI](https://docs.oracle.com/en/learn/ocne-ui/index.html).

AGENTS.md

@@ -28,6 +28,7 @@ default_agent: "@dev-agent"
 > - `/docs/development/index.md` - Main development guide with build/run commands
 > - `/docs/development/frontend.md` - Frontend development guide
 > - `/docs/development/backend.md` - Backend development guide with testing commands
+> - `/docs/development/app.md` - Desktop app development guide
 > - `/docs/development/testing.md` - Load testing guide
 > - `/docs/development/architecture.md` - Architecture documentation
 > - `/docs/development/plugins/index.md` - Plugin system overview
@@ -83,7 +84,7 @@ should NOT unless explicitly requested or strictly necessary for the change
 - **`backend/`** — Go server and API; see `/backend/README.md` and `/docs/development/backend.md` for server commands.
 - **`docs/`** — all developer and user docs; reference specific files under `docs/` for workflows.
 - **`plugins/`** — plugin system and examples; see `/plugins/README.md` and `/docs/development/plugins/`.
-- **`app/`** — desktop application (Electron); see `/app/README.md`.
+- **`app/`** — desktop application (Electron); see `/app/README.md` and `/docs/development/app.md` for build/run/test commands.
 - **CI & infra:** `.github/workflows/`, Dockerfiles (`/Dockerfile`, `/Dockerfile.plugins`), Kubernetes manifests (`kubernetes-headlamp*.yaml`), Helm charts (`/charts/`) — treat as manual-review-only.
 
 ---
@@ -117,10 +118,13 @@ should NOT unless explicitly requested or strictly necessary for the change
 - **Lint backend (fix):** `npm run backend:lint:fix` (from `/package.json`, documented in `/docs/development/backend.md`)
 - **Lint frontend:** `npm run frontend:lint` (from `/package.json`)
 - **Lint frontend (fix):** `npm run frontend:lint:fix` (from `/package.json`)
+- **Lint app:** `npm run app:lint` (from `/package.json`, documented in `/docs/development/app.md`)
+- **Lint app (fix):** `npm run app:lint:fix` (from `/package.json`, documented in `/docs/development/app.md`)
 
 #### Format commands (from `/package.json` and `/docs/development/backend.md`):
 - **Format backend:** `npm run backend:format` (from `/package.json`, documented in `/docs/development/backend.md`)
 - **Format and lint frontend:** `npm run frontend:lint:fix` (from `/package.json`)
+- **Format app:** `npm run app:format` (from `/package.json`, documented in `/docs/development/app.md`)
 
 #### Documentation generation (from `/package.json` and `/docs/development/frontend.md`):
 - **Generate API docs:** `npm run docs` (from `/package.json`, documented in `/docs/development/frontend.md`)
@@ -227,14 +231,25 @@ should NOT unless explicitly requested or strictly necessary for the change
   3. `npm run backend:test` (from `/package.json`, documented in `/docs/development/backend.md`)
   4. `npm run backend:format` (from `/package.json`, documented in `/docs/development/backend.md`)
 
-#### Example 3: Documentation update
+#### Example 3: Desktop app code fix
+- **Files to change:** `app/electron/example.ts` (example path)
+- **Rationale:** Fix window management issue in Electron app
+- **Commands to validate:**
+  1. `npm run app:install` (from `/package.json`)
+  2. `npm run app:lint:fix` (from `/package.json`, documented in `/docs/development/app.md`)
+  3. `npm run app:format` (from `/package.json`, documented in `/docs/development/app.md`)
+  4. `npm run app:lint` (from `/package.json`, documented in `/docs/development/app.md`)
+  5. `npm run app:tsc` (from `/package.json`, documented in `/docs/development/app.md`)
+  6. `npm run app:test` (from `/package.json`, documented in `/docs/development/app.md`)
+
+#### Example 4: Documentation update
 - **Files to change:** `docs/development/index.md` (from consulted files list)
 - **Rationale:** Clarify local dev startup steps to match current npm scripts
 - **Commands to validate:**
   - Run the documented commands exactly as written and confirm they succeed
   - For doc-only changes, testing commands is sufficient; no build needed
 
-#### Example 4: Plugin development
+#### Example 5: Plugin development
 - **Files to change:** Plugin code in `/plugins/examples/` directory
 - **Rationale:** Add new plugin example
 - **Commands to validate:**
@@ -327,18 +342,19 @@ Reference: `/docs/contributing.md` and `/.github/pull_request_template.md`
 1. `/docs/development/index.md` - Primary development guide (lines 1-310)
 2. `/docs/development/frontend.md` - Frontend dev guide (lines 1-82)
 3. `/docs/development/backend.md` - Backend dev guide (lines 1-69)
-4. `/docs/development/testing.md` - Testing guide (lines 1-83)
-5. `/docs/development/architecture.md` - System architecture
-6. `/docs/development/plugins/index.md` - Plugin system
-7. `/docs/development/plugins/building.md` - Building plugins
-8. `/docs/development/plugins/getting-started.md` - Plugin quickstart
-9. `/docs/development/plugins/publishing.md` - Publishing plugins
-10. `/docs/development/plugins/common-patterns.md` - Plugin patterns
-11. `/docs/development/i18n/index.md` - Internationalization
-12. `/docs/development/release-guide.md` - Release process
-13. `/docs/contributing.md` - Contribution guidelines
-14. `/docs/faq.md` - FAQ
-15. `/docs/platforms.md` - Tested platforms
+4. `/docs/development/app.md` - Desktop app dev guide
+5. `/docs/development/testing.md` - Testing guide (lines 1-83)
+6. `/docs/development/architecture.md` - System architecture
+7. `/docs/development/plugins/index.md` - Plugin system
+8. `/docs/development/plugins/building.md` - Building plugins
+9. `/docs/development/plugins/getting-started.md` - Plugin quickstart
+10. `/docs/development/plugins/publishing.md` - Publishing plugins
+11. `/docs/development/plugins/common-patterns.md` - Plugin patterns
+12. `/docs/development/i18n/index.md` - Internationalization
+13. `/docs/development/release-guide.md` - Release process
+14. `/docs/contributing.md` - Contribution guidelines
+15. `/docs/faq.md` - FAQ
+16. `/docs/platforms.md` - Tested platforms
 
 #### Versioning guidance:
 - Follow semantic versioning (documented in `/docs/development/release-guide.md`)

app/package.json

@@ -16,7 +16,10 @@
     "copy-plugins": "npx --no-install shx rm -rf build/.plugins && mkdirp build/.plugins && copyfiles ../.plugins build/.plugins",
     "dev": "npm run compile-electron && cross-env ELECTRON_DEV=1 electron .",
     "dev-only-app": "npm run compile-electron && cross-env ELECTRON_DEV=1 ELECTRON_START_URL=http://localhost:3000 EXTERNAL_SERVER=true electron .",
+    "format": "cd .. && npm run frontend:format",
     "i18n": "npx --no-install i18next ./electron/main.ts -c ./electron/i18next-parser.config.js",
+    "lint": "cd .. && npm run frontend:lint",
+    "lint-fix": "cd .. && npm run frontend:lint:fix",
     "package": "npm run build && electron-builder build --publish never",
     "package-msi": "npm run build && node windows/msi/build.js",
     "prod-deps": "mkdirp prod_deps && cd ./prod_deps && copyfiles -f ../package.json ../package-lock.json . && npm i --only=prod && cd .. && npx --no-install shx rm -rf ./prod_deps/node_modules/.bin",

charts/headlamp/README.md

@@ -205,6 +205,43 @@ ingress:
         - headlamp.example.com
 ```
 
+### HTTPRoute Configuration (Gateway API)
+
+For users who prefer Gateway API over classic Ingress resources, Headlamp supports HTTPRoute configuration.
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| httpRoute.enabled | bool | `false` | Enable HTTPRoute resource for Gateway API |
+| httpRoute.annotations | object | `{}` | Annotations for HTTPRoute resource |
+| httpRoute.labels | object | `{}` | Additional labels for HTTPRoute resource |
+| httpRoute.parentRefs | list | `[]` | Parent gateway references (REQUIRED when enabled) |
+| httpRoute.hostnames | list | `[]` | Hostnames for the HTTPRoute |
+| httpRoute.rules | list | `[]` | Custom routing rules (optional, defaults to path prefix /) |
+
+Example HTTPRoute configuration:
+```yaml
+httpRoute:
+  enabled: true
+  annotations:
+    gateway.example.com/custom-annotation: "value"
+  labels:
+    app.kubernetes.io/component: ingress
+  parentRefs:
+    - name: my-gateway
+      namespace: gateway-namespace
+  hostnames:
+    - headlamp.example.com
+  # Optional custom rules (defaults to path prefix / if not specified)
+  rules:
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /headlamp
+      backendRefs:
+        - name: my-headlamp
+          port: 80
+```
+
 ### Resource Management
 
 | Key | Type | Default | Description |

charts/headlamp/templates/httproute.yaml

@@ -0,0 +1,37 @@
+{{- if .Values.httpRoute.enabled -}}
+{{- $fullName := include "headlamp.fullname" . -}}
+{{- $svcPort := .Values.service.port -}}
+apiVersion: gateway.networking.k8s.io/v1
+kind: HTTPRoute
+metadata:
+  name: {{ $fullName }}
+  namespace: {{ include "headlamp.namespace" . }}
+  labels:
+    {{- include "headlamp.labels" . | nindent 4 }}
+    {{- with .Values.httpRoute.labels }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
+  {{- with .Values.httpRoute.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  parentRefs:
+    {{- required "A valid .Values.httpRoute.parentRefs entry is required when httpRoute.enabled is true" .Values.httpRoute.parentRefs | toYaml | nindent 4 }}
+  {{- with .Values.httpRoute.hostnames }}
+  hostnames:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+  rules:
+    {{- if .Values.httpRoute.rules }}
+    {{- toYaml .Values.httpRoute.rules | nindent 4 }}
+    {{- else }}
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /
+      backendRefs:
+        - name: {{ $fullName }}
+          port: {{ $svcPort }}
+    {{- end }}
+{{- end }}

charts/headlamp/tests/test_cases/httproute-enabled.yaml

@@ -0,0 +1,12 @@
+# Test case for HTTPRoute Gateway API configuration
+httpRoute:
+  enabled: true
+  annotations:
+    gateway.example.com/annotation: "test"
+  labels:
+    app.kubernetes.io/component: ingress
+  parentRefs:
+    - name: my-gateway
+      namespace: gateway-namespace
+  hostnames:
+    - headlamp.example.com

charts/headlamp/values.schema.json

@@ -445,6 +445,60 @@
         }
       }
     },
+    "httpRoute": {
+      "type": "object",
+      "description": "HTTPRoute configuration for Gateway API",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable HTTPRoute resource for Gateway API"
+        },
+        "annotations": {
+          "type": "object",
+          "description": "Annotations for HTTPRoute resource"
+        },
+        "labels": {
+          "type": "object",
+          "description": "Additional labels for HTTPRoute resource"
+        },
+        "parentRefs": {
+          "type": "array",
+          "description": "Parent references (REQUIRED when enabled - HTTPRoute will not work without this)",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Name of the parent gateway"
+              },
+              "namespace": {
+                "type": "string",
+                "description": "Namespace of the parent gateway"
+              },
+              "sectionName": {
+                "type": "string",
+                "description": "Section name of the parent gateway listener"
+              }
+            },
+            "required": ["name"]
+          }
+        },
+        "hostnames": {
+          "type": "array",
+          "description": "Hostnames for the HTTPRoute",
+          "items": {
+            "type": "string"
+          }
+        },
+        "rules": {
+          "type": "array",
+          "description": "Custom routing rules (optional, defaults to path prefix /)",
+          "items": {
+            "type": "object"
+          }
+        }
+      }
+    },
     "podDisruptionBudget": {
       "type": "object",
       "properties": {

charts/headlamp/values.yaml

@@ -240,6 +240,39 @@ ingress:
   #    hosts:
   #      - chart-example.local
 
+# HTTPRoute configuration for Gateway API
+# Please refer to https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.HTTPRoute
+httpRoute:
+  # -- Enable HTTPRoute resource for Gateway API
+  enabled: false
+  # -- Annotations for HTTPRoute resource
+  annotations: {}
+  # -- Additional labels for HTTPRoute resource
+  labels: {}
+  # -- Parent references (REQUIRED when enabled - HTTPRoute will not work without this)
+  # Example:
+  # parentRefs:
+  #   - name: my-gateway
+  #     namespace: gateway-namespace
+  parentRefs: []
+  # -- Hostnames for the HTTPRoute
+  # Example:
+  # hostnames:
+  #   - headlamp.example.com
+  hostnames: []
+  # -- Custom routing rules (optional, defaults to path prefix /)
+  # If not specified, a default rule routing all traffic to the service is used
+  rules: []
+  # Example custom rules:
+  # rules:
+  #   - matches:
+  #       - path:
+  #           type: PathPrefix
+  #           value: /headlamp
+  #     backendRefs:
+  #       - name: "{{ .Release.Name }}-headlamp"
+  #         port: 80
+
 # -- CPU/Memory resource requests/limits
 resources:
   {}