Skip to content

docker: resource requirements + multi-subnet/shard override compose (#28) - #41

Open
Alicepoltora wants to merge 2 commits into
AdvaitaLabs:mainfrom
Alicepoltora:docs/docker-subnet-shard-override
Open

docker: resource requirements + multi-subnet/shard override compose (#28)#41
Alicepoltora wants to merge 2 commits into
AdvaitaLabs:mainfrom
Alicepoltora:docs/docker-subnet-shard-override

Conversation

@Alicepoltora

Copy link
Copy Markdown

Closes #28.

What

Two files, one change set:

docker/docker-compose.subnet-override.yml is a new override file that layers 2 extra shard-tagged solvers (solver-shard-a, solver-shard-b) on top of docker-compose.multi-validator.yml, so contributors can exercise shard-aware solver registration without hand-writing a new compose file. It also adds illustrative per-solver CPU/memory limits.

docker/README.md gets three additions: a new "Resource Requirements" section with a sizing table (dev/CI minimum vs. suggested prod starting point) for Validator and Solver nodes, including AWS Nitro Enclave allocation guidance for production TEE solvers; a new "Scenario 5: Multi-Subnet / Shard Testing (Override)" entry under Deployment Scenarios documenting how to use the override file; and an updated directory structure listing that includes the new file.

Why

#28 asked for two things: resource requirement notes for TEE solvers in production, and an example docker-compose override for multi-subnet testing. This PR covers both.

Scope / honesty notes

The resource numbers are general starting-point guidance (informed by how AWS Nitro Enclaves reserve vCPU/memory via /etc/nitro_enclaves/allocator.yaml), not benchmarks measured against Setu's actual workload. That's stated explicitly in the doc, with an invitation for maintainers/community to replace it with real numbers.

Subnet routing itself is still on the roadmap per the main README, so the override demonstrates topology and shard-tagged registration only, not consensus-level subnet isolation. That's called out in both the compose file header and the README section so it isn't overclaimed.

Also noted that deploy.resources.limits needs Compose's --compatibility flag (or Swarm mode) to actually be enforced outside Swarm.

Happy to adjust the resource numbers or topology if you have real benchmarks or a different shape in mind for subnet testing.

This file serves as an override for multi-subnet testing, adding shard-tagged solvers to the existing multi-validator stack. It includes resource limits and configuration for the solvers.
Added subnet override compose file for multi-subnet/shard testing.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improvement in the docker deployment

1 participant