Skip to content

Remove eight deprecated no-op CLI flags - #7790

Open
CharlieTLe wants to merge 1 commit into
cortexproject:masterfrom
CharlieTLe:release-1.22-pr-d1-remove-noop-flags
Open

Remove eight deprecated no-op CLI flags#7790
CharlieTLe wants to merge 1 commit into
cortexproject:masterfrom
CharlieTLe:release-1.22-pr-d1-remove-noop-flags

Conversation

@CharlieTLe

Copy link
Copy Markdown
Member

Groundwork for v1.22.0. Refs #5922. First of three deprecation-removal PRs, split so that
an objection to the riskier ones does not hold up eight trivially-correct deletions.

Every flag here is flag-only (no YAML config option) and already a no-op, so
removing it cannot change how a running cluster behaves. The only impact is that a command
line still passing one now fails at startup.

Flag Deprecated in Minors overdue
-querier.ingester-streaming 1.17.0 5
-querier.iterators 1.17.0 5
-querier.batch-iterators 1.17.0 5
-querier.query-store-for-labels-enabled 1.18.0 4
-querier.max-outstanding-requests-per-tenant 1.18.0 4
-query-scheduler.max-outstanding-requests-per-tenant 1.18.0 4
-blocks-storage.tsdb.wal-compression-enabled 1.19.0 3
-ingester.max-series-per-query never announced chunks-era, ignored under blocks storage

v1-guarantees.md promises deprecated flags stay for two minor releases; all of these are
at least three past that.

No generated-doc churn

flagext.DeprecatedFlag registers a CLI flag with no backing struct field, so none of these
appear in docs/configuration/config-file-reference.md or the JSON schema. Confirmed: make doc produces an empty diff on this branch.

Docs

docs/blocks-storage/migrate-from-chunks-to-blocks.md was the only doc telling readers to
set -querier.ingester-streaming, so those mentions are gone.

Worth noting separately: that guide is already broadly stale — it still documents
-querier.second-store-engine, -querier.use-second-store-before-time and
-querier.query-store-after, all of which were removed some time ago. I only touched the
one flag this PR removes; whether the guide should still exist is a separate call.

Verification

go build ./..., go vet, make doc (no diff), and the tests for every touched package.

@dosubot dosubot Bot added go Pull requests that update Go code type/chore Something that needs to be done; not a bug or a feature labels Aug 20, 2026
All eight have been past the two-minor deprecation window in v1-guarantees.md for at
least three minors, and every one is flag-only with no YAML config option and no effect
on behaviour, so removing them cannot change how a running cluster behaves. The only
impact is that a command line still passing one now fails at startup.

Split out from the deprecation removals that do touch YAML config or behaviour, so an
objection to those does not hold these up.

docs/blocks-storage/migrate-from-chunks-to-blocks.md stops telling readers to set
-querier.ingester-streaming. That guide still references other flags removed years ago
(-querier.second-store-engine, -querier.use-second-store-before-time); worth a separate
look at whether it should stay at all.

Signed-off-by: Charlie Le <charlie_le@apple.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

go Pull requests that update Go code size/M type/chore Something that needs to be done; not a bug or a feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant