wkhtmltopdf

Rola Ansible do instalacji wkhtmltopdf.

Ten repozytorium jest forkiem AerisCloud/ansible-wkhtmltopdf, ale obecnie znacznie odbiega od oryginalnej pracy.

Testy

Rodzina	Dystrybucja	Wersja	Status Testu
Debian	Debian	Jessie
Debian	Debian	Wheezy
Debian	Ubuntu	Yakkety
Debian	Ubuntu	Xenial
Debian	Ubuntu	Wily
Debian	Ubuntu	Trusty
Debian	Ubuntu	Precise

Wymagania

• ansible >= 2.0

Zmienne Roli

• debug: flaga do uruchamiania zadań debugowania.
• wkhtmltopdf_dir_install: katalog, w którym będą zainstalowane polecenia wkhtmltox.
• wkhtmltopdf_installation: proces instalacji (package lub source).
• wkhtmltopdf_version: wersja do zainstalowania.
• wkhtmltopdf_mm_version: główna i mniejsza wersja do zainstalowania (nie trzeba definiować).
• wkhtmltopdf_user: konto używane do budowy oprogramowania.

budowa

Zmienne używane w procesie instalacji build.

• wkhtmltopdf_architecture: architektura (i386 lub amd64).
• wkhtmltopdf_build: metoda pobierania oprogramowania (tarball, git).
• wkhtmltopdf_build_args: argument do przekazania do build.py w celu budowy oprogramowania.
• wkhtmltopdf_chroot_args: argument do przekazania do build.py w celu skonfigurowania środowiska chroot.
• wkhtmltopdf_default_version: flaga wskazująca, czy ta wersja jest domyślna.
• wkhtmltopdf_dir_chroot: katalog do konfiguracji środowiska chroot.
• wkhtmltopdf_dir_source: katalog, w którym należy przechować źródło tarball.
• wkhtmltopdf_dir_source_version: katalog, w którym należy rozpakować tarball lub sklonować repozytorium git.
• wkhtmltopdf_force_build: kompilacja oprogramowania.
• wkhtmltopdf_runtime_dependencies: lista pakietów potrzebnych do uruchomienia oprogramowania.
• wkhtmltopdf_tarball_download_url: URL do pobrania tarball.
• wkhtmltopdf_slug: skrót repozytorium git do sklonowania.
• wkhtmltopdf_tarball: nazwa bazowa tarball.

pakiet

• wkhtmltopdf_package_download_url: URL do pobrania pakietu debian.

Zależności

• ansiblebit/git, jeśli chcesz zainstalować używając wkhtmltopdf_installation=source i wkhtmltopdf_build=git.

Playbooki

pakiet

Ta opcja jest dostępna tylko dla wersji 0.12.1 i 0.12.2 dla:

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

- hosts: serwery
  vars:
    wkhtmltopdf_installation: pakiet
    wkhtmltopdf_version: 0.12.1

  roles:
     - rola: ansiblebit.wkhtmltopdf

źródło

Możesz zbudować z źródła używając tarball lub git.

Dla tarball:

- hosts: serwery
  vars:
    wkhtmltopdf_build: tarball
    wkhtmltopdf_installation: source
    
  roles:
     - rola: ansiblebit.wkhtmltopdf

Dla git:

- hosts: serwery
  vars:
    git_version: 2.11.0

    wkhtmltopdf_build: git
    wkhtmltopdf_installation: source
    
  roles:
    - rola: ansiblebit.git
    - rola: ansiblebit.wkhtmltopdf

Tagi

• konfiguracja: zadania konfiguracyjne.
• budowa: zadania budowy.
• debug: zadanie do debugowania zmiennych roli.
• walidacja: zadanie do walidacji zmiennych roli.

Test

Aby uruchomić testy, musisz zainstalować:

• tox
• vagrant

Aby uruchomić wszystkie testy dla wszystkich zdefiniowanych OS/dystrybucji i wersji Ansible:

$ tox

Aby uruchomić testy dla trusty64:

$ cd tests
$ bash test_idempotence.sh --box trusty64.vagrant.dev
# plik logów zostanie zapisany w tests/log

Aby przeprowadzić debugowanie w konkretnym środowisku:

$ cd tests
$ vagrant up trusty64.vagrant.dev

# aby zrealizować z wykorzystaniem playbooka test.yml (dowolną ilość razy)
$ vagrant provision trusty64.vagrant.dev

# aby uzyskać dostęp do Vagrant box
$ vagrant ssh trusty64.vagrant.dev

Linki

• wkhtmltopdf
• AerisCloud/ansible-wkhtmltopdf