ansiblebit.wkhtmltopdf

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: chroot 環境を設定するために build.py に渡す引数。
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: tarball をダウンロードするための URL。
wkhtmltopdf_slug: クローンする git リポジトリのスラグ。
wkhtmltopdf_tarball: tarball のベース名。

パッケージ

wkhtmltopdf_package_download_url: Debian パッケージをダウンロードするための URL。

依存関係

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

すべての事前定義された OS/ディストリビューション * 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 ボックスにアクセスするには。
$ vagrant ssh trusty64.vagrant.dev