Installation

Requirements

Argo CD must be installed before Kokumi is deployed. The Serving controller creates and updates Argo CD Application resources to point at the immutable OCI artifacts produced by Preparations. Without Argo CD, Servings will fail and no workloads will be deployed.

Install

kubectl apply -f \
    https://github.com/kokumi-dev/kokumi/releases/download/0.11.0/install.yaml

This installs:

• The Kokumi CRDs (Menu, Recipe, Order, Preparation, Serving)
• The controller manager in the kokumi namespace
• The API server and web UI in the kokumi namespace
• RBAC roles and bindings

Model: Menu provides the reusable template, Recipe carries rendering options (for example Helm settings), and Order is the parameterized request that executes delivery and produces Preparation artifacts. Order does not require Menu: standalone Order-defined intent is supported now and intended to remain supported.

Verify

# CRDs registered
kubectl get crds | grep kokumi.dev

# Manager and server running
kubectl get pods -n kokumi

# Controller logs
kubectl logs -n kokumi deployment/kokumi-controller-manager -c manager -f

Access the UI

kubectl port-forward -n kokumi svc/kokumi-server 8080:80

Open http://localhost:8080 in your browser.

Pin a specific version

Replace 0.11.0 with any released version:

kubectl apply -f \
    https://github.com/kokumi-dev/kokumi/releases/download/<VERSION>/install.yaml

All releases are listed at github.com/kokumi-dev/kokumi/releases.

Upgrade

kubectl apply -f \
    https://github.com/kokumi-dev/kokumi/releases/download/<NEW_VERSION>/install.yaml

Uninstall

kubectl delete -f \
    https://github.com/kokumi-dev/kokumi/releases/download/0.11.0/install.yaml