第 21 章 使用 RHEL 系统角色安装和配置 PostgreSQL 数据库服务器

流程

1. 将敏感变量存储在加密的文件中：

   1. 创建 vault ：

      $ ansible-vault create ~/vault.yml
      New Vault password: <vault_password>
      Confirm New Vault password: <vault_password>

      Copy to Clipboard

   2. 在 ansible-vault create 命令打开编辑器后，以 <key>: <value> 格式输入敏感数据：

      pwd: <password>

      Copy to Clipboard
   3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

2. 创建一个包含以下内容的 playbook 文件，如 ~/playbook.yml ：

   ---
   - name: Installing and configuring PostgreSQL
     hosts: managed-node-01.example.com
     vars_files:
       - ~/vault.yml
     tasks:
       - name: Create directory for TLS certificate and key
         ansible.builtin.file:
           path: /etc/postgresql/
           state: directory
           mode: 755
   
       - name: Copy CA certificate
         ansible.builtin.copy:
           src: "~/{{ inventory_hostname }}.crt"
           dest: "/etc/postgresql/server.crt"
   
       - name: Copy private key
         ansible.builtin.copy:
           src: "~/{{ inventory_hostname }}.key"
           dest: "/etc/postgresql/server.key"
           mode: 0600
   
       - name: PostgreSQL with an existing private key and certificate
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.postgresql
         vars:
           postgresql_version: "16"
           postgresql_password: "{{ pwd }}"
           postgresql_ssl_enable: true
           postgresql_cert_name: "/etc/postgresql/server"
           postgresql_server_conf:
             listen_addresses: "'*'"
             password_encryption: scram-sha-256
           postgresql_pg_hba_conf:
             - type: local
               database: all
               user: all
               auth_method: scram-sha-256
             - type: hostssl
               database: all
               user: all
               address: '127.0.0.1/32'
               auth_method: scram-sha-256
             - type: hostssl
               database: all
               user: all
               address: '::1/128'
               auth_method: scram-sha-256
             - type: hostssl
               database: all
               user: all
               address: '192.0.2.0/24'
               auth_method: scram-sha-256
   
   
       - name: Open the PostgresQL port in firewalld
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.firewall
         vars:
           firewall:
             - service: postgresql
               state: enabled

   Copy to Clipboard

   示例 playbook 中指定的设置包括如下：

   postgresql_version: <version>

   设置要安装的 PostgreSQL 的版本。您可以设置的版本取决于在受管节点上运行的 Red Hat Enterprise Linux 中提供的 PostgreSQL 版本。

   您无法通过更改 postgresql_version 变量并再次运行 playbook 来升级或降级 PostgreSQL。

   postgresql_password: <password>

   设置 postgres 数据库超级用户的密码。

   您无法通过更改 postgresql_password 变量并再次运行 playbook 来更改密码。

   postgresql_cert_name: <private_key_and_certificate_file>

   定义受管节点上没有.crt 和 key 后缀的证书和私钥的路径和基础名称。在 PostgreSQL 配置过程中，角色在 /var/lib/pgsql/data/ 目录中创建引用这些文件的符号链接。

   证书和私钥必须在受管节点上本地存在。您可以将任务与 ansible.builtin.copy 模块一起使用，来将文件从控制节点传输到受管节点，如 playbook 中所示。

   postgresql_server_conf: <list_of_settings>

   定义角色应设置的 postgresql.conf 设置。角色将这些设置添加到 /etc/postgresql/system-roles.conf 文件中，并在 /var/lib/pgsql/data/postgresql.conf 的末尾包含此文件。因此，postgresql_server_conf 变量中的设置会覆盖 /var/lib/pgsql/data/postgresql.conf 中的设置。

   使用 postgresql_server_conf 中的不同设置重新运行 playbook 会使用新设置覆盖 /etc/postgresql/system-roles.conf 文件。

   postgresql_pg_hba_conf: <list_of_authentication_entries>

   在 /var/lib/pgsql/data/pg_hba.conf 文件中配置客户端身份验证条目。详情请查看 PostgreSQL 文档。

   示例允许以下到 PostgreSQL 的连接：

   • 使用本地 UNIX 域套接字的未加密的连接。
   • 到 IPv4 和 IPv6 localhost 地址的 TLS 加密的连接。
   • 来自 192.0.2.0/24 子网的 TLS 加密的连接。请注意，只有在您也在 postgresql_server_conf 变量中适当配置了 listen_addresses 设置，才能从远程地址进行访问。

   使用 postgresql_pg_hba_conf 中的不同设置重新运行 playbook 会使用新设置覆盖 /var/lib/pgsql/data/pg_hba.conf 文件。

   有关 playbook 中使用的所有变量的详情，请查看控制节点上的 /usr/share/ansible/roles/rhel-system-roles.postgresql/README.md 文件。

3. 验证 playbook 语法：

   $ ansible-playbook --ask-vault-pass --syntax-check ~/playbook.yml

   Copy to Clipboard

   请注意，这个命令只验证语法，不能防止错误的、但有效的配置。

4. 运行 playbook：

   $ ansible-playbook --ask-vault-pass ~/playbook.yml

   Copy to Clipboard