mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
2.5 KiB
2.5 KiB
hip, title, author, type, category, status, implementation-rust, created
| hip | title | author | type | category | status | implementation-rust | created |
|---|---|---|---|---|---|---|---|
| 0407 | Base CRD | Hanzo Platform Team | Standards Track | Operator | Final | partial | 2026-05-19 |
HIP-0407: Base CRD
Abstract
The Base CRD (renamed from BaseApp in v0.3.0) models a Hanzo Base distribution app: a stateful, writer-elected, single-leader workload backed by hanzoai/base. Base is the embedded-SQLite-with-replication runtime that powers the Hanzo Base PaaS (HIP-038). Each Base CR runs as a StatefulSet with a Quasar consensus writer election; the gateway proxies writes to the current leader and serves reads from any replica.
Specification
Group + version
hanzo.ai/v1, plural bases, shortname bapp.
Spec fields
| Field | Type | Description |
|---|---|---|
image |
ImageSpec | Base distribution image |
replicas |
int | StatefulSet replicas (odd, typically 3 or 5) |
port |
int | HTTP port |
consensus |
string | quasar (default) |
schema |
string | optional initial schema URL or inline DDL |
storage |
StorageSpec | per-replica PVC |
env, envFrom |
array | environment |
gateway |
BaseGatewaySpec | gateway route + leader poll interval + read-your-writes TTL |
iamApp |
string | IAM application client_id |
kmsSecrets |
[]KMSSecretRef | KMS-sourced secrets |
networkPolicy |
NetworkPolicySpec | optional |
serviceMonitor |
ServiceMonitorSpec | optional |
Example CR
apiVersion: hanzo.ai/v1
kind: Base
metadata:
name: my-app
namespace: hanzo
spec:
image:
repository: ghcr.io/hanzoai/base
tag: v1.2.3
replicas: 3
port: 8090
consensus: quasar
storage:
storageClassName: do-block-storage
size: 10Gi
retentionPolicy: Retain
gateway:
route: /v1/my-app
gatewayName: gateway
gatewayNamespace: hanzo
leaderPollInterval: 2s
readYourWritesTTL: 5s
iamApp: app-my-app
Generated K8s resources
- StatefulSet (one Pod per replica)
- Headless Service (peer discovery)
- ClusterIP Service (client traffic)
- PVC templates
- Optional Gateway route (auto-injected into the Gateway CR)
Operator reconciler
~/work/hanzo/operator/src/controllers/baseapp.rs (controller file retains historical name).
Related services
- HIP-0105 (in-process extension runtime standard)
- HIP-0302 (encrypted SQLite replication standard)
- Used by: Hanzo Base PaaS apps.
Status
Implemented in hanzoai/operator v0.3.0+. Kind renamed from BaseApp to Base in the v0.3.0 schema cleanup.