Rôle Ansible : cups

Installe CUPS, installes les PPD nécessaires et configure les imprimantes et classes sur CUPS

Installer et configurer CUPS

• Installe cups et cups-pdf
• Les comptes définis dans cups_lpadmin_users seront ajoutés au groupe lpadmin pour administrer CUPS.
• Installe cups-lpd si les variables le permettent (voir ci-dessous) :
  • Crée un compte utilisateur qui exécutera le processus cups-lpd.
  • Installe xinetd pour faire fonctionner cups-lpd comme un service. Utilise le fichier modèle de cups-lpd pour créer la configuration finale de xinetd.
• Configuration de CUPS :
  • Si des modèles pour cupsd.conf, cups-browsed.conf et snmp.conf sont fournis, ils seront construits et copiés.
  • Si des certificats SSL sont fournis, ils seront copiés au bon endroit.

Installer les PPD

• Crée /opt/share/ppd où CUPS recherche les PPD qui sont copiés manuellement.
• Ajoute le dépôt OpenPrinting.
• Installe le paquet OpenPrinting Ricoh - openprinting-ppds-postscript-ricoh
  • Décompresse aussi les PPD qu'il installe, car le paquet les installe sous forme de fichiers gzip dans /opt/OpenPrinting-Ricoh/ppds/Ricoh
• Installe HPLIP :
  • Installe également le plugin propriétaire HP à l'aide d'un script d'exception.
• Copie les PPD du dossier spécifié dans cups_ppd_files_to_be_copied vers /opt/share/ppd

Installer les imprimantes

• Toutes les imprimantes définies pour être supprimées le seront en premier.
• Installe les imprimantes listées dans la variable cups_printer_list puis installe les classes listées dans cups_class_list
  • Voir cups_printer_list et cups_class_list pour savoir comment définir chaque imprimante et objet de classe dans les variables cups_printer_list et cups_class_list.
  • Cela utilise le module cups_lpadmin. Il y a une documentation/commentaire à l'intérieur sur la façon dont il peut être utilisé.
  • cups_lpadmin est une copie directe de HP41.ansible-modules-extra/system/cups_lpadmin. Une fois fusionné en amont, il sera supprimé d'ici.

Exigences

• Ansible >= 2.1
• Machine invitée : Debian
  • stretch
  • jessie
  • wheezy
• Machine invitée : Ubuntu
  • xenial
  • trusty
  • precise

Tâches supplémentaires possibles qui ne font pas partie des responsabilités de ce rôle.

• Ouvrir les ports nécessaires de CUPS - 515 (LPR), 631 (IPP/IPPS), 9100 (IP direct) à travers le pare-feu.
  • Si vous souhaitez utiliser debops.ferm, vous pouvez utiliser/modifier cups__debops_ferm_dependent_rules (défini dans les valeurs par défaut) pour passer à debops.ferm.

Variables par défaut qui peuvent être remplacées ou utilisées telles quelles lors de l'utilisation de ce rôle :

Installation et configuration de CUPS :

• cups_lpadmin_users : Liste des utilisateurs devant être ajoutés au groupe administratif CUPS (lpadmin). Par défaut = root
• cups_lpd : S'il faut installer et configurer cups-lpd - Par défaut = True
• cups_sysadmins_email : L'email qui sera utilisé pour construire le modèle cupsd.conf - Par défaut = sysadmins@ansible_fqdn
• cups__debops_ferm_dependent_rules : Règles simples par défaut pour ouvrir les ports (515, 631, 9100) à travers le pare-feu, qui peuvent être référencées lors de l'utilisation du rôle debops.ferm.
• /etc/xinetd.d/cups-lpd
  • cups_lpd_usn : Le nom d'utilisateur avec lequel le processus cups-lpd (via xinetd) sera exécuté - Par défaut = cupslpd
• Modèles optionnels :
  • Ils auraient pu être configurés comme une simple copie de fichier, mais accéder et ajouter des variables ansible ne sera pas possible. Avec ansible_managed, ansible_fqdn, etc. sont accessibles. Les modèles peuvent également être de simples fichiers texte sans déclaration de variable et seront copiés.
  • cups_cupsd_conf_template : Pour /etc/cups/cupsd.conf
  • cups_cups_browsed_conf_template : Pour /etc/cups/cups-browsed.conf
  • cups_snmp_conf_template : Pour /etc/cups/snmp.conf

Installation et copie des PPD :

