Skip to main content

0019 — SeaweedFS with the canonical spec.s3 interface

Run SeaweedFS with the canonical top-level spec.s3 interface and a separate S3 deployment.

Public edition condensed on 2026-10-21; original decision date and meaning retained.

Superseded

ADR 0043 replaced the 000 replication choice with two-copy placement. The standalone S3 interface, filers, and Longhorn-backed volumes remain.

Context​

A new SeaweedFS operator release added the canonical standalone S3 field. Installing the deprecated embedded field from ADR 0016 and then planning a migration would add work for no benefit.

Decision​

Use top-level spec.s3 with a separate S3 deployment, and keep the filer. The selected shape:

ComponentSetting
S32 replicas
Filer2 replicas
Master3 replicas
Volume serversLonghorn-backed
SeaweedFS replication000
ExposureInternal only
First consumerHarbor

Version numbers and values in the original are historical; verify chart support and the repository before implementing.

Alternatives considered​

  • Keep the embedded FilerSpec.S3 path: a deprecated field and a guaranteed migration.

Consequences​

This was the cluster's first use of the standalone S3 path, so it needed scratch validation before production. Filer HA with embedded LevelDB was still unresolved; the interface change did not settle it.

SeaweedFS is a critical dependency for its S3 consumers, and Longhorn replication is not a backup. The pending validation and backup work remain open.