From 209ad5ba22341a4e032920e8cc2eaa80d69dd1f2 Mon Sep 17 00:00:00 2001 From: panxiao81 Date: Sun, 27 Sep 2026 03:20:33 +0000 Subject: [PATCH] =?UTF-8?q?=E5=B0=86=20laptop=20ZFS=20ARC=20=E9=A2=84?= =?UTF-8?q?=E7=AE=97=E9=99=90=E5=88=B6=E4=B8=BA=204=20GiB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- infrastructure/host-memory/README.md | 29 +++++++++++++++ infrastructure/host-memory/laptop-arc.yml | 43 +++++++++++++++++++++++ 2 files changed, 72 insertions(+) create mode 100644 infrastructure/host-memory/README.md create mode 100644 infrastructure/host-memory/laptop-arc.yml diff --git a/infrastructure/host-memory/README.md b/infrastructure/host-memory/README.md new file mode 100644 index 0000000..270c809 --- /dev/null +++ b/infrastructure/host-memory/README.md @@ -0,0 +1,29 @@ +# laptop 内存预算 + +laptop 同时承载 Kubernetes、数据库和 libvirt VM。ARC 使用明确的 **4 GiB** 上限， +为服务留下突发余量；不修改自动 ARC 下限、swap、业务内存或 VM I/O 策略。 + +在 laptop 上执行： + +```bash +ansible-playbook -i localhost, infrastructure/host-memory/laptop-arc.yml --check +ansible-playbook -i localhost, infrastructure/host-memory/laptop-arc.yml +``` + +play 在线写入 `/sys/module/zfs/parameters/zfs_arc_max`，并持久化到 +`/etc/modprobe.d/homelab-zfs-arc.conf`。配置变化时以低 CPU/I/O 优先级更新所有已安装 +内核的 initramfs。不重启、不卸载 ZFS。ARC 当前使用量不保证立即降到上限以下； +`zfs_arc_max` 也不是 ZFS 全部内存的硬上限。 + +验证 `/proc/spl/kstat/zfs/arcstats` 的 `c_max=4294967296`，并在 Grafana 比较 +`node_zfs_arc_size`、`node_zfs_arc_c_max`、内存/I/O PSI、换页及数据库请求延迟。 +命中率下降或磁盘读压力上升时按实际负载重新评估预算，不通过重启或清缓存进行验收。 + +回滚时先从运行中的 `arcstats` 核实原自动上限，再在线写回该非零值。 +删除本 play 的 modprobe 文件并更新 initramfs，可恢复以后启动时的自动策略。 +不要依赖运行时写入 `0` 恢复自动计算；该行为受 OpenZFS 参数实现限制。 + +2026-09-26 故障关联：winadmin 自动更新期间虚拟磁盘写入与 ARC 增长、内存回收和 +Gitea 超时重合；限制 ARC 是内存预算措施，不代表已证明或解决全部存储延迟原因。 +排查证据与后续验收见 +[宿主机 ARC 预算](https://git.ddupan.top/panxiao81/homelab-wiki/src/branch/main/guides/laptop-arc-budget.md)。 diff --git a/infrastructure/host-memory/laptop-arc.yml b/infrastructure/host-memory/laptop-arc.yml new file mode 100644 index 0000000..29dbf9b --- /dev/null +++ b/infrastructure/host-memory/laptop-arc.yml @@ -0,0 +1,43 @@ +--- +- name: 为 laptop 的 VM 和服务预留内存 + hosts: localhost + connection: local + become: true + gather_facts: true + vars: + laptop_zfs_arc_max_bytes: 4294967296 + tasks: + - name: 确认目标和 ARC 预算 + ansible.builtin.assert: + that: + - ansible_facts.hostname == 'laptop' + - laptop_zfs_arc_max_bytes | int == 4294967296 + fail_msg: 此 play 仅用于 laptop 的 4 GiB ARC 预算。 + + - name: 读取运行中的 ARC 上限参数 + ansible.builtin.command: cat /sys/module/zfs/parameters/zfs_arc_max + register: arc_max_before + changed_when: false + check_mode: false + + - name: 持久化 ARC 上限 + ansible.builtin.copy: + dest: /etc/modprobe.d/homelab-zfs-arc.conf + owner: root + group: root + mode: '0644' + content: | + # Ansible managed: infrastructure/host-memory/laptop-arc.yml + # 4 GiB ARC budget for laptop; retain the automatic minimum. + options zfs zfs_arc_max={{ laptop_zfs_arc_max_bytes }} + notify: 更新已安装内核的 initramfs + + - name: 在线应用 ARC 上限 + ansible.builtin.shell: "printf '%s\\n' {{ laptop_zfs_arc_max_bytes | string | quote }} > /sys/module/zfs/parameters/zfs_arc_max" + when: arc_max_before.stdout | int != laptop_zfs_arc_max_bytes | int + changed_when: true + + handlers: + - name: 更新已安装内核的 initramfs + ansible.builtin.command: nice -n 10 ionice -c 3 update-initramfs -u -k all + changed_when: true -- 2.54.0