mirror of
https://github.com/hashicorp/vault-action.git
synced 2025-11-09 16:16:55 +00:00
doc: add custom version and engine name
This commit is contained in:
parent
fa325aa881
commit
a144d7cbe0
1 changed files with 27 additions and 2 deletions
29
README.md
29
README.md
|
|
@ -1,6 +1,6 @@
|
||||||
# vault-action
|
# vault-action
|
||||||
|
|
||||||
A helper action for easily pulling secrets from the default v2 K/V backend of vault.
|
A helper action for easily pulling secrets from a K/V backend of vault.
|
||||||
|
|
||||||
## Example Usage
|
## Example Usage
|
||||||
|
|
||||||
|
|
@ -93,9 +93,34 @@ with:
|
||||||
ci/aws secretKey | AWS_SECRET_ACCESS_KEY
|
ci/aws secretKey | AWS_SECRET_ACCESS_KEY
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Using K/V version 1
|
||||||
|
|
||||||
|
By default, `vault-action` expects a K/V engine using [version 2](https://www.vaultproject.io/docs/secrets/kv/kv-v2.html).
|
||||||
|
|
||||||
|
In order to work with a v1 engine, the `kv-version` parameter may be passed:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
with:
|
||||||
|
kv-version: 1
|
||||||
|
```
|
||||||
|
|
||||||
|
### Custom Engine Name
|
||||||
|
|
||||||
|
Vault comes with a default engine named `secret`, so a secret named `ci` will be
|
||||||
|
accessed from `secret/ci`. However, if you are using a custom named engine, you
|
||||||
|
can pass it as follows:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
with:
|
||||||
|
engine-name: my-secrets
|
||||||
|
secrets: ci npmToken
|
||||||
|
```
|
||||||
|
|
||||||
|
This way, the `ci` secret in the example above will be retrieved from `my-secrets/ci`.
|
||||||
|
|
||||||
### Namespace
|
### Namespace
|
||||||
|
|
||||||
This action could be use with namespace Vault Enterprise feature. You can specify namespace in request :
|
This action could be use with namespace Vault Enterprise feature. You can specify namespace in request :
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
steps:
|
steps:
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue