robertdebock / ansible-role-cups Goto Github PK

View Code? Open in Web Editor NEW

8.0 3.0 5.0 93 KB

Install and configure CUPS, the Common Unix Printing System.

Home Page: https://robertdebock.nl/

License: Apache License 2.0

Jinja 100.00%

cups print printer printing ansible molecule tox playbook system

ansible-role-cups's Introduction

cups

Install and configure CUPS, the Common Unix Printing System.

GitHub	GitLab	Quality	Downloads	Version

Example Playbook

This example is taken from molecule/default/converge.yml and is tested on each push, pull request and release.

---
- name: Converge
  hosts: all
  become: yes
  gather_facts: yes

  roles:
    - role: robertdebock.cups

The machine needs to be prepared. In CI this is done using molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: yes
  gather_facts: no

  roles:
    - role: robertdebock.bootstrap

Also see a full explanation and example on how to use these roles.

Role Variables

The default values for the variables are set in defaults/main.yml:

---
# defaults file for cups

# Allow remote access
cups_listen: "localhost:631"
cups_serveralias: "*"

# Share local printers on the local network. (boolean)
cups_browsing: no

# Allow access to the server...
cups_locations:
  - name: /
    order: allow,deny
    allow: "@LOCAL"
  - name: /admin
    order: allow,deny
    allow: "@LOCAL"
  - name: /admin/conf
    authtype: Default
    require: user @SYSTEM
    order: allow,deny
    allow: "@LOCAL"
  - name: /admin/log
    authtype: Default
    require: user @SYSTEM
    order: allow,deny

# Cups can save a job history. (boolean)
cups_preserve_job_history: yes

# Cups can offer a web-interface. (boolean)
cups_web_interface: yes

Requirements

pip packages listed in requirements.txt.

State of used roles

The following roles are used to prepare a system. You can prepare your system in another way.

Requirement	GitHub	GitLab
robertdebock.bootstrap

Context

This role is a part of many compatible roles. Have a look at the documentation of these roles for further information.

Here is an overview of related roles:

Compatibility

This role has been tested on these container images:

container	tags
Alpine	all
Amazon	Candidate
EL	8, 9
Debian	all
Fedora	all
opensuse	all
Ubuntu	all

The minimum version of Ansible required is 2.12, tests have been done to:

The previous version.
The current version.
The development version.

If you find issues, please register them in GitHub

License

Apache-2.0.

Author Information

robertdebock

Please consider sponsoring me.

ansible-role-cups's People

Contributors

Stargazers

Watchers

Forkers

vbotka pob0111 dfein38347g denics greigm

ansible-role-cups's Issues

Cannot access web interface

Describe the bug

After running the role, I cannot access the CUPS interface from my network.

Environment

Control node OS: PopOS 21.04
Control node Ansible version: 2.11.6
Managed node OS: Proxmox 7

Please consider sponsoring me.

Configure cups: `failed to validate`

Describe the bug

The Configure cups task fails with: failed to validate

Playbook

---
--
- name: Additional features
  hosts: web:&{{ env }}
  become: yes
  roles:
    - { role: robertdebock.cups, tags: [printer] }

Output

TASK [robertdebock.cups : Configure cups] **************************************
fatal: [staging-2.localdomain]: FAILED! => {"changed": false, "checksum": "4bcc5dff4c0183708e300b6c69624ddbdb203991", "exit_status": 1, "msg": "failed to validate", "stderr": "", "stderr_lines": [], "stdout": "", "stdout_lines": []}

fatal: [staging-2.localdomain]: FAILED! => {
    "changed": false,
    "checksum": "4bcc5dff4c0183708e300b6c69624ddbdb203991",
    "diff": [],
    "exit_status": 1,
    "invocation": {
        "module_args": {
            "_original_basename": "cupsd.conf.j2",
            "attributes": null,
            "backup": false,
            "checksum": "4bcc5dff4c0183708e300b6c69624ddbdb203991",
            "content": null,
            "dest": "/etc/cups/cupsd.conf",
            "directory_mode": null,
            "follow": false,
            "force": true,
            "group": null,
            "local_follow": null,
            "mode": "0640",
            "owner": null,
            "remote_src": null,
            "selevel": null,
            "serole": null,
            "setype": null,
            "seuser": null,
            "src": "/home/admin/.ansible/tmp/ansible-tmp-1695691360.9995403-26245-83999800941144/source",
            "unsafe_writes": false,
            "validate": "cupsd -t -c %s"
        }
    },
    "msg": "failed to validate",
    "stderr": "",
    "stderr_lines": [],
    "stdout": "",
    "stdout_lines": []
}

Environment

Control node OS: Ubuntu 22.04.3 LTS
Control node Ansible version: ansible [core 2.15.0]
Managed node OS: Ubuntu 20.04.5 LTS

[Docs] How to add a printer (`lpadmin`)

After CUPS have been installed and set up, how can a printer be added using Ansible, is this role able to manage printers?

Site for example docs does not load (timeout)

Describe the bug

The site linked in the readme for the example docs does not load (timeout):
https://robertdebock.nl/how-to-use-these-roles.html

Add server alias

To be able to log into the webinterface using the server name and not the ip, we should add the
ServerAlias *

configuration element. Usually a * is ok, but we can customize it.

robertdebock / ansible-role-cups Goto Github PK

ansible-role-cups's Introduction

ansible-role-cups's People

Contributors

Stargazers

Watchers

Forkers

ansible-role-cups's Issues

Describe the bug

Environment

Describe the bug

Playbook

Output

Environment

Describe the bug

Recommend Projects

Recommend Topics

Recommend Org