Skip to content

[doc] add SeaweedFS integration doc#3607

Open
chrislusf wants to merge 3 commits intoapache:masterfrom
chrislusf:add-doris-seaweedfs-doc
Open

[doc] add SeaweedFS integration doc#3607
chrislusf wants to merge 3 commits intoapache:masterfrom
chrislusf:add-doris-seaweedfs-doc

Conversation

@chrislusf
Copy link
Copy Markdown

Versions

  • dev
  • 4.x
  • 3.x
  • 2.1

Languages

  • Chinese
  • English

Summary

Adds an Iceberg lakehouse integration page for SeaweedFS, which exposes both an S3 object endpoint and an Apache Iceberg REST Catalog from the same weed process. The doc walks through:

  1. Starting weed mini with a single IAM config and a pre-created S3 Tables bucket.
  2. Registering the catalog in Doris with iceberg.catalog.type = "rest", where the OAuth2 client credentials and the S3 keys are the same access pair.
  3. Reading and writing an Iceberg table.

The same end-to-end path is exercised in CI by the TestDorisIcebergCatalog integration test in the SeaweedFS repo (test/s3tables/catalog_doris/), which boots SeaweedFS, registers a Doris Iceberg catalog against it, writes rows via PyIceberg, and reads them back from apache/doris:doris-all-in-one-2.1.0. The Doris catalog properties in the doc are the ones the test uses verbatim.

Files

  • 4 English pages: docs/, docs-next/, versioned_docs/version-3.x, versioned_docs/version-4.x
  • 4 Chinese pages: corresponding i18n/zh-CN/... paths
  • 4 sidebars: sidebars.ts, sidebars-next.ts, versioned_sidebars/version-{3,4}.x-sidebars.jsondoris-seaweedfs slotted under the Iceberg Catalog category, after doris-lakekeeper.

I'm the maintainer of SeaweedFS, so I can keep this page in sync with future changes upstream.

chrislusf added 2 commits May 4, 2026 02:00
SeaweedFS serves both the S3 object data and the Iceberg REST catalog
from the same `weed` process, with a single S3 credential pair shared
across both. This page shows the minimal Doris setup; the same path
is exercised end-to-end by the TestDorisIcebergCatalog integration
test in the SeaweedFS repo.
@chrislusf chrislusf changed the title [feat] add SeaweedFS integration doc [doc] add SeaweedFS integration doc May 4, 2026
@chrislusf chrislusf marked this pull request as draft May 4, 2026 09:08
@chrislusf chrislusf marked this pull request as ready for review May 4, 2026 09:13
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.

1 participant