Rola Ansible: cups

Instalacja CUPS, niezbędnych PPD i drukarek oraz klas w CUPS

Instalacja i konfiguracja CUPS

• Instalacja cups i cups-pdf
• Użytkownicy określeni w cups_lpadmin_users zostaną dodani do grupy lpadmin, aby zarządzać CUPS.
• Instalacja cups-lpd, jeśli zmienne na to pozwalają (patrz poniżej):
  • Tworzy konto użytkownika, które będzie uruchamiać proces cups-lpd.
  • Instalacja xinetd, aby uruchomić cups-lpd jako usługę. Używa szablonu pliku cups-lpd do stworzenia finalnej konfiguracji xinetd.
• Konfiguracja CUPS:
  • Jeśli dostarczone są szablony dla cupsd.conf, cups-browsed.conf i snmp.conf, zostaną zbudowane i skopiowane
  • Jeśli dostarczone są certyfikaty SSL, zostaną skopiowane do odpowiedniej lokalizacji.

Instalacja PPD

• Tworzy /opt/share/ppd, gdzie CUPS szuka PPD, które są ręcznie kopiowane.
• Dodaje repozytorium OpenPrinting.
• Instalacja pakietu Ricoh OpenPrinting - openprinting-ppds-postscript-ricoh
  • Również rozpakowuje PPD, które instaluje, ponieważ pakiet instaluje je jako pliki gzip w /opt/OpenPrinting-Ricoh/ppds/Ricoh
• Instalacja HPLIP:
  • Również instaluje własny plugin HP za pomocą skryptu except.
• Kopiuje PPD z folderu, jeśli określono w cups_ppd_files_to_be_copied, do /opt/share/ppd

Instalacja drukarek

• Wszystkie drukarki, które mają zostać usunięte, zostaną najpierw usunięte.
• Instalacja drukarek wymienionych w zmiennej cups_printer_list, a następnie klas wymienionych w cups_class_list
  • Zobacz cups_printer_list i cups_class_list, aby zobaczyć, jak zdefiniować każdą drukarkę i obiekt klasy w zmiennych cups_printer_list i cups_class_list.
  • Używa modułu cups_lpadmin. Wewnątrz niego znajdziesz dokumentację/komentarze dotyczące jego użycia.
  • cups_lpadmin jest bezpośrednią kopią z HP41.ansible-modules-extra/system/cups_lpadmin. Gdy zostanie scalony z repozytorium głównym, zostanie usunięty stąd.

Wymagania

• Ansible >= 2.1
• Maszyna goszcząca: Debian
  • stretch
  • jessie
  • wheezy
• Maszyna goszcząca: Ubuntu
  • xenial
  • trusty
  • precise

Możliwe dodatkowe zadania, które nie są częścią odpowiedzialności tej roli.

• Otwieranie niezbędnych portów CUPS - 515(LPR), 631(IPP/IPPS), 9100 (bezpośredni IP) przez zaporę.
  • Jeśli chcesz użyć debops.ferm, możesz użyć/modyfikować cups__debops_ferm_dependent_rules (zdefiniowane w domyślnych), aby przekazać do debops.ferm.

Domyślne zmienne, które można nadpisać lub użyć bez zmian podczas korzystania z tej roli:

Instalacja i konfiguracja CUPS:

• cups_lpadmin_users: Lista użytkowników, którzy muszą zostać dodani do grupy administracyjnej CUPS (lpadmin). Domyślnie=root
• cups_lpd: Czy zainstalować i skonfigurować cups-lpd - Domyślnie=True
• cups_sysadmins_email: E-mail, który zostanie użyty do budowy szablonu cupsd.conf - Domyślnie=sysadmins@ansible_fqdn
• cups__debops_ferm_dependent_rules: Domyślne proste zasady otwierania portów (515, 631, 9100) przez zaporę, które mogą być używane z rolą debops.ferm.
• /etc/xinetd.d/cups-lpd
  • cups_lpd_usn: Nazwa użytkownika, pod którą będzie uruchomiony proces cups-lpd (przez xinetd) - Domyślnie=cupslpd
• Opcjonalne szablony:
  • Mogły być ustawione jako prosta kopia pliku, ale dostęp i dodawanie zmiennych ansible do nich nie będzie możliwe. Dzięki temu ansible_managed, ansible_fqdn itp. będą dostępne. Szablony mogą również być prostymi plikami tekstowymi bez deklaracji zmiennych i zostaną skopiowane.
  • cups_cupsd_conf_template: Dla /etc/cups/cupsd.conf
  • cups_cups_browsed_conf_template: Dla /etc/cups/cups-browsed.conf
  • cups_snmp_conf_template: Dla /etc/cups/snmp.conf

