SaltStack如何实现配置文件管理

在 SaltStack（Salt） 中，配置文件管理主要通过 State（状态）系统 来完成，核心思想是：
用声明式 SLS 文件描述“目标状态”，Salt 负责把实际配置变成期望状态。

下面从 原理 → 常用模块 → 示例 → 实践建议 系统说明。

一、SaltStack 配置文件管理的核心原理

Salt 使用 States（状态） 来描述配置，底层通常依赖以下机制：

• SLS 文件（.sls）：描述配置应达到的状态
• 执行模块（execution modules）：真正执行操作
• 文件服务器（file_roots）：存放配置文件模板
• Jinja + YAML：实现动态配置

典型流程：

Minion 拉取 SLS → 解析状态 → 调用模块 → 修改配置文件 → 返回结果

二、最常用模块：file.managed

这是 配置文件管理最核心的模块。

1️⃣ 基本用法（直接下发配置文件）

/etc/nginx/nginx.conf:
  file.managed:
    - source: salt://nginx/nginx.conf
    - user: root
    - group: root
    - mode: 644

含义：

• 目标路径：/etc/nginx/nginx.conf
• 源文件：/srv/salt/nginx/nginx.conf
• 自动覆盖、权限管理

2️⃣ 使用 Jinja 模板（动态配置）

/etc/nginx/nginx.conf:
  file.managed:
    - source: salt://nginx/nginx.conf.j2
    - template: jinja
    - user: root
    - group: root
    - mode: 644
    - context:
        worker_processes: 4

模板示例（nginx.conf.j2）：

worker_processes {{ worker_processes }};

✅ 好处：

• 按角色、环境生成不同配置
• 避免维护多份静态配置文件

3️⃣ 基于 Pillar 动态生成配置（推荐）

/etc/myapp/config.yaml:
  file.managed:
    - source: salt://myapp/config.yaml.j2
    - template: jinja

模板中：

db_host: {{ pillar['db_host'] }}
db_port: {{ pillar['db_port'] }}

Pillar 示例：

db_host: 192.168.1.10
db_port: 3306

✅ Pillar 常用于 敏感配置 / 环境差异配置

4️⃣ 条件、判断与循环

{% if grains['os'] == 'CentOS' %}
conf_path: /etc/centos.conf
{% else %}
conf_path: /etc/default.conf
{% endif %}

{% for server in pillar['servers'] %}
server {{ server }}
{% endfor %}

三、配置文件变更后的联动操作

1️⃣ 修改配置后重启服务

/etc/nginx/nginx.conf:
  file.managed:
    - source: salt://nginx/nginx.conf
    - watch_in:
      - service: nginx

nginx:
  service.running:
    - enable: true
    - reload: true

或：

- watch:
  - file: /etc/nginx/nginx.conf

✅ 实现 配置变更 → 自动 reload/restart

四、批量下发 vs 个性化配置

批量下发（相同配置）

/etc/hosts:
  file.managed:
    - source: salt://common/hosts

个性化配置（按 Minion 区分）

server_id: {{ grains['id'] }}
ip: {{ grains['ipv4'][0] }}

或根据 Pillar：

env: {{ pillar.get('env', 'dev') }}

五、目录与配置管理

1️⃣ 管理整个配置目录

/etc/myapp/conf.d:
  file.directory:
    - user: root
    - group: root
    - mode: 755

2️⃣ 递归下发目录

/etc/myapp:
  file.recurse:
    - source: salt://myapp/conf
    - include_empty: true

六、文件内容片段管理（append / line）

追加内容

/etc/sysctl.conf:
  file.append:
    - text: |
        net.ipv4.ip_forward = 1

精确管理某一行（推荐）

/etc/ssh/sshd_config:
  file.replace:
    - pattern: '^#?PermitRootLogin.*'
    - repl: 'PermitRootLogin no'
    - append_if_not_found: true

七、最佳实践建议 ✅

1. 优先使用 file.managed + Jinja + Pillar
2. 静态配置 → 直接 source
3. 差异配置 → Jinja + Grains / Pillar
4. 改动配置 → 一定要 watch 服务
5. 敏感数据 → 必须放 Pillar，不放 SLS
6. 一个服务一个 SLS，职责清晰

八、典型目录结构示例

/srv/salt/
├── nginx/
│   ├── init.sls
│   ├── nginx.conf.j2
├── myapp/
│   ├── init.sls
│   ├── config.yaml.j2
└── top.sls

# top.sls
base:
  '*':
    - nginx
    - myapp

九、一句话总结

SaltStack 通过 file.managed + Jinja 模板 + Pillar，实现从“静态配置下发”到“动态、环境感知的配置文件管理”，并可与服务状态联动，保证配置始终处于期望状态。

如果你愿意，我可以：

• 给你一个 完整 nginx / Redis / MySQL 配置管理示例
• 对比 Ansible vs Salt 配置管理差异
• 帮你设计 多环境（dev/test/prod）配置方案