Playground¶

Spin up a fully functional local environment for testing omo plugins — Docker services, sample data, a kind Kubernetes cluster (with Argo CD + demo workloads), and KeePass entries under <plugin>/development/local.

Source: omo-playground (or your local ~/Work/omo-playground).

Excluded plugins

The playground does not seed awsCosts or s3 (cloud credentials required).

Quick start¶

# Prerequisites: Docker, git, curl. kind/kubectl installed by `make tools`.
# OMO source expected at ~/Work/omo (or set OMO_REPO / have `omo` on PATH).

cd ~/Work/omo-playground
make setup

# Optional GitHub plugin:
GITHUB_TOKEN=ghp_xxx make seed-keepass

# Then build/run OMO
cd ~/Work/omo && make && omo

OMO auto-selects KeePass path <plugin>/development/local.

What you get¶

Stack	Endpoint	KeePass path
Redis	`localhost:6379`	`redis/development/local`
Postgres	`localhost:5432` (user/db `omo` / `omo`)	`postgres/development/local`
RabbitMQ	AMQP `5672`, UI `15672`	`rabbitmq/development/local`
Kafka (Redpanda)	`127.0.0.1:19092`	`kafka/development/local`
SSH	`127.0.0.1:2222` (`omo`/`omo`)	`ssh/development/local`
Docker socket	`unix:///var/run/docker.sock`	`docker/development/local`
Git sample repo	`data/git/sample-repo`	`git/development/local`
kind cluster	kubeconfig `~/.kube/omo-playground.yaml`	`k8suser` + `k8sportforward`
Argo CD	`https://localhost:30443` (admin)	`argocd/development/local`
GitHub	PAT from `GITHUB_TOKEN`	`github/development/local`
sysprocess	(no secrets)	—

Demo namespace demo includes Deployments/StatefulSets (demo-api, redis, postgres, rabbitmq) for the k8sportforward plugin.

Make targets¶

Target	Description
`make setup`	tools + compose + kind + argocd + workloads + seeds
`make up` / `make down`	Compose only
`make seed`	Data + KeePass
`make seed-keepass`	Rewrite KeePass `development/local` entries
`make kind-up` / `make argocd-up`	Kubernetes bits
`make clean`	Tear down compose volumes + kind
`make doctor`	Prerequisite check

Credentials¶

Default username/password for playground services: omo / omo.

KeePass vault (shared with OMO):

DB: ~/.omo/secrets/omo.kdbx
Key: ~/.omo/keys/omo.key

omo secrets list
omo secrets get redis/development/local

Notes¶

First make setup downloads kind/kubectl into ~/.local/bin and pulls images — expect several minutes.
Re-run make seed-keepass after make argocd-up so the Argo CD admin password is written into KeePass.
sysprocess needs no KeePass entry.
Do not commit real GitHub PATs; pass GITHUB_TOKEN at seed time.