Ansible批量部署Node Exporter实战

脚本专家

主机数量少时，逐台登录安装 Node Exporter 还能接受；主机扩展到几十台后，手动下载、创建用户、编写 systemd 服务、检查状态，容易出现版本不一致、路径不同和漏配。Ansible 基于 SSH 和无代理方式，把安装步骤写成 Inventory、变量和 Playbook，重复执行时具备幂等性。本文按原文环境，在 Ubuntu 控制机安装 Ansible，准备 systemd 模板，编写 Playbook 完成下载、解压、建用户、启动服务和开机自启，并说明异地 SSH 映射与 Prometheus 验证边界。

一、控制机安装 Ansible 并准备 Inventory
原文使用 Ubuntu 和 APT。先更新系统并安装 Ansible，然后验证版本：

2. sudo apt update
3. sudo apt upgrade -y
4. apt install -y ansible
5. ansible --version

复制代码

原文发现 /etc/ansible 下没有现成配置文件，于是手动创建目录、hosts 和 ansible.cfg。下面的配置用于本地连通性验证：

2. mkdir -p /etc/ansible
3. cat > /etc/ansible/hosts <<EOF
4. [local]
5. localhost ansible_connection=local
6. EOF
7. cat > /etc/ansible/ansible.cfg <<EOF
8. [defaults]
9. inventory = /etc/ansible/hosts
10. host_key_checking = False
11. remote_user = root
12. stdout_callback = yaml
13. EOF
14. ansible localhost -m ping

复制代码

这里的 host_key_checking = False 和 remote_user = root 适合实验环境，但不适合作为长期默认配置。Inventory 也不建议长期保存 root 明文密码。

二、修正 systemd 模板中的段名和二进制路径
原文模板里 [Service 少了右方括号，同时 ExecStart 写成了 {{ install_dir }}/node_exporter，但 Playbook 会把解压目录重命名为 {{ install_dir }}/node_exporter，实际二进制位于 {{ install_dir }}/node_exporter/node_exporter。按原文部署逻辑，模板应修正为：

2. [Unit]
3. Description=Node Exporter
4. After=network.target
6. [Service]
7. User=node_exporter
8. Group=node_exporter
9. Type=simple
10. ExecStart={{ install_dir }}/node_exporter/node_exporter --collector.systemd --collector.processes
11. Restart=on-failure
12. RestartSec=5
14. [Install]
15. WantedBy=multi-user.target

复制代码

模板保留 --collector.systemd 和 --collector.processes 参数，服务用户为 node_exporter。若目标系统没有同名组，需要同时确认组配置，否则 Group=node_exporter 可能启动失败。

三、Playbook 任务拆解与执行
Playbook 的关键变量是 node_exporter_version、node_exporter_url 和 install_dir。原文手动步骤下载 v1.10.2，而 Playbook 变量写的是 1.8.2，下载地址和目录名都依赖版本号，执行前必须统一。下面示例沿用原文 Playbook 中的 1.8.2，并把 URL、目录和 systemd 模板串起来：

2. ---
3. - name: 安装node_exporter
4.   hosts: test
5.   become: yes
6.   vars:
7.     node_exporter_version: '1.8.2'
8.     node_exporter_url: 'https://ghproxy.net/https://github.com/prometheus/node_exporter/releases/download/v{{ node_exporter_version }}/node_exporter-{{ node_exporter_version }}.linux-amd64.tar.gz'
9.     install_dir: '/shan'
10.   tasks:
11.     - name: 创建存储目录
12.       file:
13.         path: '{{ install_dir }}'
14.         state: directory
15.         mode: '0755'
16.     - name: 下载node_exporter
17.       get_url:
18.         url: '{{ node_exporter_url }}'
19.         dest: '{{ install_dir }}/node_exporter.tar.gz'
20.         mode: '0644'
21.         timeout: 30
22.       retries: 3
23.       delay: 10
24.     - name: 解压node_exporter
25.       unarchive:
26.         src: '{{ install_dir }}/node_exporter.tar.gz'
27.         dest: '{{ install_dir }}'
28.         remote_src: yes
29.     - name: 清理压缩包
30.       file:
31.         path: '{{ install_dir }}/node_exporter.tar.gz'
32.         state: absent
33.     - name: 重命名解压目录为 node_exporter
34.       command: mv '{{ install_dir }}/node_exporter-{{ node_exporter_version }}.linux-amd64' '{{ install_dir }}/node_exporter'
35.       args:
36.         creates: '{{ install_dir }}/node_exporter'
37.     - name: 删除旧目录
38.       file:
39.         path: '{{ install_dir }}/node_exporter-{{ node_exporter_version }}.linux-amd64'
40.         state: absent
41.     - name: 创建专用用户
42.       user:
43.         name: node_exporter
44.         system: yes
45.         shell: /sbin/nologin
46.         createhome: no
47.     - name: 配置systemd服务
48.       template:
49.         src: node_exporter.service.j2
50.         dest: /etc/systemd/system/node_exporter.service
51.         owner: root
52.         group: root
53.         mode: '0644'
54.     - name: 重载systemd配置
55.       systemd:
56.         daemon_reload: yes
57.     - name: 启动并启用node_exporter服务
58.       systemd:
59.         name: node_exporter
60.         enabled: yes
61.         state: started

复制代码

Inventory 中先放入目标主机，原文示例为：

2. [test]
3. ip ansible_ssh_user=用户名 ansible_ssh_pass=密码

复制代码

进入 Playbook 目录执行：

2. cd /etc/ansible
3. ansible-playbook node_exporter.yml

复制代码

再到目标主机检查：

2. systemctl status node_exporter

复制代码

部署成功只代表服务已安装并启动，不代表 Prometheus 已经开始监控。还需要确认 Node Exporter 实际监听的 9100 端口可被 Prometheus 访问，把对应地址加入 Prometheus 的 scrape_configs，并在 Targets 页面确认目标状态为 UP。

四、异地主机通过 cpolar 映射 SSH
如果目标主机不在同一局域网，原文用 cpolar 把目标机 22 端口映射到公网 TCP 地址，让 Ansible 通过公网地址和端口建立 SSH 连接。安装并检查服务：

2. sudo curl https://get.cpolar.sh | sh
3. sudo systemctl status cpolar

复制代码

浏览器访问 http://目标IP:9200，登录 cpolar 管理界面创建隧道。原文示例隧道名称为 ssh，协议为 tcp，本地地址为 22，端口类型为随机临时 TCP，地区为 China Top。创建后会得到类似 tcp.cpolar.top 的域名和随机端口，Inventory 可写成：

2. [dbservers]
3. 2.tcp.cpolar.top ansible_user=root ansible_port=16198 ansible_password=***

复制代码

随后执行 ansible-playbook node_exporter.yml。临时端口会变化，原文进一步保留固定 TCP 地址，例如 China VIP 下的 15.tcp.cpolar.top:13633，再把固定地址填入隧道配置并更新 Inventory，避免端口变化导致连接信息失效。公网映射 SSH 会扩大暴露面，长期使用应改用普通运维账号、SSH 密钥、become 提权和 Ansible Vault，并限制来源地址。

五、批量执行前的检查清单
正式批量执行前，先在一台测试主机验证 systemd 文件、二进制路径和 /metrics 页面，再逐步扩大主机组。重点检查：systemd 模板的 [Service] 段和 ExecStart 路径已修正；Node Exporter 版本在手动命令、Playbook 变量、下载 URL 和目录名中保持一致；Inventory 不长期保存 root 明文密码；host_key_checking = False 只用于测试；ARM 等架构要换对应安装包；下载文件增加版本固定和校验；最后在 Prometheus 的 scrape_configs 和 Targets 页面确认 9100 端口监控状态。

按上述流程，Ansible 控制机可以根据 Inventory 向目标 Linux 主机统一下发 Node Exporter，完成目录创建、下载、解压、用户创建、systemd 服务生成、启动和开机自启。cpolar 解决的是异地 SSH 部署链路，监控是否生效仍要回到 Prometheus 抓取配置和目标状态上确认。