云贝教育 |【技术文章】Ansible通过template 模块配置PostgreSQL的配置文件

本文为云贝教育 刘老师 原创，请尊重知识产权，转发请注明出处，不接受任何抄袭、演绎和未经注明出处的转载。

在Ansible中，你可以使用 template 模块来修改PostgreSQL的配置文件，并在配置文件发生变化时触发PostgreSQL服务的重启。以下是一个示例Playbook，展示了如何实现这一操作。

一. 创建模板文件

首先，创建一个Jinja2模板文件，用于生成PostgreSQL的配置文件。假设你有一个名为 postgresql.conf.j2 的模板文件，内容如下：

# postgresql.conf.j2
listen_addresses = '*'
port = 5432
max_connections = {{ max_connections }}
shared_buffers = {{ shared_buffers }}

将这个模板文件放在你的Ansible项目的 templates 目录下。

# DB Version: 16
# OS Type: linux
# DB Type: web
# Total Memory (RAM): 16 GB
# CPUs num: 32
# Connections num: 1000
# Data Storage: ssd

listen_addresses = '*'
port = 5432
max_connections = 1000
shared_buffers = 4GB
effective_cache_size = 12GB
maintenance_work_mem = 1GB
checkpoint_completion_target = 0.9
wal_buffers = 16MB
default_statistics_target = 100
random_page_cost = 1.1
effective_io_concurrency = 200
work_mem = 1048kB
huge_pages = off
min_wal_size = 1GB
max_wal_size = 4GB
max_worker_processes = 32
max_parallel_workers_per_gather = 4
max_parallel_workers = 32
max_parallel_maintenance_workers = 4
log_min_duration_statement=0
logging_collector = on
log_filename = 'postgresql-%Y-%m-%d.log'
log_rotation_age = '1d'
log_directory = 'pg_log'
log_checkpoints = on
log_connections = on
log_disconnections = on
log_lock_waits = on
log_temp_files = 0
log_autovacuum_min_duration = 0

二. 创建Ansible Playbook

接下来，创建一个Ansible Playbook，使用 template 模块来应用配置文件，并在配置文件发生变化时触发PostgreSQL服务的重启。

---
- name: Configure and Restart PostgreSQL
  hosts: dbservers
  become_method: su
  become_user: postgres
  become: yes
  vars:
    max_connections: 1000
    shared_buffers: '512MB'  
  tasks:
    - name: Copy PostgreSQL configuration file
      template:
        src: postgresql.conf.j2
        dest: /data/pgdata/data/postgresql.conf
        owner: postgres
        group: postgres
        mode: '0644'
      notify: Restart PostgreSQL  
  handlers:
    - name: Restart PostgreSQL
      command: /usr/local/postgres/bin/pg_ctl restart -D /data/pgdata/data

三. 解释Playbook

• hosts: all：指定要运行该Playbook的目标主机。
• become: yes：使用特权提升（例如 sudo）来执行任务。
• vars：定义变量，这些变量将在模板中使用。
• tasks：

1. Ensure PostgreSQL is installed：确保PostgreSQL已安装。
2. Copy PostgreSQL configuration file：使用 template 模块将模板文件复制到目标主机上的配置文件位置。如果配置文件发生变化，将触发处理程序 Restart PostgreSQL。
3. Ensure PostgreSQL service is enabled and started：确保PostgreSQL服务已启用并正在运行。

• handlers：

1. Restart PostgreSQL：如果配置文件发生变化，将重启PostgreSQL服务。

四. 运行Playbook

保存Playbook文件（例如 configure_postgresql.yml），然后运行它：

ansible-playbook -i inventory_file configure_postgresql.yml

其中 inventory_file 是你的主机清单文件，例如 hosts 或 inventory.ini。

五. 注意事项

• 版本和路径：根据你的PostgreSQL版本和操作系统，配置文件的路径可能会有所不同。请确保路径正确。
• 权限：确保配置文件的权限设置正确，以避免权限问题。
• 测试：在生产环境中应用之前，建议先在测试环境中进行测试，以确保配置文件更改和重启操作按预期工作。