silverlogic.postgresql

ANXS - PostgreSQL 构建状态


需要帮助!如果你愿意帮忙维护这个 Ansible 角色,请在 GitHub 上提出一个问题。很多人似乎在使用这个角色,而我们(显而易见)需要帮助! 💖


这个 Ansible 角色用于安装和配置 PostgreSQL、扩展、数据库和用户。

安装

在 Ansible 2.4.0 及更高版本上进行了测试。

安装方法:

ansible-galaxy install ANXS.postgresql

示例剧本

下面是如何使用这个角色的示例:

- hosts: postgresql-server
  become: yes
  roles:
     - { role: anxs.postgresql }

依赖

  • ANXS.monit(Galaxy/GH),如果你想要使用 monit 保护(在这种情况下,你应该设置 monit_protection: true

兼容性矩阵

发行版 / PostgreSQL <= 9.3 9.4 9.5 9.6 10 11 12
Ubuntu 14.04 :no_entry: :no_entry: :no_entry: :no_entry: :no_entry: :no_entry: :no_entry:
Ubuntu 16.04 :no_entry: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Debian 8.x :no_entry: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Debian 9.x :no_entry: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
CentOS 6.x :no_entry: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
CentOS 7.x :no_entry: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
CentOS 8.x :no_entry: :grey_question: :grey_question: :grey_question: :grey_question: :grey_question: :grey_question:
Fedora 最新版 :no_entry: :x: :x: :x: :x: :x: :x:
  • :white_check_mark: - 已测试,正常工作
  • :warning: - 不适用于生产环境
  • :grey_question: - 未来可能可用(如果可以,请协助)
  • :interrobang: - 可能可用,未测试
  • :no_entry: - 已达到生命周期结束(EOL)

变量

# 基本设置
postgresql_version: 12
postgresql_encoding: "UTF-8"
postgresql_locale: "en_US.UTF-8"
postgresql_ctype: "en_US.UTF-8"

postgresql_admin_user: "postgres"
postgresql_default_auth_method: "peer"

postgresql_service_enabled: false # 服务是否应启用,默认值为 true

postgresql_cluster_name: "main"
postgresql_cluster_reset: false

# 要创建的数据库列表(可选)
# 注:如需对扩展进行更多灵活配置,请使用 postgresql_database_extensions 设置。
postgresql_databases:
  - name: foobar
    owner: baz          # 可选;指定数据库的所有者
    hstore: yes         # 在此数据库上安装 hstore 扩展的标志(是/否)
    uuid_ossp: yes      # 在此数据库上安装 uuid-ossp 扩展的标志(是/否)
    citext: yes         # 在此数据库上安装 citext 扩展的标志(是/否)
    encoding: "UTF-8"   # 针对每个数据库覆盖全局 {{ postgresql_encoding }} 变量
    lc_collate: "en_GB.UTF-8"   # 针对每个数据库覆盖全局 {{ postgresql_locale }} 变量
    lc_ctype: "en_GB.UTF-8"     # 针对每个数据库覆盖全局 {{ postgresql_ctype }} 变量

# 要创建的数据库扩展列表(可选)
postgresql_database_extensions:
  - db: foobar
    extensions:
      - hstore
      - citext

# 要创建的用户列表(可选)
postgresql_users:
  - name: baz
    pass: pass
    encrypted: yes  # 如果密码应加密,postgresql >= 10 只接受加密密码

# 要创建的模式列表(可选)
postgresql_database_schemas:
  - database: foobar           # 数据库名称
    schema: acme               # 模式名称
    state: present

  - database: foobar           # 数据库名称
    schema: acme_baz           # 模式名称
    owner: baz                 # 所有者名称
    state: present

# 要应用的用户权限列表(可选)
postgresql_user_privileges:
  - name: baz                   # 用户名称
    db: foobar                  # 数据库
    priv: "ALL"                 # 权限字符串格式:例:INSERT,UPDATE/表:SELECT/另一个表:ALL
    role_attr_flags: "CREATEDB" # 角色属性标志

还有许多其他设置,具体请查看 defaults/main.yml

测试

这个项目附带一个 Vagrantfile,这是测试角色更改的快速简便方法,用 vagrant up 启动。

请参见 vagrant 文档 来设置 vagrant。

一旦你的虚拟机启动,可以使用 vagrant provisionansible-playbook tests/playbook.yml -i vagrant-inventory 重新配置。

如果你想修改测试剧本,请查看 tests/playbook.yml,并更改 tests/vars.yml 中的变量。

如果你是贡献者,请先在 vagrant 环境中测试你的更改(使用目标发行版),如果可能,确保你的更改在 .travis.yml 中进行了测试。

许可证

根据 MIT 许可证授权。有关详细信息,请参见 LICENSE 文件。

感谢

创建者:

维护者:

主要贡献者:

反馈、错误报告、请求...

欢迎反馈!

关于项目

Install and configure PostgreSQL, dependencies, extensions, databases and users.

安装
ansible-galaxy install silverlogic.postgresql
许可证
mit
下载
7.2k
拥有者