stack-orchestrator/docs
Prathamesh Musale 782c71ae36 feat(k8s): enforce kind extraMount compatibility on cluster reuse
Kind applies extraMounts only at cluster creation. When a deployment joins
an existing shared cluster, any extraMount its kind-config declares that
isn't already active on the running control-plane is silently ignored —
PVs backed by those mounts fall through to the node's overlay filesystem
and lose data on cluster destroy.

Validate this up front in create_cluster():
- On cluster reuse, compare the new deployment's extraMounts against the
  live bind mounts on the control-plane container (via docker inspect).
  Fail with a DeployerException listing every mismatched mount and
  pointing at docs/deployment_patterns.md.
- On first-time cluster creation without a /mnt umbrella mount
  (kind-mount-root unset), print a warning that future stacks may
  require a full recreate to add new host-path mounts.

Document the umbrella-mount convention (kind-mount-root) and the
migration path for existing clusters in docs/deployment_patterns.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 09:30:12 +00:00
..
images stack diagram: fix diagram & compress img 2023-01-20 11:04:24 -05:00
CONTRIBUTING.md Migrate canonical source from Gitea to GitHub (#738) 2026-04-02 10:58:14 +05:30
README.md Gitea x Laconicd + some doc updates (#549) 2023-09-27 17:36:12 -04:00
adding-a-new-stack.md Update links from github.com to git.vdb.to (#732) 2024-02-06 22:42:44 +00:00
cli.md Add Job and secrets support for k8s-kind deployments (#995) 2026-03-11 03:56:21 +00:00
deployment_patterns.md feat(k8s): enforce kind extraMount compatibility on cluster reuse 2026-04-20 09:30:12 +00:00
docker-compose-deployment.md Add Docker Compose deployment guide 2026-01-17 18:17:01 -05:00
fetching-containers.md Apply pre-commit linting fixes 2026-01-20 23:16:44 -05:00
gitea-with-laconicd-fixturenet.md Apply pre-commit linting fixes 2026-01-20 23:16:44 -05:00
helm-chart-generation.md Add support for generating Helm charts when creating a deployment (#974) 2025-11-27 06:43:07 +00:00
k8s-deployment-enhancements.md Apply pre-commit linting fixes 2026-01-20 23:16:44 -05:00
laconicd-with-console.md Update fixturenet-laconicd stack for renaming changes (#891) 2024-07-25 08:50:15 +00:00
release-process.md Apply pre-commit linting fixes 2026-01-20 23:16:44 -05:00
spec.md Apply pre-commit linting fixes 2026-01-20 23:16:44 -05:00
webapp.md Apply pre-commit linting fixes 2026-01-20 23:16:44 -05:00

README.md

Stack Orchestrator

Here you will find information about the design of stack orchestrator, contributing to it, and deploying services/applications that combine two or more "stacks".

Most "stacks" contain their own README which has plenty of information on deploying, but stacks can be combined in a variety of ways which are document here, for example: