wkhtmltopdf

Rol de Ansible para instalar wkhtmltopdf.

Este repositorio es un fork de AerisCloud/ansible-wkhtmltopdf, pero actualmente se ha desviado significativamente del trabajo original.

Pruebas

Familia	Distribución	Versión	Estado de la Prueba
Debian	Debian	Jessie
Debian	Debian	Wheezy
Debian	Ubuntu	Yakkety
Debian	Ubuntu	Xenial
Debian	Ubuntu	Wily
Debian	Ubuntu	Trusty
Debian	Ubuntu	Precise

Requisitos

• ansible >= 2.0

Variables del Rol

• debug: indicador para ejecutar tareas de depuración.
• wkhtmltopdf_dir_install: directorio donde se instalarán los comandos de wkhtmltox.
• wkhtmltopdf_installation: proceso de instalación (package o source).
• wkhtmltopdf_version: versión que se instalará.
• wkhtmltopdf_mm_version: versión mayor y menor que se instalará (no es necesario definirla).
• wkhtmltopdf_user: cuenta utilizada para compilar el software.

construcción

Variables utilizadas en el proceso de instalación build.

• wkhtmltopdf_architecture: arquitectura (i386 o amd64).
• wkhtmltopdf_build: método para descargar el software (tarball, git).
• wkhtmltopdf_build_args: argumentos que se pasarán a build.py para compilar el software.
• wkhtmltopdf_chroot_args: argumentos que se pasarán a build.py para configurar el entorno chroot.
• wkhtmltopdf_default_version: indicador para indicar si esta versión es la predeterminada.
• wkhtmltopdf_dir_chroot: directorio para configurar el entorno chroot.
• wkhtmltopdf_dir_source: directorio donde almacenar el tarball de origen.
• wkhtmltopdf_dir_source_version: directorio donde extraer el tarball o clonar el repositorio git.
• wkhtmltopdf_force_build: compilar el software.
• wkhtmltopdf_runtime_dependencies: lista de paquetes necesarios para ejecutar el software.
• wkhtmltopdf_tarball_download_url: URL para descargar el tarball.
• wkhtmltopdf_slug: slug del repositorio git que se va a clonar.
• wkhtmltopdf_tarball: nombre base del tarball.

paquete

• wkhtmltopdf_package_download_url: URL para descargar el paquete de debian.

Dependencias

• ansiblebit/git si quieres instalar usando wkhtmltopdf_installation=source y wkhtmltopdf_build=git.

Playbooks

paquete

Esta opción solo está disponible para las versiones 0.12.1 y 0.12.2 en:

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

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

  roles:
     - role: ansiblebit.wkhtmltopdf

fuente

Puedes construir desde el origen usando un tarball o git.

Para tarball:

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

  roles:
     - role: ansiblebit.wkhtmltopdf

Para git:

- hosts: servers
  vars:
    git_version: 2.11.0

    wkhtmltopdf_build: git
    wkhtmltopdf_installation: source

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

Etiquetas

• configuración: tareas de configuración.
• construcción: tareas de construcción.
• depuración: tareas para depurar variables del rol.
• validación: tareas para validar variables del rol.

Prueba

Para ejecutar las pruebas necesitarás instalar:

• tox
• vagrant

Para ejecutar todas las pruebas contra todos los sistemas operativos/distribuciones y versiones de ansible predefinidos:

$ tox

Para ejecutar pruebas para trusty64:

$ cd tests
$ bash test_idempotence.sh --box trusty64.vagrant.dev
# el archivo de registro se almacenará en tests/log

Para realizar depuración en un entorno específico:

$ cd tests
$ vagrant up trusty64.vagrant.dev

# para provisionar usando el playbook test.yml (tantas veces como necesites)
$ vagrant provision trusty64.vagrant.dev

# para acceder a la caja de Vagrant
$ vagrant ssh trusty64.vagrant.dev

Enlaces

• wkhtmltopdf
• AerisCloud/ansible-wkhtmltopdf