ag-rpi-mega

Lean plugin SDK for authoring rpi-mega cluster workloads.

ag-rpi-mega publishes only what a plugin needs: the Kubernetes resource types, the Stack builder and helpers, and the ClusterPlugin contract. It contains no cluster addresses, hostnames, image pins, secret references, or credentials — those belong to the private host (rpi-mega), which injects them through ClusterFacilities and ClusterPluginContext.

Install

pnpm add ag-rpi-mega

Contract

import type { ClusterPlugin } from 'ag-rpi-mega';

export const plugin: ClusterPlugin = {
  name: 'example',
  namespace: 'example',
  requiredEnv: ['EXAMPLE_URL'],
  requiredSecrets: ['example-token'],
  requiredImages: ['example'],
  stacks(context) {
    // context.env, context.secret('example-token'), context.facilities
    return [];
  },
};

Boundaries

• Secrets are declared by logical name and resolved by the host. A plugin never contains a Secret name, namespace, SSM path, or value.
• Cluster values (metalLb, image, kubeDomain, annotations, labels, NFS hostname) are injected by the host, never imported by a plugin.
• rpi-mega owns discovery, context construction, validation, and YAML output.