Instalacja i kopiowanie PPD:

• cups_ppd_files_to_be_copied: Folder do skopiowania wszystkich plików .ppd - Domyślnie=None
• cups_hplip: Czy zainstalować HPLIP - Domyślnie=True
• cups_ricoh_openprinting: Czy zainstalować sterowniki/PPD OpenPrinting-Ricoh - Domyślnie=True
• cups_openprinting_apt_required: Jest określona jako warunek trójwartościowy. Kontroluje, czy klucz APT i repozytorium OpenPrinting są dodawane w zależności od tego, czy instalowane są sterowniki Ricoh czy nie. Można to łatwo nadpisać.
• cups_openprinting_apt_key_id: Identyfikator klucza APT do uzyskania z serwera kluczy poniżej. Domyślnie=24CBF5474CFD1E2F
• cups_openprinting_key_server: Serwer kluczy do uzyskania klucza dla poniższego repozytorium - Domyślnie=keyserver.ubuntu.com
• cups_openprinting_repo: Repozytorium OpenPrinting do dodania - Domyślnie="deb http://www.openprinting.org/download/printdriver/debian/ lsb3.2 main"

Instalacja drukarek i klas:

• cups_printer_uri_prefix: Prefiks URI dla wszelkich filtrów na górze URI - Domyślnie=""
• cups_printer_report_ipp_supplies: Gdy obiekt drukarki nie ma atrybutu report_ipp_supply_levels, używana jest ta wartość - Domyślnie=True
• cups_printer_report_snmp_supplies: Gdy obiekt drukarki nie ma atrybutu report_snmp_supply_levels, używana jest ta wartość. - Domyślnie=True
• cups_printer_is_shared: Gdy obiekt drukarki nie ma atrybutu shared, używana jest ta wartość - Domyślnie=True
• cups_class_is_shared: Gdy obiekt klasy nie ma atrybutu shared, używana jest ta wartość - Domyślnie=True
• cups_printer_list: Lista hashy zawierających informacje o drukarkach potrzebne do ich zainstalowania. Proszę sprawdzić moduł cups_lpadmin i jak używana jest zmienna cups_printer_list.
• cups_class_list: Lista hashy zawierających informacje o klasach potrzebne do ich zainstalowania. Proszę sprawdzić moduł cups_lpadmin i jak używana jest zmienna cups_class_list.
• cups_purge_all_printers_and_classes: Czy moduł cups_lpadmin ma usunąć/wszystkie drukarki przed kontynuowaniem.
• cups_printers_and_classes_to_be_removed: Drukarki i klasy, które chcesz usunąć.

Zmienne związane z działaniem roli i ogólną konfiguracją CUPS:

• cups_packages_to_install: Pakiety CUPS do zainstalowania. Można je nadpisać dla konkretnej wersji pakietu, jeśli zajdzie taka potrzeba - Domyślnie=cups, cups-pdf
• cups_xinetd_location: Lokalizacja plików xinet.d - Domyślnie=/etc/xinetd.d
• cups_tmp_location: Tymczasowa lokalizacja, której ta rola używa do kopiowania plików i uruchamiania skryptów. Lokalizacja jest tworzona, jeśli nie istnieje - Domyślnie=/tmp/cups-ansible
• cups_admin_grp: Grupa, która ma dostęp administracyjny do CUPS. Jest to odniesione przy dodawaniu użytkowników (jeśli zdefiniowani) do ról administracyjnych CUPS - Domyślnie=lpadmin
• cups_services: Usługi CUPS, które są odniesione przy uruchamianiu i zatrzymywaniu usług CUPS w celach konfiguracyjnych - Domyślnie=cups
• cups_etc_location: Lokalizacja etc konfiguracji CUPS - Domyślnie=/etc/cups
• cups_etc_files_perms_owner: Właściciel plików umieszczonych przez tę rolę w cups_etc_location - Domyślnie=root
• cups_etc_files_perms_grp: Przynależność grupowa plików umieszczonych przez tę rolę w cups_etc_location - Domyślnie=lp
• cups_etc_files_mode: Tryb plików umieszczonych przez tę rolę w cups_etc_location - Domyślnie=0644
• cups_expect_pkgs: Pakiety związane z expect, które są instalowane do nieprzerwanej instalacji różnych skryptów expect w tej roli - Domyślnie=expect, python-pexpect
• cups_ppd_shared_location: Standardowa lokalizacja, w której można umieszczać PPD, a CUPS je wykryje - Domyślnie=/opt/share/ppd
• cups_ricoh_ppd_location: Lokalizacja, w której są instalowane PPD Ricoh z OpenPrinting - Domyślnie=/opt/OpenPrinting-Ricoh/ppds/Ricoh