chore: 对齐 00-05 §2 的部署与验证脚本
- 新增 deploy-lab.sh（k3s/longhorn/nginx 铺栈）与 ssh/run-phase2-k3s-on-ylc61-as-jack.sh - verify.sh：flow/preflight、VERIFY_TEARDOWN 默认、注释与 §2 对应 - 更新 smoke-verify、README、.env.verify.example、根 README 与主要 playbook 头注释 - k3s-delete-lab-stacks 标明重度清场语义 Made-with: Cursor
This commit is contained in:
@@ -1,11 +1,19 @@
|
||||
#!/usr/bin/env bash
|
||||
# Ansible 验证入口：以 docs/00-02-验证矩阵.md 为执行清单，逐个 doc_id 执行 verify playbook（deploy→verify→teardown）。
|
||||
# 推荐在 ylc61（控制节点）仓库根执行。
|
||||
# 验证矩阵自动化入口（对应 docs/00-05 §2「自动化验证流程」步骤 4～6 的一键串联）：
|
||||
# 4 断言 — 各 verify/XX-YY.yml 内 kubectl / curl / helm 等
|
||||
# 5 收尾 — 默认 VERIFY_TEARDOWN=1 做本篇资源清理（非整集群卸载）
|
||||
# 6 串联 — run-all 按 docs/00-02-验证矩阵.md 顺序 fail-fast
|
||||
#
|
||||
# 步骤 1～3（接入、环境/轻量清理、部署）由操作者或 scripts/deploy-lab.sh 完成；本脚本不执行 k3s-uninstall。
|
||||
# 推荐在 Linux 工作机（如 ylc65）或控制节点仓库根执行。
|
||||
set -euo pipefail
|
||||
|
||||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
MATRIX_MD="${ROOT}/docs/00-02-验证矩阵.md"
|
||||
|
||||
# 默认与 §2 一致：验证后清理临时资源
|
||||
export VERIFY_TEARDOWN="${VERIFY_TEARDOWN:-1}"
|
||||
|
||||
load_env() {
|
||||
if [[ -f "${ROOT}/scripts/.env.verify" ]]; then
|
||||
set -a
|
||||
@@ -14,6 +22,7 @@ load_env() {
|
||||
set +a
|
||||
echo "[OK] 已加载 scripts/.env.verify"
|
||||
fi
|
||||
export VERIFY_TEARDOWN="${VERIFY_TEARDOWN:-1}"
|
||||
}
|
||||
|
||||
parse_doc_ids_from_matrix() {
|
||||
@@ -21,7 +30,6 @@ parse_doc_ids_from_matrix() {
|
||||
echo "[ERR] matrix 不存在：${MATRIX_MD}" >&2
|
||||
exit 1
|
||||
fi
|
||||
# 从矩阵中提取形如 `XX-YY-*.md` 的文件名，输出 XX-YY（按出现顺序）
|
||||
# shellcheck disable=SC2016
|
||||
awk '
|
||||
match($0, /`[0-9][0-9]-[0-9][0-9]-[^`]+\.md`/) {
|
||||
@@ -32,23 +40,72 @@ parse_doc_ids_from_matrix() {
|
||||
' "${MATRIX_MD}"
|
||||
}
|
||||
|
||||
print_flow() {
|
||||
cat <<EOF
|
||||
与 docs/00-05-测试与验证框架.md §2「自动化验证流程（一般步骤）」对应：
|
||||
|
||||
1 接入目标环境 inventory + 仓库同步；可选 source scripts/.env.verify（本脚本 run/run-all 会自动加载）
|
||||
2 环境与前置清理 轻量：各 verify playbook 的 teardown；重度 k3s 重装勿混进 run-all
|
||||
3 部署 ./scripts/deploy-lab.sh k3s | longhorn | nginx-matrix* 或手工 ansible-playbook
|
||||
4 断言 本脚本 run <XX-YY> / run-all → ansible/playbooks/verify/<XX-YY>.yml
|
||||
5 收尾与记录 VERIFY_TEARDOWN；矩阵状态见 docs/00-02-验证矩阵.md（建议手工写回）
|
||||
6 一键串联 $0 run-all
|
||||
|
||||
相关脚本：deploy-lab.sh（安装/铺栈）、ssh/run-phase2-k3s-on-ylc61-as-jack.sh（办公机触发远端 deploy k3s）
|
||||
EOF
|
||||
}
|
||||
|
||||
preflight() {
|
||||
local inv="${ANSIBLE_INVENTORY:-${ROOT}/ansible/inventory.ini}"
|
||||
if ! command -v ansible-playbook >/dev/null 2>&1; then
|
||||
echo "[ERR] 未找到 ansible-playbook" >&2
|
||||
exit 1
|
||||
fi
|
||||
[[ -f "${MATRIX_MD}" ]] || { echo "[ERR] 缺少验证矩阵：${MATRIX_MD}" >&2; exit 1; }
|
||||
[[ -f "$inv" ]] || { echo "[ERR] inventory 不存在：$inv" >&2; exit 1; }
|
||||
|
||||
echo "[RUN] ansible k3s_server -m ping"
|
||||
ansible k3s_server -i "$inv" -m ping
|
||||
|
||||
if [[ "${VERIFY_PREFLIGHT_CLUSTER:-0}" == "1" ]]; then
|
||||
echo "[RUN] kubectl get nodes（控制节点，需已安装 K3s）"
|
||||
ansible k3s_server -i "$inv" -b -m ansible.builtin.shell -a \
|
||||
'KUBECONFIG=/etc/rancher/k3s/k3s.yaml kubectl get nodes' \
|
||||
|| {
|
||||
echo "[WARN] 集群侧检查失败：若尚未 deploy k3s，可忽略；装好后设 VERIFY_PREFLIGHT_CLUSTER=1 再测" >&2
|
||||
exit 1
|
||||
}
|
||||
else
|
||||
echo "[TIP] 跳过 kubectl 检查。已装 K3s 时可执行：VERIFY_PREFLIGHT_CLUSTER=1 $0 preflight"
|
||||
fi
|
||||
echo "[OK] preflight 通过"
|
||||
}
|
||||
|
||||
usage() {
|
||||
cat <<'EOF'
|
||||
用法：scripts/verify.sh <命令> [...]
|
||||
|
||||
命令：
|
||||
list 从验证矩阵列出 doc_id
|
||||
run <XX-YY> 运行指定 doc_id（执行 ansible/playbooks/verify/<XX-YY>.yml）
|
||||
flow 打印与 docs/00-05 §2 对齐的「验证流程」说明（不接 Ansible）
|
||||
preflight 检查 ansible-playbook、矩阵与 inventory；对 k3s_server 做 ping
|
||||
若 VERIFY_PREFLIGHT_CLUSTER=1，额外 kubectl get nodes（未装集群会失败）
|
||||
list 从验证矩阵列出 doc_id（顺序同 run-all）
|
||||
run <XX-YY> 运行指定 doc_id（ansible/playbooks/verify/<XX-YY>.yml）
|
||||
run-all 按验证矩阵顺序运行全部 doc_id（fail-fast）
|
||||
|
||||
环境变量：
|
||||
VERIFY_TEARDOWN=1 验证后清理（默认 1）
|
||||
nginx_entry_base 例如 http://192.168.2.61（用于 02-05）
|
||||
nodejs_entry_base 例如 http://192.168.2.61（用于 04-01）
|
||||
VERIFY_TEARDOWN=1 验证后清理本篇资源（默认 1，对应 §2 轻量 teardown）
|
||||
VERIFY_PREFLIGHT_CLUSTER 为 1 时 preflight 额外执行 kubectl get nodes
|
||||
ANSIBLE_INVENTORY 默认 <仓库>/ansible/inventory.ini
|
||||
nginx_entry_base 例如 http://192.168.2.61（02-xx / 03-02 等 HTTP 校验）
|
||||
nodejs_entry_base 例如 http://192.168.2.61（04-01）
|
||||
|
||||
与「部署」分工：安装 K3s / Longhorn / nginx 铺栈请用 ./scripts/deploy-lab.sh；矩阵验收请用本脚本。
|
||||
|
||||
示例：
|
||||
./scripts/verify.sh flow
|
||||
./scripts/verify.sh preflight
|
||||
export nginx_entry_base=http://192.168.2.61
|
||||
export VERIFY_TEARDOWN=1
|
||||
./scripts/verify.sh run 02-05
|
||||
EOF
|
||||
}
|
||||
@@ -74,6 +131,8 @@ main() {
|
||||
local cmd="${1:-}"
|
||||
case "$cmd" in
|
||||
""|-h|--help) usage ;;
|
||||
flow) print_flow ;;
|
||||
preflight) preflight ;;
|
||||
list)
|
||||
parse_doc_ids_from_matrix
|
||||
;;
|
||||
@@ -98,4 +157,3 @@ main() {
|
||||
}
|
||||
|
||||
main "$@"
|
||||
|
||||
|
||||
Reference in New Issue
Block a user