wkhtmltopdf

Роль Ansible для установки wkhtmltopdf.

Этот репозиторий является форком AerisCloud/ansible-wkhtmltopdf, но в настоящее время он значительно изменился по сравнению с оригинальной работой.

Тесты

Семейство	Дистрибутив	Версия
Debian	Debian	Jessie
Debian	Debian	Wheezy
Debian	Ubuntu	Yakkety
Debian	Ubuntu	Xenial
Debian	Ubuntu	Wily
Debian	Ubuntu	Trusty
Debian	Ubuntu	Precise

Требования

ansible >= 2.0

Переменные роли

debug: флаг для выполнения отладочных задач.
wkhtmltopdf_dir_install: директория, в которой будут установлены команды wkhtmltox.
wkhtmltopdf_installation: процесс установки (package или source).
wkhtmltopdf_version: версия для установки.
wkhtmltopdf_mm_version: мажорная и минорная версия для установки (не нужно определять).
wkhtmltopdf_user: аккаунт, используемый для сборки программного обеспечения.

сборка

Переменные, используемые в процессе установки build.

wkhtmltopdf_architecture: архитектура (i386 или amd64).
wkhtmltopdf_build: метод загрузки программного обеспечения (tarball, git).
wkhtmltopdf_build_args: аргумент, который будет передан в build.py для сборки ПО.
wkhtmltopdf_chroot_args: аргумент, который будет передан в build.py для настройки chroot среды.
wkhtmltopdf_default_version: флаг, указывающий, является ли эта версия основной.
wkhtmltopdf_dir_chroot: директория для настройки chroot среды.
wkhtmltopdf_dir_source: директория, где будет храниться исходный tarball.
wkhtmltopdf_dir_source_version: директория, где будет извлечен tarball или клонирован git репозиторий.
wkhtmltopdf_force_build: компиляция ПО.
wkhtmltopdf_runtime_dependencies: список пакетов, необходимых для работы программного обеспечения.
wkhtmltopdf_tarball_download_url: URL для загрузки tarball.
wkhtmltopdf_slug: slug git репозитория для клонирования.
wkhtmltopdf_tarball: базовое имя tarball.

пакет

wkhtmltopdf_package_download_url: URL для загрузки debian пакета.

Зависимости

ansiblebit/git, если вы хотите установить с помощью wkhtmltopdf_installation=source и wkhtmltopdf_build=git.

Плейбуки

пакет

Эта опция доступна только для версий 0.12.1 и 0.12.2 на:

ubuntu/trusty
ubuntu/precise
debian/wheezy

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

  roles:
     - role: ansiblebit.wkhtmltopdf

исходный код

Вы можете собрать из исходного кода, используя tarball или git.

Для tarball:

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

  roles:
     - role: ansiblebit.wkhtmltopdf

Для git:

- hosts: servers
  vars:
    git_version: 2.11.0

    wkhtmltopdf_build: git
    wkhtmltopdf_installation: source

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

Тест

Чтобы запустить тесты, вам необходимо установить:

tox
vagrant

Чтобы запустить все тесты для всех предопределенных ОС/дистрибутивов * версий ansible:

$ tox

Чтобы запустить тесты для trusty64:

$ cd tests
$ bash test_idempotence.sh --box trusty64.vagrant.dev
# файл журнала будет сохранен в tests/log

Чтобы выполнить отладку в определенной среде:

$ cd tests
$ vagrant up trusty64.vagrant.dev

# для приведения в порядок с использованием плейбука test.yml (столько раз, сколько нужно)
$ vagrant provision trusty64.vagrant.dev

# для доступа к Vagrant box
$ vagrant ssh trusty64.vagrant.dev