Each folder has an orcinus.yml you can deploy with:
cd examples/<folder>
orcinus deploy --wait # picks up orcinus.yml automatically| Example | What it shows |
|---|---|
wordpress/ |
Fullstack WordPress + MariaDB — StatefulSet DB, PVCs, secrets, Ingress. Pure compose with x-orcinus-*. |
postgres-operator/ |
HA Postgres via an operator (CloudNativePG) — applies the operator's Cluster custom resource. |
traefik-letsencrypt/ |
Web app exposed through Traefik with a Let's Encrypt cert (cert-manager). Mixes a compose service with raw k8s manifests in one file. |
redis/ |
Redis with persistence — StatefulSet + PVC + Service. Reachable at redis:6379. |
monitoring/ |
Prometheus + Grafana stack — PVCs, Grafana admin password in a Secret, both exposed via Ingress. |
app-with-cnpg/ |
A web app (Adminer) connecting to the CNPG Postgres cluster from postgres-operator/, consuming the operator-generated Secret via envFrom. |
ingress-tls/ |
Web app on a public domain with automatic Let's Encrypt HTTPS — x-orcinus-expose: ingress + x-orcinus-host + x-orcinus-tls. See ../docs/PLUGINS.md. |
deploy-strategies/ |
Update strategies: Swarm deploy.update_config (rolling) + x-orcinus-strategy: recreate. See ../docs/DEPLOYMENT.md. |
autoscale/ |
Horizontal autoscaling via x-orcinus-autoscale-* (HPA on CPU). |
rollout/ |
Progressive delivery — x-orcinus-rollout: canary / bluegreen (Argo Rollouts, auto-installed). |
custom-cert/ |
Bring-your-own TLS cert (incl. wildcard) via orcinus secret create-tls + x-orcinus-tls-secret. |
traefik-middleware/ |
Traefik middlewares — path prefix stripping (x-orcinus-strip-prefix) + attaching rate-limit / headers / auth / redirect by name (x-orcinus-middleware). See ../docs/INGRESS.md. |
private-registry/ |
Private image registry — orcinus secret create-registry + x-orcinus-image-pull-secret. See ../docs/REGISTRY.md. |
placement/ |
Placement & node constraints — Swarm deploy.placement → nodeAffinity/topologySpread + orcinus node label. See ../docs/USAGE.md. |
kubevirt/ |
Virtual machines next to containers (KubeVirt). Compose style via x-orcinus-vm: vm-compose.yml and vm-compose-web.yml (persistent disk + SSH key + ingress). Raw-manifest style: orcinus.yml — a container + Ubuntu/Fedora VMs reachable by Service DNS. Plus distros.yml (a stopped Ubuntu/Fedora/Debian/CentOS/Alma/openSUSE catalog), cdi-datavolume.yml (persistent disk via CDI) and ssh-public.yml (SSH by key + public IP/ingress). See ../docs/PLUGINS.md. |
Single-file basics also live here: orcinus.yml and
docker-compose.yml.
Some examples need a prerequisite installed first (an operator or cert-manager) — see the comments at the top of each file. To preview what a file produces without deploying:
orcinus deploy -f orcinus.yml --dry-run