Skip to content

Catalog format

The catalog is a normalized YAML index generated by productive-k3s-ops.

The website currently expects this minimal shape:

apiVersion: catalogs.productive-k3s.io/v1alpha1
kind: ProductiveK3SCatalog
metadata:
  name: productive-k3s-catalog
  generatedAt: "2026-05-27T00:00:00Z"
entries:
  - id: core-rancher
    name: Rancher
    kind: addon
    visibility: public
    category: management
    description: Rancher dashboard for Productive K3S clusters.
    version: 0.1.0
    sourceRepository: productive-k3s-addons
    artifact:
      type: tgz
      url: https://example.com/rancher-0.1.0.tgz
    tags:
      - rancher
      - dashboard
      - management

Profiles may also expose installation metadata derived from the source repository:

install:
  requiresLocalOverrides: true
  inputs:
    - name: AWS_REGION
      required: true
      sensitive: false
      source: package-default
      description: Default AWS region used for provisioning
    - name: AWS_KEY_PAIR_NAME
      required: true
      sensitive: false
      source: local-override
      description: Existing AWS EC2 key pair name

This summary is generated by productive-k3s-ops from profile metadata that lives beside the source *.env profiles in the Infra repositories. It is intended for discovery and UX, not as a replacement for the package manifest itself.

Protected entries may omit the direct artifact URL and expose a commercial action instead:

artifact:
  type: tgz
  url: null
commercial:
  label: Request access
  url: https://productive-k3s.io/contact/