对齐文件规范

docs/03-06-k3s-使用nfs存储.md

@@ -2,6 +2,14 @@
 
 > 本文只讲 K3s 集群侧如何使用已安装好的 NFS。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 03-06`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
 - 已完成 `01-05-armv7-nfs服务安装.md`
@@ -66,9 +74,11 @@ spec: # Deployment 规格
             path: <NFS_EXPORT_PATH_OR_SUBDIR> # NFS 导出目录或子目录（应用前替换）
 ```
 
+可执行真源：[`ansible/files/03-06/nfs-direct-demo.yaml`](../ansible/files/03-06/nfs-direct-demo.yaml)。
+
 ### 方式 2：静态 NFS（PV + PVC，推荐）
 
-**唯一真源**：[`ansible/files/03-06-nfs-demo/nfs-pv-pvc-demo.yaml`](../ansible/files/03-06-nfs-demo/nfs-pv-pvc-demo.yaml)。
+**唯一真源**：[`ansible/files/03-06/nfs-pv-pvc-demo.yaml`](../ansible/files/03-06/nfs-pv-pvc-demo.yaml)。
 
 > 为减少硬编码，示例清单已改为占位符：`<NFS_SERVER_IP>`、`<NFS_EXPORT_PATH>`。  
 > 应用前必须先替换（例如 `192.168.2.22`、`/sdcard`）。
@@ -133,10 +143,12 @@ spec:
       storage: 5Gi
 ```
 
+可执行真源：[`ansible/files/03-06/nfs-dynamic-pvc-demo.yaml`](../ansible/files/03-06/nfs-dynamic-pvc-demo.yaml)。
+
 应用并验证：
 
 ```bash
-kubectl apply -f /tmp/nfs-dynamic-pvc-demo.yaml
+kubectl apply -f ansible/files/03-06/nfs-dynamic-pvc-demo.yaml
 kubectl get pvc nfs-dynamic-pvc-demo -n default
 kubectl get pv | grep nfs-dynamic-pvc-demo
 ```
@@ -164,10 +176,10 @@ kubectl get pv | grep nfs-dynamic-pvc-demo
 
 ```bash
 # 仓库根直接应用
-# 先替换 ansible/files/03-06-nfs-demo/nfs-pv-pvc-demo.yaml 里的占位符
+# 先替换 ansible/files/03-06/nfs-pv-pvc-demo.yaml 里的占位符
 # <NFS_SERVER_IP> -> 例如 192.168.2.22
 # <NFS_EXPORT_PATH> -> 例如 /sdcard
-kubectl apply -f ansible/files/03-06-nfs-demo/nfs-pv-pvc-demo.yaml
+kubectl apply -f ansible/files/03-06/nfs-pv-pvc-demo.yaml
 ```
 
 ```bash
@@ -186,7 +198,7 @@ kubectl describe pv nfs-pv-demo
 
 ```bash
 # 对方式 1（Pod 直挂）可这样验证
-kubectl apply -f /tmp/nfs-direct-demo.yaml
+kubectl apply -f ansible/files/03-06/nfs-direct-demo.yaml
 kubectl rollout status deploy/nfs-direct-demo --timeout=180s
 kubectl exec deploy/nfs-direct-demo -- sh -c 'echo nfs-direct-ok > /usr/share/nginx/html/nfs.txt && cat /usr/share/nginx/html/nfs.txt'
 ```
@@ -208,3 +220,8 @@ kubectl exec deploy/nfs-direct-demo -- sh -c 'echo nfs-direct-ok > /usr/share/ng
 - `03-05-k3s-local-path-pvc.md`：单副本应用用 K3s 自带 local-path 即可，无需 NFS
 - `05-06-openlist挂载网盘与自动备份.md`
 
+## 排障
+
+- **先看 playbook 输出**：失败时先定位是 deploy/wait/http_check 哪一步。
+- **集群侧总览**：`kubectl get nodes -o wide`、`kubectl -n kube-system get pods -o wide`。
+- **事件与日志**：`kubectl -n <ns> describe ...`、`kubectl -n <ns> logs ... --tail=200`。