Skip to content

Commit

Permalink
docs(README): update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Tom Morelly committed Oct 26, 2023
1 parent 7df6740 commit 619dd14
Show file tree
Hide file tree
Showing 6 changed files with 17 additions and 5 deletions.
6 changes: 4 additions & 2 deletions docs/05_export/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
## vkv export

recursively list secrets from Vaults KV2 engine in various formats

```
Expand All @@ -8,8 +10,8 @@ vkv export [flags]

```
-p, --path string KVv2 Engine path (env: VKV_EXPORT_PATH)
-e, --engine-path string Specify the engine path using this flag in case your kv-engine contains special characters such as "/".
vkv will then append the values of the path-flag to the engine path, if specified (<engine-path>/<path>)(env: VKV_EXPORT_ENGINE_PATH)
-e, --engine-path string engine path in case your KV-engine contains special characters such as "/", the path value will then be appended if specified ("<engine-path>/<path>") (env: VKV_EXPORT_ENGINE_PATH)
--skip-errors dont exit on errors (permission denied, deleted secrets)
--only-keys show only keys (env: VKV_EXPORT_ONLY_KEYS)
--only-paths show only paths (env: VKV_EXPORT_ONLY_PATHS)
--show-version show the secret version (env: VKV_EXPORT_VERSION) (default true)
Expand Down
4 changes: 3 additions & 1 deletion docs/06_import/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
# Import

## vkv import

import secrets from vkv's json or yaml output

Expand All @@ -18,7 +21,6 @@ vkv import [flags]
-s, --silent do not output secrets (env: VKV_IMPORT_SILENT)
```


# read secrets from STDIN

The `-` in `vkv import -`, tells `vkv` do read data via STDIN. The idea of `vkv import -` is, in order to copy/mirror KV-v2 secrets or complete engines across diferrent Vault Servers or Namespaces, you can simply pipe
Expand Down
2 changes: 2 additions & 0 deletions docs/07_snapshot/restore.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
## vkv snapshot restore

restore the KV engines defined in the specified snapshot

```
Expand Down
4 changes: 3 additions & 1 deletion docs/07_snapshot/save.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
## vkv snapshot save

create a snapshot of all visible KV engines recursively for all namespaces

```
Expand All @@ -9,5 +11,5 @@ vkv snapshot save [flags]
```
-d, --destination string vkv snapshot destination path (env: VKV_SNAPSHOT_SAVE_DESTINATION) (default "./vkv-snapshot-export")
-h, --help help for save
-n, --namespace string namespaces from which to save recursively all visible KV engines (env: VKV_SNAPSHOT_SAVE_NS
-n, --namespace string namespaces from which to save recursively all visible KV engines (env: VKV_SNAPSHOT_SAVE_NS)
```
2 changes: 2 additions & 0 deletions docs/08_namespaces/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
## vkv list namespaces

list all namespaces

```
Expand Down
4 changes: 3 additions & 1 deletion docs/09_engines/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
## vkv list engines

list all KVv2 engines

```
Expand All @@ -13,4 +15,4 @@ vkv list engines [flags]
-a, --all list all KV engines recursively from the specified namespaces (env: VKV_LIST_ENGINES_ALL)
-f, --format string available output formats: "base", "json", "yaml" (env: VKV_LIST_ENGINES_FORMAT) (default "base")
-h, --help help for engines
```
```

0 comments on commit 619dd14

Please sign in to comment.