diff --git a/website/content/docs/commands/plugin/index.mdx b/website/content/docs/commands/plugin/index.mdx index bdd5876df7..3fb06d4bf6 100644 --- a/website/content/docs/commands/plugin/index.mdx +++ b/website/content/docs/commands/plugin/index.mdx @@ -34,6 +34,16 @@ $ vault plugin register \ Success! Registered plugin: my-custom-plugin ``` +Register a plugin with `-download` : + +```shell-session +$ vault plugin register + -download \ + -version=0.16.0+ent \ + secret \ + vault-plugin-secrets-keymgmt +``` + Get information about a plugin in the catalog: ```shell-session diff --git a/website/content/docs/commands/plugin/register.mdx b/website/content/docs/commands/plugin/register.mdx index 2db34ab98e..8db2617548 100644 --- a/website/content/docs/commands/plugin/register.mdx +++ b/website/content/docs/commands/plugin/register.mdx @@ -64,6 +64,18 @@ $ vault plugin register vault-plugin-secrets-keymgmt # name must match the plugin name on the releases page ``` +Use the `-download` flag with the full version and plugin +name to download and register an official plugin from +[HashiCorp releases page](https://releases.hashicorp.com/): + +```shell-session +$ vault plugin register + -download \ + -version=0.16.0+ent \ + secret \ + vault-plugin-secrets-keymgmt +``` + ## Usage The following flags are available in addition to the [standard set of @@ -105,3 +117,10 @@ flags](/vault/docs/commands) included on all commands. You can omit version to register a plugin binary, but you must provide an explicit version to register a plugin artifact. +- `-download` `(bool: false)` - **( BETA )** + Tells Vault to download the specified plugin from the + [HashiCorp releases page](https://releases.hashicorp.com/). Automatic + downloads only support secret and auth plugins with artifacts containing + `metadata.json` and `metadata.json.sig`. To use automatic downloads, your + network must permit HTTPS and TCP port 443 between all + Vault cluster nodes and `releases.hashicorp.com`.