Ансибл Роль: cups

Устанавливает CUPS, необходимые PPD и настраивает принтеры и классы в CUPS

Установка и настройка CUPS

• Устанавливает cups и cups-pdf.
• Пользователи, указанные в cups_lpadmin_users, будут добавлены в группу lpadmin для администрирования CUPS.
• Устанавливает cups-lpd, если переменные это позволяют (см. ниже):
  • Создает учетную запись пользователя для запуска процесса cups-lpd.
  • Устанавливает xinetd для запуска cups-lpd как сервиса. Использует файл шаблона cups-lpd для создания конфигурации xinetd.
• Настройка CUPS:
  • Если предоставлены шаблоны для cupsd.conf, cups-browsed.conf и snmp.conf, они будут сгенерированы и скопированы.
  • Если предоставлены SSL сертификаты, они будут скопированы в нужное место.

Установка PPD

• Создает /opt/share/ppd, где CUPS ищет PPD, которые были скопированы вручную.
• Добавляет репозиторий OpenPrinting.
• Устанавливает пакет OpenPrinting для Ricoh - openprinting-ppds-postscript-ricoh.
  • Также распаковывает установленные PPD, так как пакет устанавливает их в виде gzip файлов в /opt/OpenPrinting-Ricoh/ppds/Ricoh.
• Устанавливает HPLIP:
  • Также устанавливает проприетарный плагин HP с помощью скрипта.
• Копирует PPD из указанной папки в cups_ppd_files_to_be_copied в /opt/share/ppd.

Установка принтеров

• Принтеры, которые должны быть удалены, будут удалены в первую очередь.
• Устанавливает принтеры, указанные в переменной cups_printer_list, затем устанавливает классы, указанные в cups_class_list.
  • См. cups_printer_list и cups_class_list, чтобы узнать, как определить каждый принтер и класс в переменных cups_printer_list и cups_class_list соответственно.
  • Использует модуль cups_lpadmin. В ней есть документация/комментарии о том, как использовать этот модуль.
  • cups_lpadmin - это прямая копия из HP41.ansible-modules-extra/system/cups_lpadmin. Когда он будет объединен с основным репозиторием, он будет удален отсюда.

Требования

• Ansible >= 2.1
• Гостевая система: Debian
  • stretch
  • jessie
  • wheezy
• Гостевая система: Ubuntu
  • xenial
  • trusty
  • precise

Возможные дополнительные задачи, которые не входят в обязанности этой роли.

• Открытие необходимых портов CUPS - 515(LPR), 631(IPP/IPPS), 9100(прямой IP) через файрвол.
  • Если вы хотите использовать debops.ferm, вы можете использовать/модифицировать cups__debops_ferm_dependent_rules (определенные в настройках), чтобы передать их в debops.ferm.

Переменные по умолчанию, которые могут быть переопределены или использоваться как есть при использовании этой роли:

Установка и настройка CUPS:

• cups_lpadmin_users: Список пользователей, которые должны быть добавлены в группу администраторов CUPS (lpadmin). По умолчанию=root.
• cups_lpd: Устанавливать и настраивать cups-lpd - По умолчанию=True.
• cups_sysadmins_email: Электронная почта, которая будет использоваться для создания шаблона cupsd.conf - По умолчанию=sysadmins@ansible_fqdn.
• cups__debops_ferm_dependent_rules: Простые правила по умолчанию для открытия портов (515, 631, 9100) через файрвол, которые можно использовать при использовании роли debops.ferm.
• /etc/xinetd.d/cups-lpd
  • cups_lpd_usn: Имя пользователя, с которым будет запущен процесс cups-lpd (через xinetd) - По умолчанию=cupslpd.
• Опциональные шаблоны:
  • Их можно было настроить как простое копирование файлов, но доступ к ansible переменным и добавление их не будет возможным. С помощью ansible_managed, ansible_fqdn и др. они будут доступны. Шаблоны могут также быть простыми текстовыми файлами без объявления переменных и будут скопированы.
  • cups_cupsd_conf_template: Для /etc/cups/cupsd.conf.
  • cups_cups_browsed_conf_template: Для /etc/cups/cups-browsed.conf.
  • cups_snmp_conf_template: Для /etc/cups/snmp.conf.

