wkhtmltopdf

Ansible Rolle zur Installation von wkhtmltopdf.

Dieses Repository war ein Fork von AerisCloud/ansible-wkhtmltopdf, hat sich jedoch mittlerweile stark vom Original entwickelt.

Tests

Familie	Distribution	Version	Teststatus
Debian	Debian	Jessie
Debian	Debian	Wheezy
Debian	Ubuntu	Yakkety
Debian	Ubuntu	Xenial
Debian	Ubuntu	Wily
Debian	Ubuntu	Trusty
Debian	Ubuntu	Precise

Anforderungen

• ansible >= 2.0

Rollenvariablen

• debug: Flag, um Debug-Tasks auszuführen.
• wkhtmltopdf_dir_install: Verzeichnis, in dem die wkhtmltox-Befehle installiert werden.
• wkhtmltopdf_installation: Installationsprozess (package oder source).
• wkhtmltopdf_version: zu installierende Version.
• wkhtmltopdf_mm_version: Haupt- und Nebenversion, die installiert werden soll (muss nicht definiert werden).
• wkhtmltopdf_user: Benutzerkonto zum Erstellen der Software.

Build

Variablen, die im build Installationsprozess verwendet werden.

• wkhtmltopdf_architecture: Architektur (i386 oder amd64).
• wkhtmltopdf_build: Methode zum Herunterladen der Software (tarball, git).
• wkhtmltopdf_build_args: Argumente, die an build.py übergeben werden, um die Software zu erstellen.
• wkhtmltopdf_chroot_args: Argumente, die an build.py übergeben werden, um die Chroot-Umgebung einzurichten.
• wkhtmltopdf_default_version: Flag, um anzuzeigen, ob diese Version die Standardversion ist.
• wkhtmltopdf_dir_chroot: Verzeichnis zum Einrichten der Chroot-Umgebung.
• wkhtmltopdf_dir_source: Verzeichnis, in dem das Quell-Tarball gespeichert wird.
• wkhtmltopdf_dir_source_version: Verzeichnis, in dem das Tarball extrahiert oder das Git-Repository geklont wird.
• wkhtmltopdf_force_build: Software kompilieren.
• wkhtmltopdf_runtime_dependencies: Liste der Pakete, die zum Ausführen der Software benötigt werden.
• wkhtmltopdf_tarball_download_url: URL zum Herunterladen des Tarballs.
• wkhtmltopdf_slug: Git-Repository-Slug, das geklont werden soll.
• wkhtmltopdf_tarball: Basename des Tarballs.

Paket

• wkhtmltopdf_package_download_url: URL zum Herunterladen des Debian-Pakets.

Abhängigkeiten

• ansiblebit/git, wenn Sie mit wkhtmltopdf_installation=source und wkhtmltopdf_build=git installieren möchten.

Playbooks

Paket

Diese Option ist nur für die Versionen 0.12.1 und 0.12.2 auf:

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

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

  roles:
     - role: ansiblebit.wkhtmltopdf

Quelle

Sie können aus der Quelle bauen, indem Sie ein tarball oder git verwenden.

Für tarball:

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

  roles:
     - role: ansiblebit.wkhtmltopdf

Für git:

- hosts: servers
  vars:
    git_version: 2.11.0

    wkhtmltopdf_build: git
    wkhtmltopdf_installation: source

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

Tags

• konfiguration: Konfigurationsaufgaben.
• build: Build-Aufgaben.
• debug: Aufgabe zum Debuggen von Rollenvariablen.
• validierung: Aufgabe zur Validierung von Rollenvariablen.

Test

Um die Tests auszuführen, müssen Sie installieren:

• tox
• vagrant

Um alle Tests gegen alle vordefinierten Betriebssysteme/Distributionen * ansible-Versionen auszuführen:

$ tox

Um Tests für trusty64 auszuführen:

$ cd tests
$ bash test_idempotence.sh --box trusty64.vagrant.dev
# Protokolldatei wird unter tests/log gespeichert

Um ein spezifisches Umfeld zu debuggen:

$ cd tests
$ vagrant up trusty64.vagrant.dev

# um mithilfe des test.yml-Playbooks (so oft wie nötig) bereitzustellen
$ vagrant provision trusty64.vagrant.dev

# um auf die Vagrant-Box zuzugreifen
$ vagrant ssh trusty64.vagrant.dev

Links

• wkhtmltopdf
• AerisCloud/ansible-wkhtmltopdf