Skip to content

Commit 4be5f7d

Browse files
author
Ubuntu
committed
docs(ch3-step1): clarify Type vs Plugin column in vault secrets list
Vault 1.19's 'vault secrets list -detailed' replaces the Type column with Plugin. Split the original single command into two: - 'vault secrets list' (without -detailed) for Type/Accessor/Description - 'vault secrets list -detailed' for Plugin/UUID and other fields This avoids confusion when the learner can't find the Type column.
1 parent 9ab44e5 commit 4be5f7d

1 file changed

Lines changed: 37 additions & 3 deletions

File tree

  • vault-tutorial/ch3-secrets-engines/step1

vault-tutorial/ch3-secrets-engines/step1/text.md

Lines changed: 37 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,52 @@
44

55
## 1.1 查看 Vault 启动时的内置挂载点
66

7+
先用 **不带 `-detailed`** 的形式看一眼最常用的 4 列(Path / Type /
8+
Accessor / Description):
9+
710
```bash
8-
vault secrets list -detailed
11+
vault secrets list
12+
```
13+
14+
输出大约是这样:
15+
16+
```
17+
Path Type Accessor Description
18+
---- ---- -------- -----------
19+
cubbyhole/ cubbyhole cubbyhole_xxxxxxxx per-token private secret storage
20+
identity/ identity identity_xxxxxxxx identity store
21+
secret/ kv kv_xxxxxxxx key/value secret storage
22+
sys/ system system_xxxxxxxx system endpoints used for ...
923
```
1024

1125
注意几列:
1226

1327
- `Path`:API 路径前缀
1428
- `Type`:引擎类型(kv、cubbyhole、system、identity 等)
15-
- `Accessor`:挂载实例的不可变唯一标识
29+
- `Accessor`:挂载实例的不可变唯一标识,前缀就是引擎类型(`kv_`
30+
`cubbyhole_` 等)
31+
32+
`secret/` 是 Dev 模式默认挂载的 KV v2,`cubbyhole/``sys/`
33+
`identity/` 是内置引擎(**不能 disable**)。
34+
35+
接下来切到 `-detailed` 形式——它把 `Type` 这一列换成了更精确的
36+
`Plugin`(因为同一类型可以被不同 plugin 实现),并额外暴露 **`UUID`**
37+
这一关键字段:
38+
39+
```bash
40+
vault secrets list -detailed
41+
```
42+
43+
挑出我们关心的几列(其余字段后续小节会用到):
44+
45+
- `Path`:与上面一致
46+
- `Plugin`:实际承载该挂载的插件名(对内置引擎来说与 `Type` 同名,
47+
例如 `kv` / `cubbyhole`
48+
- `Accessor`:与上面一致
1649
- `UUID`:底层存储的根目录 UUID(每个 Accessor 有自己独立的子树)
1750

18-
`secret/` 是 Dev 模式默认挂载的 KV v2,`cubbyhole/``sys/``identity/` 是内置引擎(**不能 disable**)。
51+
> **提示**`-detailed` 一次性输出 14 列,在窄终端里很容易换行错乱。
52+
> 后续步骤用 `jq` 直接从 `-format=json` 里挑字段更可靠。
1953
2054
## 1.2 自定义路径挂载第一个 KV 实例:team-dev-kv/
2155

0 commit comments

Comments
 (0)