Skip to content

hops-ops/helm-backstage

Repository files navigation

helm-backstage

A Crossplane Configuration package that installs the Backstage developer portal Helm chart with a minimal, stable interface.

Overview

helm-backstage renders a single Helm release for Backstage. It exposes only the inputs needed for chart values, namespace, and release name, keeping the interface stable while allowing full Helm overrides.

Features

  • Minimal Helm interface: values and overrideAllValues with stable defaults
  • Predictable naming: defaults to <clusterName>-backstage in the backstage namespace
  • GitOps friendly: ships a .gitops/ deploy chart

Prerequisites

  • Crossplane installed in the cluster
  • Crossplane providers:
    • provider-helm (>=v1.0.6)
  • Crossplane function:
    • function-auto-ready (>=v0.6.0)

Quick Start

apiVersion: pkg.crossplane.io/v1
kind: Configuration
metadata:
  name: helm-backstage
spec:
  package: ghcr.io/hops-ops/helm-backstage:latest
apiVersion: helm.hops.ops.com.ai/v1alpha1
kind: Backstage
metadata:
  name: backstage
  namespace: example-env
spec:
  clusterName: example-cluster
  values:
    backstage:
      appConfig:
        app:
          title: Developer Portal
          baseUrl: http://localhost:3000
    postgresql:
      enabled: true

Development

make render
make validate
make test