Skip to content

llama-stack-k8s-operator

Architecture snapshot: 2026-04-29 (2026-04-29)

Repository: llamastack/llama-stack-k8s-operator
Analyzer: arch-analyzer 0.2.0
Extracted: 2026-04-29T11:06:01Z

Summary

Metric Count
CRDs 1
Deployments 4
Services 1
Secrets 0
Cluster Roles 5
Controller Watches 9

Component Architecture

CRDs, controllers, and owned Kubernetes resources.

graph LR
    %% Component architecture for llama-stack-k8s-operator

    classDef crd fill:#e74c3c,stroke:#c0392b,color:#fff
    classDef controller fill:#3498db,stroke:#2980b9,color:#fff
    classDef owned fill:#2ecc71,stroke:#27ae60,color:#fff
    classDef external fill:#95a5a6,stroke:#7f8c8d,color:#fff
    classDef dep fill:#f39c12,stroke:#e67e22,color:#fff

    subgraph controller["llama-stack-k8s-operator Controller"]
        dep_1["controller-manager"]
        class dep_1 controller
        dep_2["controller-manager"]
        class dep_2 controller
        dep_3["controller-manager"]
        class dep_3 controller
        dep_4["deployment"]
        class dep_4 controller
    end

    crd_LlamaStackDistribution{{"LlamaStackDistribution\nllamastack.io/v1alpha1"}}
    class crd_LlamaStackDistribution crd
    crd_LlamaStackDistribution -->|"For (reconciles)"| controller
    controller -->|"Owns"| owned_5["ConfigMap"]
    class owned_5 owned
    controller -->|"Owns"| owned_6["Deployment"]
    class owned_6 owned
    controller -->|"Owns"| owned_7["HorizontalPodAutoscaler"]
    class owned_7 owned
    controller -->|"Owns"| owned_8["Ingress"]
    class owned_8 owned
    controller -->|"Owns"| owned_9["NetworkPolicy"]
    class owned_9 owned
    controller -->|"Owns"| owned_10["PersistentVolumeClaim"]
    class owned_10 owned
    controller -->|"Owns"| owned_11["PodDisruptionBudget"]
    class owned_11 owned
    controller -->|"Owns"| owned_12["Service"]
    class owned_12 owned

CRDs

Group Version Kind Scope Fields Validation Rules Source
llamastack.io v1alpha1 LlamaStackDistribution Namespaced 371 1 config/crd/bases/llamastack.io_llamastackdistributions.yaml

Dependencies

Key External Dependencies

Module Version
github.com/go-logr/logr v1.4.3
k8s.io/api v0.34.3
k8s.io/apiextensions-apiserver v0.34.3
k8s.io/apimachinery v0.34.3
k8s.io/client-go v0.34.3
sigs.k8s.io/controller-runtime v0.22.4