aboutsummaryrefslogtreecommitdiffstats
path: root/roles
diff options
context:
space:
mode:
authorStonewall Jackson <stonewall@sacredheartsc.com>2023-02-11 08:16:34 -0500
committerStonewall Jackson <stonewall@sacredheartsc.com>2023-02-11 08:16:34 -0500
commit9435338c53a0f8628f45fb0808b29d6f06b8fe98 (patch)
treecf01decec6ee68d1b2f9fa9721e017b2122da2c2 /roles
parentaf3dc1be1bae5049a6229a58f3f7754533796592 (diff)
downloadselfhosted-9435338c53a0f8628f45fb0808b29d6f06b8fe98.tar.gz
selfhosted-9435338c53a0f8628f45fb0808b29d6f06b8fe98.zip
cups_client: add documentation
Diffstat (limited to 'roles')
-rw-r--r--roles/cups_client/README.md32
-rw-r--r--roles/cups_client/templates/etc/cups/client.conf.j22
2 files changed, 33 insertions, 1 deletions
diff --git a/roles/cups_client/README.md b/roles/cups_client/README.md
new file mode 100644
index 0000000..9a60904
--- /dev/null
+++ b/roles/cups_client/README.md
@@ -0,0 +1,32 @@
+CUPS Client
+===========
+
+Description
+-----------
+
+The `cups_client` role configures a Linux host to print to a central CUPS server.
+
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable | Default | Description
+------------|---------|------------
+`cups_host` | &nbsp; | Hostname of CUPS server
+
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- name: configure CUPS client
+ hosts: linux_desktops
+ roles:
+ - role: cups_client
+ vars:
+ cups_host: cups.example.com
+````
diff --git a/roles/cups_client/templates/etc/cups/client.conf.j2 b/roles/cups_client/templates/etc/cups/client.conf.j2
index 0869834..4d79e56 100644
--- a/roles/cups_client/templates/etc/cups/client.conf.j2
+++ b/roles/cups_client/templates/etc/cups/client.conf.j2
@@ -1,3 +1,3 @@
-ServerName {{ cups_server_name }}:631
+ServerName {{ cups_host }}:631
Encryption Required
ValidateCerts Yes