helmfile/docs
Dominik Schmidt ad45f0a1b9 feat: add dir= selector for path-based release filtering and traversal skip
Introduce a new selector key `dir=<path>` to the -l/--selector flag with two
effects: it filters releases by the directory of their defining helmfile
relative to the root helmfile (using directory-prefix matching, so
dir=apps/foo matches both apps/foo and apps/foo/sub), and it short-circuits
sub-helmfile traversal when paired with positive dir= constraints, so
non-matching branches in the helmfiles: tree are not parsed, templated, or
fetched.

The motivation is consuming aggregator-style upstreams that the operator
does not control (opendesk being the immediate example), where the user
cannot restructure the helmfile layout but still wants to act on a subset.

The dir label is auto-populated at filter time only; user-facing label
output is unchanged. The label key "dir" is reserved at state load.
Selectors that escape the root via .. or absolute paths, and the bare ".",
are rejected at parse time.

Signed-off-by: Dominik Schmidt <dev@dominik-schmidt.de>
2026-05-22 17:20:52 +02:00
..
proposals feat(docs): add proposal to remove charts and delete subcommands (#1936) 2025-02-24 08:11:15 -05:00
advanced-features.md docs: restructure documentation and improve newcomer experience (#2573) 2026-05-03 19:33:33 +08:00
builtin-objects.md docs: restructure documentation and improve newcomer experience (#2573) 2026-05-03 19:33:33 +08:00
cli.md feat: add dir= selector for path-based release filtering and traversal skip 2026-05-22 17:20:52 +02:00
configuration.md feat: add defaultInherit for automatic release template inheritance (#2600) 2026-05-20 18:21:03 +08:00
contributing.md Documentation site based on mkdocs and Read the Docs 2022-04-03 05:04:54 +00:00
environments.md feat(state): add mergeStrategy: fallback for first-file-wins env values (#2578) 2026-05-07 21:50:05 +08:00
experimental-features.md docs: restructure documentation and improve newcomer experience (#2573) 2026-05-03 19:33:33 +08:00
hcl_funcs.md feat: Add IP Network to supported HCL Functions (#2426) 2026-02-26 17:20:48 +08:00
hooks.md docs: restructure documentation and improve newcomer experience (#2573) 2026-05-03 19:33:33 +08:00
index.md feat: add dir= selector for path-based release filtering and traversal skip 2026-05-22 17:20:52 +02:00
integrations.md docs: restructure documentation and improve newcomer experience (#2573) 2026-05-03 19:33:33 +08:00
license.md Documentation site based on mkdocs and Read the Docs 2022-04-03 05:04:54 +00:00
paths.md update examples info (#658) 2023-01-26 07:34:43 +09:00
releases.md docs: restructure documentation and improve newcomer experience (#2573) 2026-05-03 19:33:33 +08:00
remote-secrets.md update example chart URL in remote-secrets doc (#1809) 2024-11-28 13:19:08 +08:00
requirements.txt build(deps): bump gitpython from 3.1.49 to 3.1.50 in /docs (#2585) 2026-05-09 20:46:32 +08:00
shared-configuration-across-teams.md chore: documentation updates: grammar & rm whitespace (#1639) 2024-07-21 13:31:41 +08:00
templating.md feat: support HELMFILE_NAMESPACE env var for default namespace (#2592) 2026-05-19 21:43:11 +08:00
templating_funcs.md feat: add isDir template function (#1657) 2024-08-06 21:39:00 +08:00
users.md Documentation site based on mkdocs and Read the Docs 2022-04-03 05:04:54 +00:00
values-and-merging.md feat(state): add mergeStrategy: fallback for first-file-wins env values (#2578) 2026-05-07 21:50:05 +08:00
writing-helmfile.md feat: add defaultInherit for automatic release template inheritance (#2600) 2026-05-20 18:21:03 +08:00