Skip to content

Commit cea0a24

Browse files
mitchrossclaude
andcommitted
docs: update storage architecture for RustFS migration
- Update diagram to show Restic instead of Kopia - Add RustFS endpoint port (30292) - Update bucket name from volsync-backups to volsync - Fix mc alias commands for RustFS access 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 555393c commit cea0a24

1 file changed

Lines changed: 14 additions & 10 deletions

File tree

docs/storage-architecture.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ This document outlines the storage architecture for the cluster, focusing on dat
66

77
The cluster uses a layered storage approach:
88
- **Longhorn**: Distributed block storage for runtime replication (2 replicas per volume)
9-
- **VolSync**: Daily backups of all PVCs to S3 using Kopia/Restic
9+
- **VolSync**: Daily backups of all PVCs to S3 using Restic
1010
- **Database-native backups**: CloudNativePG and Crunchy Postgres backup directly to S3
1111

1212
## Architecture Diagram
@@ -22,17 +22,16 @@ The cluster uses a layered storage approach:
2222
│ ▼ ▼ │
2323
│ ┌──────────────────┐ ┌──────────────────┐ │
2424
│ │ VolSync │ │ Native PG │ │
25-
│ │ (Kopia daily) │ │ WAL + Backups │ │
25+
│ │ (Restic daily) │ │ WAL + Backups │ │
2626
│ └────────┬─────────┘ └────────┬─────────┘ │
2727
│ │ │ │
2828
└───────────┼───────────────────────┼─────────────────────────────┘
2929
│ │
3030
▼ ▼
3131
┌─────────────────────────────────────┐
3232
│ RustFS (S3) on TrueNAS │
33-
│ 192.168.10.133 │
34-
│ ├── volsync-backups/ │
35-
│ └── postgres-backups/ │
33+
│ 192.168.10.133:30292 │
34+
│ └── volsync/<app>/ │
3635
└─────────────────────────────────────┘
3736
```
3837

@@ -74,14 +73,15 @@ graph LR
7473

7574
### PVC Backups (VolSync)
7675

77-
All application PVCs are backed up daily at 2 AM using VolSync with Kopia:
76+
All application PVCs are backed up daily at 2 AM using VolSync with Restic:
7877

7978
| Setting | Value |
8079
|---------|-------|
8180
| Schedule | `0 2 * * *` (daily at 2 AM) |
8281
| Retention | 14 days |
83-
| Backend | Kopia (Restic-compatible) |
84-
| Target | RustFS S3 on TrueNAS |
82+
| Backend | Restic |
83+
| Target | RustFS S3 on TrueNAS (192.168.10.133:30292) |
84+
| Bucket | `volsync` |
8585
| Copy Method | Snapshot |
8686

8787
Each app has:
@@ -186,8 +186,12 @@ kubectl exec -it <postgres-pod> -n postgres-operator -- pgbackrest info
186186

187187
### S3 Bucket Contents
188188
```bash
189-
mc ls truenas/volsync-backups/
190-
mc ls truenas/postgres-backups/
189+
# VolSync backups (RustFS)
190+
mc alias set rustfs http://192.168.10.133:30292 <access_key> <secret_key>
191+
mc ls rustfs/volsync/
192+
193+
# List specific app backup
194+
mc ls rustfs/volsync/home-assistant/
191195
```
192196

193197
## 6. Configuration Files

0 commit comments

Comments
 (0)