Formato del catálogo¶
El catálogo es un índice YAML normalizado generado por productive-k3s-ops.
El sitio actualmente espera, como mínimo, esta forma:
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
Los profiles también pueden exponer metadatos de instalación derivados del repositorio fuente:
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
Los Profiles también pueden exponer el contrato de runtime copiado desde su manifiesto empaquetado:
runtime:
executionScope: local-host
requiredCapabilities:
- local-virtualization
requiredCommands:
- multipass
- tofu
Los clientes usan este bloque para evaluar si el entorno actual puede ejecutar el Profile. El vocabulario describe capacidades y comandos, no nombres de Profiles.
Estos resúmenes los genera productive-k3s-ops desde la metadata del paquete
de Profile. Están pensados para discovery y UX, no como reemplazo del
manifiesto del paquete.
Las entradas protegidas pueden omitir la URL directa del artifact y exponer en cambio una acción comercial: