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 }
依赖
兼容性矩阵
发行版 / 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 provision
或 ansible-playbook tests/playbook.yml -i vagrant-inventory
重新配置。
如果你想修改测试剧本,请查看 tests/playbook.yml,并更改 tests/vars.yml 中的变量。
如果你是贡献者,请先在 vagrant 环境中测试你的更改(使用目标发行版),如果可能,确保你的更改在 .travis.yml 中进行了测试。
许可证
根据 MIT 许可证授权。有关详细信息,请参见 LICENSE 文件。
感谢
创建者:
维护者:
主要贡献者:
反馈、错误报告、请求...
欢迎反馈!