Skip to content

Commit 863c528

Browse files
committed
docs: clarify RustFS migration compatibility
Signed-off-by: Zoorpha <[email protected]>
1 parent 21e119d commit 863c528

2 files changed

Lines changed: 9 additions & 5 deletions

File tree

‎deploy/compose/README.md‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -47,10 +47,13 @@ keypair.
4747
`<bucket>.rustfs`. It is not configurable for an external S3 provider through
4848
`.env`; use the Helm chart or a custom Compose configuration for providers
4949
such as new Railway Storage Buckets that require `virtual` addressing.
50-
- RustFS does not read the previous MinIO filesystem layout. Existing MinIO
51-
deployments must migrate objects through the S3 API and verify a backup before
52-
switching; `./run.sh start`, `restart`, and `upgrade` refuse to create the new
53-
RustFS volume automatically while only the legacy MinIO volume exists.
50+
- The bundled Compose stack uses RustFS. The Helm quickstart remains the
51+
separate MinIO option, and external S3 providers require the Helm chart or a
52+
custom Compose configuration. The pinned RustFS build is not validated here
53+
for direct reuse of a MinIO data directory: existing MinIO deployments must
54+
migrate objects through the S3 API and verify a backup before switching;
55+
`./run.sh start`, `restart`, and `upgrade` refuse to create the new RustFS
56+
volume automatically while only the legacy MinIO volume exists.
5457

5558
Run `./run.sh backup-hint` for the backup checklist.
5659

‎deploy/compose/run.sh‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,8 @@ guard_legacy_minio_volume() {
4242
! docker volume inspect "${rustfs_volume}" >/dev/null 2>&1; then
4343
cat >&2 <<'MSG'
4444
The previous MinIO data volume exists, but the RustFS data volume does not.
45-
Buzz will not create a new empty RustFS store and hide existing objects.
45+
The pinned RustFS build has not been validated for direct MinIO data-directory
46+
reuse. Buzz will not create a new empty RustFS store and hide existing objects.
4647
Migrate the objects through the S3 API, verify the backup, then retry.
4748
MSG
4849
return 1

0 commit comments

Comments
 (0)