https://danchupin.github.io/strata/reference/Recent content in Reference on Strata DocumentationHugoenhttps://danchupin.github.io/strata/reference/env-vars/Mon, 01 Jan 0001 00:00:00 +0000https://danchupin.github.io/strata/reference/env-vars/<!-- Maintainer note: source of truth for new entries is the codebase. Grep with `grep -rhoE 'STRATA_[A-Z_][A-Z0-9_]+' cmd/strata/ internal/ | sort -u` and cross-reference defaults + clamp ranges at the consuming call sites (koanf envMap, worker `*FromEnv` helpers, `os.Getenv(...)`). Update this page when adding a new env var. The `TOML key` column mirrors `envMap` in `internal/config/config.go`. Exempt env vars (bootstrap, test-only, retired, build metadata) show `—`. The drift-lint test `internal/config/env_toml_parity_test.go` fails the build if a STRATA_* var is added without wiring through Config + envMap + this page, so keep all three in lockstep. --> <h1 id="strata_-environment-variables"><code>STRATA_*</code> environment variables<a class="anchor" href="#strata_-environment-variables">#</a></h1> <p>Every <code>STRATA_*</code> knob, grouped by the layer that consumes it. CLI flags on <code>strata server</code> (<code>--listen</code>, <code>--vhost-pattern</code>, <code>--log-level</code>, <code>--workers=</code>) override the matching env var.</p>https://danchupin.github.io/strata/reference/admin-api/Mon, 01 Jan 0001 00:00:00 +0000https://danchupin.github.io/strata/reference/admin-api/<!-- Maintainer note: source of truth is the admin API OpenAPI contract. This page is a derived flat index — rebuild when paths are added/removed from the OpenAPI document. Audit-verb column mirrors the SetAuditOverride stamp in each handler. GET/HEAD/OPTIONS are skipped by the audit middleware regardless of any defensive stamp, so read-only rows show "—". --> <h1 id="admin-api-surface">Admin API surface<a class="anchor" href="#admin-api-surface">#</a></h1> <p>This is the operator index. Authoritative contract lives in the admin API OpenAPI document — rendered interactively at the <a href="https://danchupin.github.io/strata/reference/admin-api-viewer/">Admin API viewer</a>; raw bytes at <a href="https://danchupin.github.io/strata/openapi.yaml"><code>/openapi.yaml</code></a>.</p>https://danchupin.github.io/strata/reference/s3-api/Mon, 01 Jan 0001 00:00:00 +0000https://danchupin.github.io/strata/reference/s3-api/<!-- Maintainer note: this table is hand-maintained. When adding a new handler in internal/s3api/, append a row here in the same PR. A lint test (internal/s3api/docs_reference_test.go) AST-parses the dispatch functions ServeHTTP / handleBucket / handleObject / handleBucketInventory in internal/s3api/, collects every *Server method called directly from those bodies, and asserts each one either: 1. appears in this markdown — matched by backtick'd function name OR by a `Handler file:line` cell of the form `internal/s3api/<file>.go:<line>` that points at the func declaration, OR 2. carries a `// docs:skip` line comment immediately above the func declaration (tolerated as intentionally-internal — non-S3 helpers like auth gates, quota checks, website routing). The same test catches orphan rows: any `internal/s3api/<file>.go:<line>` cell that does NOT resolve to a *Server method body fails the build (handler renamed or removed without updating the row). Row sourcing: walk the dispatch arms in `internal/s3api/server.go` + `inventory.go`. Each route arm becomes one row. `Handler file:line` points at the route arm in `server.go` OR the leaf handler in `internal/s3api/<feature>.go`. --> <h1 id="s3-api-operations">S3 API operations<a class="anchor" href="#s3-api-operations">#</a></h1> <p>Operator + SDK-author index of every S3 operation Strata answers. The router dispatches <code>ServeHTTP</code> → <code>handleBucket</code> (bucket-scope) → <code>handleObject</code> (object-scope); leaf handlers live alongside each feature in the <code>s3api</code> package. The <code>Handler file:line</code> column is intentionally line-anchored — a lint test asserts every dispatched method shows up here (see the maintainer note above this section). AWS divergence column is empty when the operation is full-compat; one-liner otherwise.</p>https://danchupin.github.io/strata/reference/admin-api-viewer/Mon, 01 Jan 0001 00:00:00 +0000https://danchupin.github.io/strata/reference/admin-api-viewer/<h1 id="admin-api-viewer">Admin API viewer<a class="anchor" href="#admin-api-viewer">#</a></h1> <p>Interactive <a href="https://github.com/Redocly/redoc">Redoc</a> render of the canonical Admin-API OpenAPI contract. The YAML is copied into the Hugo static dir at build time by <code>make docs-openapi-copy</code> (a prerequisite of <code>make docs-build</code> / <code>make docs-serve</code>), so the viewer always reflects the contract at the same SHA as the rest of the docs site.</p> <p>For a flat index of every admin endpoint with method, path, audit verb, and a one-line summary, see <a href="https://danchupin.github.io/strata/reference/admin-api/">Admin API surface</a>. For the raw contract, fetch <a href="https://danchupin.github.io/strata/openapi.yaml">/openapi.yaml</a>.</p>