一份Role搞定5大Linux发行版：解析ansible-role-postgresql跨平台安装PostgreSQL原理

【免费下载链接】ansible-role-postgresql Ansible Role - PostgreSQL 项目地址: https://gitcode.com/gh_mirrors/an/ansible-role-postgresql

ansible-role-postgresql 是一个开源的 Ansible Role，能自动在 Debian、Ubuntu、RedHat、Fedora、Arch 这 5 大 Linux 发行版上完成 PostgreSQL 数据库的安装、初始化与配置。本文将拆解它实现跨平台部署的 3 个核心原理，并给出快速上手步骤。

✨ 手动部署 PostgreSQL 有多痛苦？

在不同 Linux 发行版上安装 PostgreSQL，要面对完全不同的"方言"：

痛点	说明
包管理器不同	Debian/Ubuntu 用 apt，RedHat/Fedora 用 yum/dnf，Arch 用 pacman
版本号不同	每个发行版仓库自带的 PostgreSQL 版本都不一样
配置路径不同	有的按版本分目录存放，有的统一目录
服务名不同	有的叫 postgresql，有的是 postgresql@15-main

ansible-role-postgresql 把这些差异全部"封装"了起来：你只写一份 Playbook，剩下的交给它。

🧭 原理一：用 ansible_facts 做操作系统自动分流

Role 的入口是 tasks/main.yml，核心思路是先问"你是谁"，再决定"怎么装"：

- include_tasks: setup-Archlinux.yml
  when: ansible_facts.os_family == 'Archlinux'

- include_tasks: setup-Debian.yml
  when: ansible_facts.os_family == 'Debian'

- include_tasks: setup-RedHat.yml
  when: ansible_facts.os_family == 'RedHat'

Ansible 内置的 ansible_facts.os_family 会把系统归类为三大族：

• Debian 族 → Debian、Ubuntu
• RedHat 族 → RedHat、CentOS、Fedora、Amazon Linux
• Archlinux 族 → Arch

这样一来，5 大发行版只需要 3 套安装任务文件，就能全部覆盖。

📦 原理二：vars 目录的"发行版 → 版本"变量映射

同一族发行版，不同小版本依然有差异（比如 Debian 12 自带 PostgreSQL 15，Ubuntu 24 是 16）。解决方案在 tasks/variables.yml：

- name: Include OS-specific variables (Debian).
  include_vars: "{{ ansible_facts.distribution }}-{{ ansible_facts.distribution_version.split('.')[0] }}.yml"
  when: ansible_facts.os_family == 'Debian'

它会按 "发行版名-大版本号" 动态加载 vars/ 目录下的对应文件：

变量文件	对应组合
vars/Debian-12.yml	PostgreSQL 15，服务名 postgresql@15-main
vars/Ubuntu-24.yml	PostgreSQL 16，服务名 postgresql
vars/RedHat-9.yml	RHEL 9 的默认包与服务名
vars/Fedora-41.yml / vars/Arch.yml	各自的包列表与路径

vars/ 目录中已预置 Debian 9~13、Ubuntu 16~26、RedHat 7~10、Fedora 34~43、Arch、Amazon 2 等几十份变量文件。加载后统一转换成 postgresql_packages、postgresql_version、postgresql_daemon、postgresql_config_path 等标准变量，后续任务只需用这套"统一语言"工作。

🔧 原理三：按发行版选择正确的包管理器

分流后的 3 个安装任务文件各管一摊：

任务文件	覆盖系统	关键动作
tasks/setup-Debian.yml	Debian/Ubuntu	apt 安装 + locale_gen 生成 locale
tasks/setup-RedHat.yml	RedHat/CentOS/Fedora/Amazon	yum 安装，支持 postgresql_enablerepo 指定仓库
tasks/setup-Archlinux.yml	Arch	pacman 安装

比如 RedHat 族安装时会主动排除 python-unversioned-command 包，避免它破坏 Python 环境——这类"发行版专属坑位"都已在任务里提前填平。

🚀 安装之后：初始化与配置一气呵成

安装只是第一步，tasks/initialize.yml 和 tasks/configure.yml 会接着完成两件事：

1. 初始化数据目录：检测数据目录中是否存在 PG_VERSION 文件，不存在则以 postgres 用户执行 initdb，一次性把数据库"落地"
2. 渲染配置文件：
   • 用 lineinfile 精确改写 postgresql.conf 中的全局选项（如 unix_socket_directories、log_directory）
   • 用模板 templates/pg_hba.conf.j2 生成访问控制文件 pg_hba.conf

任何配置变更都会触发 handlers/main.yml 中的重启 handler 自动生效，无需手动干预。

⚡ 快速上手：3 步启用这个 Role

第 1 步：获取 Role

git clone https://gitcode.com/gh_mirrors/an/ansible-role-postgresql

第 2 步：写一份 Playbook（需要 root 权限，记得加 become: yes）

- hosts: database
  become: yes
  vars_files:
    - vars/main.yml
  roles:
    - geerlingguy.postgresql

第 3 步：在 vars/main.yml 中声明你要的数据库和账号

postgresql_databases:
  - name: example_db
postgresql_users:
  - name: example_user

执行后，PostgreSQL 会完成安装、初始化、建库、建用户，并设置开机自启。完整的测试用例可以参考 molecule/default/converge.yml。

📋 常用变量速查（都在 defaults/main.yml）

变量	作用
postgresql_databases	要确保存在的数据库列表
postgresql_users	要创建的数据库用户
postgresql_privs	为用户/角色授权
postgresql_hba_entries	自定义 pg_hba.conf 访问规则
postgresql_service_state / postgresql_service_enabled	控制服务状态与开机自启
postgresql_enablerepo	RedHat 族专用，指定安装仓库
postgresql_restarted_state	配置变更后的服务动作（restarted/reloaded）

✅ 总结

ansible-role-postgresql 的跨平台设计可以浓缩为三句话：

1. 用 ansible_facts.os_family 分流 —— 一份 Playbook 适配 5 大发行版
2. 用 vars 目录做版本映射 —— 每个"发行版-版本"组合都有对应变量文件
3. 统一变量语言 + 条件任务 —— 安装、初始化、配置、账号管理对所有系统完全一致

对于需要批量管理多台不同系统数据库服务器的运维同学来说，这就是"一次编写，处处部署"的最佳实践。

【免费下载链接】ansible-role-postgresql Ansible Role - PostgreSQL 项目地址: https://gitcode.com/gh_mirrors/an/ansible-role-postgresql