概要¶
何かとやりとりする機会が多いPDF。これをチケット上でサムネイル表示させるプラグインをインストールします。
注意事項¶
本項で実施する作業は、ImageMagicの脆弱性対応の制限を外すものです。作業の際はセキュリティポリシーに鑑みてください。
プラグイン名¶
- Redmine_Preview_PDF
動作を確認した環境¶
Redmine 4.2
導入時¶
追加パッケージのインストール：要
設定ファイルの修正：要
Gem追加：要
DBマイグレーション：不要
実施した手順¶
さっくりとした手順¶
- SSHログイン後、追加パッケージをインストール
- 設定ファイルの書き換え
- Redmineプラグインに移動
- gitでレポジトリをダウンロード
- 新規ジェムをインストール
- Webサービス再起動
動作に必要な追加パッケージのインストールと設定¶
追加パッケージをインストールします。¶
sudo aptitude install libmagic-dev
パッケージの設定ファイルを修正します。¶
※こちらが上述した脆弱性対応の制限を外す設定です。
- ○バックアップ作成
sudo cp -pi /etc/ImageMagick-6/policy.xml /path/to/backup/directory/policy.xml.$(date +%Y%m%d)
# 任意のバックアップディレクトリを指定してください
diff -u /etc/ImageMagick-6/policy.xml /path/to/backup/directory/policy.xml.$(date +%Y%m%d)
# 差分が無いことでバックアップが取れていることを確認します。
- ○ファイル書き換え
sudo sed -i 's/rights="none" pattern="\(PS\|EPS\|PDF\|XPS\)"/rights="read|write" pattern="\1"/g' /etc/ImageMagick-6/policy.xml
- ○書き換え後の差分確認
diff -u /path/to/backup/directory/policy.xml.$(date +%Y%m%d) /etc/ImageMagick-6/policy.xml
# 保存したバックアップファイルを指定してください
- ●差分
<!-- in order to avoid to get image with password text -->
<policy domain="path" rights="none" pattern="@*"/>
<!-- disable ghostscript format types -->
- <policy domain="coder" rights="none" pattern="PS" />
+ <policy domain="coder" rights="read|write" pattern="PS" />
<policy domain="coder" rights="none" pattern="PS2" />
<policy domain="coder" rights="none" pattern="PS3" />
- <policy domain="coder" rights="none" pattern="EPS" />
- <policy domain="coder" rights="none" pattern="PDF" />
- <policy domain="coder" rights="none" pattern="XPS" />
+ <policy domain="coder" rights="read|write" pattern="EPS" />
+ <policy domain="coder" rights="read|write" pattern="PDF" />
+ <policy domain="coder" rights="read|write" pattern="XPS" />
プラグインのインストール¶
プラグイン格納ディレクトリに移動します。¶
cd /home/www-data/redmine/plugins
# 自分の環境に合わせます。
プラグインを配置します。¶
sudo -u www-data git clone https://github.com/nanego/redmine_preview_pdf
ls -ld redmine_preview_pdf
# このディレクトリがあることを確認します
Gemをインストールします¶
cd /home/www-data/redmine/
# 自分の環境に合わせます。
sudo -u www-data bundle install
Webサービスを再起動します。¶
sudo systemctl restart apache2
動作¶
- 任意のチケットでPDFを添付して保存します。
- 保存したチケットを開きます。
- PDFがサムネイル表示されること、それをクリックしてPDFの拡大ページに遷移すること。
が確認できれば作業は完了です。
