From 76dbd6310861346983006cdcb20aa76a37a1df75 Mon Sep 17 00:00:00 2001
From: Stonewall Jackson <stonewall@sacredheartsc.com>
Date: Thu, 16 Feb 2023 21:25:56 -0500
Subject: postgresql_server: add docs

---
 roles/postgresql_server/README.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 roles/postgresql_server/README.md

diff --git a/roles/postgresql_server/README.md b/roles/postgresql_server/README.md
new file mode 100644
index 0000000..493bdb0
--- /dev/null
+++ b/roles/postgresql_server/README.md
@@ -0,0 +1,36 @@
+PostgreSQL Server
+=================
+
+Description
+-----------
+
+The `postgresql_server` role installs and configures the PostgreSQL database,
+and configures the server for client GSSAPI authentication.
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable                         | Default          | Description
+---------------------------------|------------------|------------
+`postgresql_timezone`            | `{{ timezone }}` | Database timezone
+`postgresql_max_connections`     | 100              | Maximum number of concurrent connections
+`postgresql_shared_buffers_mb`   | 25% of host RAM  | Shared buffer size (MB)
+`postgresql_password_users`      | `[]`             | List of users that don't support GSSAPI authentication
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- name: configure postgresql
+  hosts: postgresql_servers
+  roles:
+    - role: postgresql
+      vars:
+        postgresql_password_users:
+          - invidious
+          - mydbuser
+````
-- 
cgit