Установка и копирование PPD:

• cups_ppd_files_to_be_copied: Папка для копирования всех .ppd файлов - По умолчанию=None.
• cups_hplip: Устанавливать ли HPLIP - По умолчанию=True.
• cups_ricoh_openprinting: Устанавливать ли драйверы/PPD OpenPrinting-Ricoh - По умолчанию=True.
• cups_openprinting_apt_required: Определяется как тернарная переменная. Контролирует, добавляется ли APT ключ и репозиторий OpenPrinting в зависимости от установки драйвера Ricoh. Его можно легко переопределить.
• cups_openprinting_apt_key_id: Идентификатор APT ключа для получения с ключевого сервера. По умолчанию=24CBF5474CFD1E2F.
• cups_openprinting_key_server: Ключевой сервер для получения ключа для нижеприведенного репозитория - По умолчанию=keyserver.ubuntu.com.
• cups_openprinting_repo: Репозиторий OpenPrinting для добавления - По умолчанию="deb http://www.openprinting.org/download/printdriver/debian/ lsb3.2 main".

Установка принтеров и классов:

• cups_printer_uri_prefix: Префикс URI для любых фильтров на URI - По умолчанию="".
• cups_printer_report_ipp_supplies: Когда объект принтера не имеет атрибута report_ipp_supply_levels, это значение используется - По умолчанию=True.
• cups_printer_report_snmp_supplies: Когда объект принтера не имеет атрибута report_snmp_supply_levels, это значение используется - По умолчанию=True.
• cups_printer_is_shared: Когда объект принтера не имеет атрибута shared, это значение используется - По умолчанию=True.
• cups_class_is_shared: Когда объект класса не имеет атрибута shared, это значение используется - По умолчанию=True.
• cups_printer_list: Список хешей, содержащих информацию о принтерах, необходимую для их установки. Пожалуйста, проверьте модуль cups_lpadmin и как используется переменная cups_printer_list.
• cups_class_list: Список хешей, содержащих информацию о классах, необходимую для их установки. Пожалуйста, проверьте модуль cups_lpadmin и как используется переменная cups_class_list.
• cups_purge_all_printers_and_classes: Должен ли модуль cups_lpadmin удалить все принтеры перед продолжением.
• cups_printers_and_classes_to_be_removed: Принтеры и классы, которые вы хотели бы удалить.

Переменные, связанные с работой роли и общей настройкой CUPS:

• cups_packages_to_install: Пакеты CUPS для установки. Это можно переопределить для конкретной версии пакета, если это необходимо - По умолчанию=cups, cups-pdf.
• cups_xinetd_location: Местоположение xinet.d файлов - По умолчанию=/etc/xinetd.d.
• cups_tmp_location: Временное местоположение, которое эта роль использует для копирования файлов и выполнения скриптов. Местоположение будет создано, если его не существует - По умолчанию=/tmp/cups-ansible.
• cups_admin_grp: Группа, имеющая административный доступ к CUPS. Она используется при добавлении пользователей (если определены) в административные роли CUPS - По умолчанию=lpadmin.
• cups_services: Сервис(ы) CUPS, которые используются при запуске и остановке CUPS для целей конфигурации - По умолчанию=cups.
• cups_etc_location: Местоположение конфигурации CUPS - По умолчанию=/etc/cups.
• cups_etc_files_perms_owner: Владелец файлов, размещаемых этой ролью в cups_etc_location - По умолчанию=root.
• cups_etc_files_perms_grp: Членство группы файлов, размещаемых этой ролью в cups_etc_location - По умолчанию=lp.
• cups_etc_files_mode: Режим файлов, размещаемых этой ролью в cups_etc_location - По умолчанию=0644.
• cups_expect_pkgs: Пакеты, связанные с expect, которые устанавливаются для невидимых установок различных сценариев expect в этой роли - По умолчанию=expect, python-pexpect.
• cups_ppd_shared_location: Стандартное общее местоположение, где могут быть размещены PPD, и CUPS их подберет - По умолчанию=/opt/share/ppd.
• cups_ricoh_ppd_location: Местоположение, где установлены PPD Ricoh от OpenPrinting - По умолчанию=/opt/OpenPrinting-Ricoh/ppds/Ricoh.