• cups_ppd_files_to_be_copied : Le dossier à partir duquel copier tous les fichiers .ppd - Par défaut = None
• cups_hplip : Faut-il installer HPLIP - Par défaut = True
• cups_ricoh_openprinting : Faut-il installer les pilotes/PPD OpenPrinting-Ricoh ? - Par défaut = True
• cups_openprinting_apt_required : Décrit comme ternaire. Il contrôle si la clé APT et le dépôt OpenPrinting sont ajoutés selon que les pilotes Ricoh sont installés ou non. Il peut être facilement remplacé par votre valeur.
• cups_openprinting_apt_key_id : L'ID de la clé APT à obtenir du serveur de clés ci-dessous. Par défaut = 24CBF5474CFD1E2F
• cups_openprinting_key_server : Le serveur de clés pour acquérir la clé pour le dépôt ci-dessous - Par défaut = keyserver.ubuntu.com
• cups_openprinting_repo : Le dépôt OpenPrinting à ajouter - Par défaut = "deb http://www.openprinting.org/download/printdriver/debian/ lsb3.2 main"

Installation des imprimantes et classes :

• cups_printer_uri_prefix : Un préfixe URI pour tout filtre au-dessus de l'URI - Par défaut = ""
• cups_printer_report_ipp_supplies : Lorsque l'objet imprimante n'a pas l'attribut report_ipp_supply_levels, cette valeur est utilisée - Par défaut = True
• cups_printer_report_snmp_supplies : Lorsque l'objet imprimante n'a pas l'attribut report_snmp_supply_levels, cette valeur est utilisée. - Par défaut = True
• cups_printer_is_shared : Lorsque l'objet imprimante n'a pas d'attribut shared, cette valeur est utilisée - Par défaut = True
• cups_class_is_shared : Lorsque l'objet classe n'a pas d'attribut shared, cette valeur est utilisée - Par défaut = True
• cups_printer_list : Une liste de hachages contenant les informations d'imprimante nécessaires pour les installer. Merci de consulter le module cups_lpadmin et comment la variable cups_printer_list est utilisée.
• cups_class_list : Une liste de hachages contenant les informations de classe nécessaires pour les installer. Merci de consulter le module cups_lpadmin et comment la variable cups_class_list est utilisée.
• cups_purge_all_printers_and_classes : Faut-il que le module cups_lpadmin purge/supprime toutes les imprimantes avant de continuer.
• cups_printers_and_classes_to_be_removed : Imprimantes et classes que vous souhaitez spécifiquement supprimer.

Variables liées à l'opération du rôle et à la configuration générale de CUPS :

• cups_packages_to_install : Les paquets CUPS à installer. Cela peut être remplacé pour une version de paquet spécifique si nécessaire - Par défaut = cups, cups-pdf
• cups_xinetd_location : L'emplacement des fichiers xinet.d - Par défaut = /etc/xinetd.d
• cups_tmp_location : Emplacement temporaire utilisé par ce rôle pour copier des fichiers et exécuter des scripts. L'emplacement est créé s'il n'existe pas - Par défaut = /tmp/cups-ansible
• cups_admin_grp : Le groupe ayant accès à l'administration de CUPS. Ceci est référencé lors de l'ajout d'utilisateurs (si défini) aux rôles administratifs de CUPS - Par défaut = lpadmin
• cups_services : Le(s) service(s) CUPS qui sont référencés lors du démarrage et de l'arrêt des services CUPS pour les besoins de configuration - Par défaut = cups
• cups_etc_location : Emplacement etc de la configuration de CUPS - Par défaut = /etc/cups
• cups_etc_files_perms_owner : Propriétaire des fichiers placés par ce rôle sous cups_etc_location - Par défaut = root
• cups_etc_files_perms_grp : Appartenance à un groupe des fichiers placés par ce rôle sous cups_etc_location - Par défaut = lp
• cups_etc_files_mode : Mode des fichiers placés par ce rôle sous cups_etc_location - Par défaut = 0644
• cups_expect_pkgs : Paquets liés à expect installés pour les installations non surveillées de différents scripts expect dans ce rôle - Par défaut = expect, python-pexpect
• cups_ppd_shared_location : L'emplacement partagé standard où les PPD peuvent être placés et que CUPS prendra en compte - Par défaut = /opt/share/ppd
• cups_ricoh_ppd_location : L'emplacement où les PPD Ricoh d'OpenPrinting sont installés - Par défaut = /opt/OpenPrinting-Ricoh/ppds/Ricoh