cozystack/packages/system/linstor-gui
Myasnikov Daniil a9a66bf066
build(linstor): use shared BUILDX_ARGS for linstor-gui image build
The per-package Makefile added in #2382 hardcoded buildx flags
(--provenance, --builder, --platform=linux/amd64,linux/arm64,
--push, --load, --label) instead of using the shared $(BUILDX_ARGS)
macro from hack/common-envs.mk.

This broke CI: the runner's default docker driver does not support
multi-platform builds, and the hardcoded multi-arch platform list
crashed `make build` with "Multi-platform build is not supported for
the docker driver."

Replace the hardcoded flags with $(BUILDX_ARGS) to match every other
package (e.g. linstor, dashboard, cilium). $(BUILDX_ARGS) injects
--push, --load, --label, --provenance=false, and only sets --builder
or --platform when the operator explicitly exports BUILDER/PLATFORM.

Assisted-By: Claude <noreply@anthropic.com>
Signed-off-by: Myasnikov Daniil <myasnikovdaniil2001@gmail.com>
2026-04-27 17:31:07 +05:00
..
images/linstor-gui [linstor-gui] Address review comments on #2382 2026-04-13 11:59:46 +05:00
templates fix(platform): migrate ACME HTTP-01 to ingressClassName API 2026-04-21 17:00:31 +05:00
tests fix(linstor): restrict linstor-gui to cozystack-cluster-admin group 2026-04-17 11:32:44 +05:00
Chart.yaml [linstor-gui] Add package for LINBIT linstor-gui web UI 2026-04-13 11:48:35 +05:00
Makefile build(linstor): use shared BUILDX_ARGS for linstor-gui image build 2026-04-27 17:31:07 +05:00
README.md fix(linstor): restrict linstor-gui to cozystack-cluster-admin group 2026-04-17 11:32:44 +05:00
values.yaml [linstor-gui] Add package for LINBIT linstor-gui web UI 2026-04-13 11:48:35 +05:00

linstor-gui

Cozystack system package for LINBIT/linstor-gui — a web UI for managing LINSTOR nodes, resources, volumes and snapshots.

Installed alongside the linstor package in the cozy-linstor namespace. The UI proxies the LINSTOR controller REST API at https://linstor-controller.cozy-linstor.svc:3371 using mTLS with the linstor-client-tls secret created by the linstor package.

Exposing the UI

The chart ships an oauth2-proxy based gatekeeper plus a KeycloakClient CRD so the UI can be published on linstor-gui.<root-host> behind the cluster Keycloak realm. Access is restricted to members of the cozystack-cluster-admin Keycloak group — the same group that grants cluster-admin RBAC on the host cluster. Authenticating against the cozy realm alone is not sufficient; users outside that group receive a 403 from oauth2-proxy before any request reaches the UI or the LINSTOR controller.

To turn it on, add linstor-gui to publishing.exposedServices in the core cozystack values (same list that controls dashboard). OIDC must be enabled (authentication.oidc.enabled: true) — if it is not, the Ingress and gatekeeper Deployment are deliberately not rendered, because the LINSTOR REST API surface must not be exposed unauthenticated.

Once enabled, the UI is reachable at https://linstor-gui.<root-host> and authentication is delegated to Keycloak via the linstor-gui client (auto-provisioned through the KeycloakClient CRD; the client secret is persisted in the linstor-gui-client Secret in cozy-linstor).

Option 2 — Port-forward

If you have not set up Keycloak or want ad-hoc access, use the ClusterIP Service:

kubectl -n cozy-linstor port-forward svc/linstor-gui 3373:80

then open http://localhost:3373.

Parameters

Image

Name Description Value
image.repository LINSTOR GUI container image repository ghcr.io/cozystack/cozystack/linstor-gui
image.tag LINSTOR GUI container image tag (digest recommended) 2.3.0

Deployment

Name Description Value
replicas Number of linstor-gui replicas 1

LINSTOR controller connection

Name Description Value
linstor.endpoint In-cluster URL of the LINSTOR controller REST API (HTTPS, mTLS) https://linstor-controller.cozy-linstor.svc:3371
linstor.clientSecret Kubernetes Secret with tls.crt, tls.key, ca.crt used as the mTLS client certificate against the LINSTOR controller. Created by the linstor package. linstor-client-tls