Skip to content

Conversation

@bosouza
Copy link
Contributor

@bosouza bosouza commented Oct 30, 2025

This PR updates the docs added in #1191 in order to reference a new environment variable VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST that will allow customers on the old (still-supported and ent-only) versions 1.20.6, 1.19.12 and 1.16.28 to have access to the new evaluation behavior.

I made different recommendations on the upgrade tip for each of the versions:

  • 1.16: upgrade to 1.21 or upgrade to 1.16.28 and set the env var
  • 1.17: ... or upgrade to 1.19.12 and ...
  • 1.18: ... or upgrade to 1.19.12 and ...
  • 1.19: ... or upgrade to 1.19.12 and ...
  • 1.20: ... or upgrade to 1.20.6 and ...

Jira: VAULT-40584

@bosouza bosouza requested a review from schavis October 30, 2025 21:47
@bosouza bosouza requested a review from a team as a code owner October 30, 2025 21:47
@github-actions github-actions bot added the Vault Content update for Vault product docs label Oct 30, 2025
@bosouza
Copy link
Contributor Author

bosouza commented Oct 30, 2025

@schavis assuming stuff looks good this should only be merged when the next minor version goes out right (tentative date Nov 19), as it'll update the live docs correct?

@github-actions
Copy link
Contributor

github-actions bot commented Oct 30, 2025

Vercel Previews Deployed

Name Status Preview Updated (UTC)
Dev Portal ✅ Ready (Inspect) Visit Preview Mon Nov 3 15:59:58 UTC 2025
Unified Docs API ✅ Ready (Inspect) Visit Preview Mon Nov 3 15:53:22 UTC 2025

@github-actions
Copy link
Contributor

github-actions bot commented Nov 3, 2025

Broken Link Checker

No broken links found! 🎉

@schavis
Copy link
Contributor

schavis commented Nov 5, 2025

@schavis assuming stuff looks good this should only be merged when the next minor version goes out right (tentative date Nov 19), as it'll update the live docs correct?

Yes, merging to main will publish immediately. I suggest changing the merge target to the monthly release branch (vault/202511) so you can merge as soon as the PR is approved. It'll publish on the 19th when I merge the release branch

Comment on lines +580 to +583
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.16, this new behavior can
be enabled starting on 1.16.28 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.16, this new behavior can
be enabled starting on 1.16.28 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Vault 1.21.x introduced a more intuitive list processing for `allowed_parameters`
and `denied_parameters`. You can enable the intuitive list processing behavior
for Vault 1.16.x by upgrading to 1.16.28 or later and setting the
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST` environment variable.

Style correction: avoid "this" as a pronoun

Comment on lines +587 to +590
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.19, this new behavior can
be enabled starting on 1.19.12 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.19, this new behavior can
be enabled starting on 1.19.12 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Vault 1.21.x introduced a more intuitive list processing for `allowed_parameters`
and `denied_parameters`. You can enable the intuitive list processing behavior
for Vault by upgrading to Vault 1.19.12 or later and setting the
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST` environment variable.

Edited to use language similar to 1.16

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there a reason we recommend moving to 1.19 instead of upgrading to 1.21? I'm assuming it's because 1.18 to 1.19 is a simpler upgrade path, but wanted to confirm.

Comment on lines +587 to +590
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.19, this new behavior can
be enabled starting on 1.19.12 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.19, this new behavior can
be enabled starting on 1.19.12 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Vault 1.21.x introduced a more intuitive list processing for `allowed_parameters`
and `denied_parameters`. You can enable the intuitive list processing behavior
for Vault by upgrading to Vault 1.19.12 or later and setting the
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST` environment variable.

Edited to use language similar to 1.16

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment re: upgrade path here

Comment on lines +587 to +590
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.19, this new behavior can
be enabled starting on 1.19.12 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.19, this new behavior can
be enabled starting on 1.19.12 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Vault 1.21.x introduced a more intuitive list processing for `allowed_parameters`
and `denied_parameters`. You can enable the intuitive list processing behavior
for Vault 1.19.x by upgrading to 1.19.12 or later and setting the
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST` environment variable.

Edited to use language similar to 1.16

Comment on lines +589 to +592
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.20, this new behavior can
be enabled starting on 1.20.6 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Vault 1.21.x or later defaults to a more intuitive list processing for
`allowed_parameters` and `denied_parameters`. In Vault 1.20, this new behavior can
be enabled starting on 1.20.6 by setting the environment variable
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST`.
Vault 1.21.x introduced a more intuitive list processing for `allowed_parameters`
and `denied_parameters`. You can enable the intuitive list processing behavior
for Vault 1.20.x by upgrading to 1.20.6 or later and setting the
`VAULT_NEW_PER_ELEMENT_MATCHING_ON_LIST` environment variable.

Edited to use language similar to 1.16

Copy link
Contributor

@schavis schavis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Vault Content update for Vault product docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants