mirror of
https://github.com/hashicorp/vault.git
synced 2025-08-22 15:11:07 +02:00
0660ea6fac
* Update README Let contributors know that docs will now be located in UDR * Add comments to each mdx doc Comment has been added to all mdx docs that are not partials * chore: added changelog changelog check failure * wip: removed changelog * Fix content errors * Doc spacing * Update website/content/docs/deploy/kubernetes/vso/helm.mdx Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> --------- Co-authored-by: jonathanfrappier <92055993+jonathanfrappier@users.noreply.github.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com>
53 lines
1.8 KiB
Plaintext
53 lines
1.8 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: Rollback plugins
|
|
description: >-
|
|
Rollback or downgrade Vault plugins.
|
|
---
|
|
|
|
> [!IMPORTANT]
|
|
> **Documentation Update:** Product documentation, which were located in this repository under `/website`, are now located in [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs), colocated with all other product documentation. Contributions to this content should be done in the `web-unified-docs` repo, and not this one. Changes made to `/website` content in this repo will not be reflected on the developer.hashicorp.com website.
|
|
|
|
# Rollback or downgrade Vault plugins
|
|
|
|
Downgrading a plugin in the catalog affects all uses of that plugin version.
|
|
Always check the plugin release notes for unsupported transitions before
|
|
starting your rollback or downgrade.
|
|
|
|
|
|
## Before you start
|
|
|
|
- **To register and downgrade official enterprise plugins, you must have Vault v1.16.21+,
|
|
1.17.17+, 1.18.10+, 1.19.4+, or 1.20.x+**.
|
|
- **To register and downgrade official community plugins with an extracted `.zip` file, you must have
|
|
Vault v1.16.21+, 1.17.17+, 1.18.10+, 1.19.5+, or 1.20.x+**.
|
|
|
|
@include 'plugins/common-requirements.mdx'
|
|
|
|
|
|
## Step 1: Prepare the plugin
|
|
|
|
@include 'plugins/prepare-plugin.mdx'
|
|
|
|
|
|
## Step 2: Update the plugin catalog
|
|
|
|
Register the replacement plugin binary or zip file with the old version number
|
|
under the same plugin type and name as the existing plugin version.
|
|
|
|
@include 'plugins/register.mdx'
|
|
|
|
|
|
## Step 3: Pin and reload the plugin
|
|
|
|
Until you reload the plugin, Vault continues running the current plugin version
|
|
on the mount path. When you trigger a reload, Vault kills the active plugin
|
|
process and start a new plugin process with the pinned version of that plugin.
|
|
|
|
@include 'plugins/pin-and-reload.mdx'
|
|
|
|
|
|
## Step 4: Verify the plugin status
|
|
|
|
@include 'plugins/verify-status.mdx'
|