Skip to content

Deployment Index

Document ID: DEP-INDEX-001
File Path: docs/12-deployment/index.md
Version: 1.2.0
Status: Active
Owner: Platform Operations Team
Last Updated: 2026-07-18

1. Purpose

This document is the central navigation for deploying the Wovyr AI Platform. It is the practical, artifact-level guide (Docker, Compose, Kubernetes, Helm, Terraform) that operationalizes the conceptual Deployment Architecture.

2. Deployment Topologies

Topology	Use	Guide
Single binary	Local dev / evaluation	docker.md
Bare-metal / systemd	Single-node appliance, no container runtime	systemd.md
Compose stack	Team / small self-host	docker-compose.md
Kubernetes	Production, scalable	kubernetes.md / helm.md
Cloud infra	Managed datastores + K8s	terraform.md

These map to the deployment models in C4 Container §7.

3. Components to Deploy

Current (v1.0, ADR-0010 Path A): every service below runs inside one wovyr binary — there is no independent-service deployment today. The table’s per-service split is the aspirational v1.1+ topology; see §10 of docker-compose.md for what’s actually shipped.

Stateless services        Stateful backends
─────────────────         ─────────────────
API Gateway               PostgreSQL (optional — marketplace registry is
Agent Runtime              wired; workflow store is library-only/unwired)
Workflow Engine           Qdrant (optional — CLI-only tiered memory backend;
LLM Gateway                gateway semantic cache is library-only/unwired)
Memory Engine             Redis (library-only gateway breaker sharing;
Tool Runtime (+ workers)   not attached by any shipping binary)
Plugin Engine             Object storage (S3-compatible) — not implemented
Dashboard (UI + BFF)      NATS JetStream — not used anywhere in this workspace

Each service exposes /healthz, /readyz, /metrics (observability — planned reference) once the service split above is actually built; today the single wovyr binary exposes /healthz and /metrics directly.

4. Document Map

Document	Responsibility
docker.md	Images, single-binary container, build/run
systemd.md	Bare-metal appliance install: systemd unit, `install.sh`, env-file config
docker-compose.md	Full local/self-host stack
kubernetes.md	Manifests, scaling, probes, networking
helm.md	Helm chart, values, upgrades
terraform.md	Cloud infrastructure provisioning
backup-and-restore.md	`wovyr admin backup`/`restore`, KMS root-key escrow, RPO/RTO targets
upgrade-and-migration.md	Operator upgrade runbook: backup → binary swap → `wovyr admin migrate` → verify → rollback, per deployment shape

5. Principles

Same artifacts everywhere — one image set across topologies.
12-factor config — environment/secret-driven, no baked secrets.
Stateless services, external state — scale services freely.
Health-gated rollouts — probes + rolling updates.
Secure by default — mTLS, secrets via vault, least privilege.

6. Dependencies

11-cli/commands.md — wovyr deploy
13-security (planned) · 14-observability (planned)

8. Revision History

Version	Date	Description
1.1.0	2026-07-14	Added the bare-metal/systemd topology (RM-AIM-P3 DEP-301): `deployment/install.sh` + `deployment/systemd/*`, new systemd.md
1.0.0	2026-06-27	Initial Deployment Index