wkhtmltopdf

Rôle Ansible pour installer wkhtmltopdf.

Ce dépôt était un fork de AerisCloud/ansible-wkhtmltopdf, mais, actuellement, il a divergé de manière significative du travail original.

Tests

Famille	Distribution	Version	Statut du test
Debian	Debian	Jessie
Debian	Debian	Wheezy
Debian	Ubuntu	Yakkety
Debian	Ubuntu	Xenial
Debian	Ubuntu	Wily
Debian	Ubuntu	Trusty
Debian	Ubuntu	Precise

Exigences

• ansible >= 2.0

Variables de rôle

• debug: indicateur pour exécuter des tâches de débogage.
• wkhtmltopdf_dir_install: répertoire où les commandes wkhtmltox seront installées.
• wkhtmltopdf_installation: processus d'installation (package ou source).
• wkhtmltopdf_version: version à installer.
• wkhtmltopdf_mm_version: version majeure et mineure à installer (pas besoin de définir).
• wkhtmltopdf_user: compte utilisé pour construire le logiciel.

build

Variables utilisées dans le processus d'installation build.

• wkhtmltopdf_architecture: architecture (i386 ou amd64).
• wkhtmltopdf_build: méthode pour télécharger le logiciel (tarball, git).
• wkhtmltopdf_build_args: argument à passer à build.py pour construire le logiciel.
• wkhtmltopdf_chroot_args: argument à passer à build.py pour configurer l'environnement chroot.
• wkhtmltopdf_default_version: indicateur pour indiquer si cette version est la version par défaut.
• wkhtmltopdf_dir_chroot: répertoire pour configurer l'environnement chroot.
• wkhtmltopdf_dir_source: répertoire où stocker le tarball source.
• wkhtmltopdf_dir_source_version: répertoire où extraire le tarball ou cloner le dépôt git.
• wkhtmltopdf_force_build: compiler le logiciel.
• wkhtmltopdf_runtime_dependencies: liste des paquets nécessaires pour exécuter le logiciel.
• wkhtmltopdf_tarball_download_url: URL pour télécharger le tarball.
• wkhtmltopdf_slug: slug du dépôt git à cloner.
• wkhtmltopdf_tarball: nom de base du tarball.

package

• wkhtmltopdf_package_download_url: URL pour télécharger le paquet debian.

Dépendances

• ansiblebit/git si vous souhaitez installer en utilisant wkhtmltopdf_installation=source et wkhtmltopdf_build=git.

Playbooks

package

Cette option est disponible uniquement pour les versions 0.12.1 et 0.12.2 sur :

• ubuntu/trusty
• ubuntu/precise
• debian/wheezy

- hosts: servers
  vars:
    wkhtmltopdf_installation: package
    wkhtmltopdf_version: 0.12.1

  roles:
     - role: ansiblebit.wkhtmltopdf

source

Vous pouvez construire à partir des sources en utilisant un tarball ou git.

Pour tarball :

- hosts: servers
  vars:
    wkhtmltopdf_build: tarball
    wkhtmltopdf_installation: source

  roles:
     - role: ansiblebit.wkhtmltopdf

Pour git :

- hosts: servers
  vars:
    git_version: 2.11.0

    wkhtmltopdf_build: git
    wkhtmltopdf_installation: source

  roles:
    - role: ansiblebit.git
    - role: ansiblebit.wkhtmltopdf

Étiquettes

• configuration: tâches de configuration.
• build: tâches de construction.
• debug: tâche pour déboguer les variables de rôle.
• validation: tâche pour valider les variables de rôle.

Test

Pour exécuter les tests, vous devez installer :

• tox
• vagrant

Pour exécuter tous les tests contre tous les systèmes d'exploitation/distributions et versions d'ansible pré-décidées :

$ tox

Pour exécuter des tests pour trusty64 :

$ cd tests
$ bash test_idempotence.sh --box trusty64.vagrant.dev
# le fichier journal sera enregistré dans tests/log

Pour effectuer un débogage dans un environnement spécifique :

$ cd tests
$ vagrant up trusty64.vagrant.dev

# pour provisioning en utilisant le playbook test.yml (autant de fois que nécessaire)
$ vagrant provision trusty64.vagrant.dev

# pour accéder à la boîte Vagrant
$ vagrant ssh trusty64.vagrant.dev

Liens

• wkhtmltopdf
• AerisCloud/ansible-wkhtmltopdf