Pandocサーバーのコンテナイメージを作成する

2019/05/01

マークダウンからEPUBへの変換をAWS Batchで行いたく、ECRにアップロードするためにまずコンテナイメージを作成しました。
普段コンテナ使ってないので苦戦しながらやりましたが、ちょっと仲良くなれた気はします。

Pandocのコンテナイメージをローカルにダウンロードする

環境はMacです。

まず、ベースになるDockerイメージをDocker Hubで探しました。

pandoc で検索してMost Popularなのが jagregory/pandocでしたので、それをpullしました。

$ docker pull jagregory/pandoc
Using default tag: latest
latest: Pulling from jagregory/pandoc
~~~~~~
Status: Downloaded newer image for jagregory/pandoc:latest

$ docker pull jagregory/pandoc

Using default tag: latest

latest: Pulling from jagregory/pandoc

~~~~~~

Status: Downloaded newer image for jagregory/pandoc:latest

とりあえず動かして確認してみました。

$ docker run -d --name pserver jagregory/pandoc
$ docker ps -a
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS                      PORTS               NAMES
6a3b854cbec7        jagregory/pandoc    "/root/.cabal/bin/pa…"   16 seconds ago      Exited (0) 14 seconds ago

$ docker run -d --name pserver jagregory/pandoc

$ docker ps -a

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

6a3b854cbec7 jagregory/pandoc "/root/.cabal/bin/pa…" 16 seconds ago Exited (0) 14 seconds ago

runしてすぐにExitedになりました。
コンテナイメージのドキュメントを見ると使い方が書いてあって、ディレクトリを/sourceディレクトリにして、変換前のファイルと変換後のファイル名とフォーマットを指定して実行するらしい。

$ docker run -v `pwd`:/source jagregory/pandoc -f markdown -t html5 myfile.md -o myfile.html

1 2	$ docker run -v `pwd`:/source jagregory/pandoc -f markdown -t html5 myfile.md -o myfile.html

自分が欲しかったのはPandocが実行されているサーバー環境だったのでこれではないらしい。
Amazon LinuxのコンテナイメージにPandocをインストールすることにしました。

Amazon Linux コンテナイメージにPandocをインストールする

$ docker pull amazonlinux

1 2	$ docker pull amazonlinux

$ docker run -it amazonlinux /bin/bash
bash-4.2#

$ docker run -it amazonlinux /bin/bash

bash-4.2#

入れた〜

EPEL リポジトリの有効化はこちらを見ました。

CentOS、RHEL、または Amazon Linux が実行されている Amazon EC2 インスタンスに対して EPEL リポジトリを有効にする方法を教えてください。

# yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
# yum install -y pandoc
# pandoc -v
pandoc 1.12.3.1
Compiled with texmath 0.6.6, highlighting-kate 0.5.6.
Syntax highlighting is supported for the following languages:
    actionscript, ada, apache, asn1, asp, awk, bash, bibtex, boo, c, changelog,
    clojure, cmake, coffee, coldfusion, commonlisp, cpp, cs, css, curry, d,
    diff, djangotemplate, doxygen, doxygenlua, dtd, eiffel, email, erlang,
    fortran, fsharp, gnuassembler, go, haskell, haxe, html, ini, java, javadoc,
    javascript, json, jsp, julia, latex, lex, literatecurry, literatehaskell,
    lua, makefile, mandoc, markdown, matlab, maxima, metafont, mips, modelines,
    modula2, modula3, monobasic, nasm, noweb, objectivec, objectivecpp, ocaml,
    octave, pascal, perl, php, pike, postscript, prolog, python, r,
    relaxngcompact, restructuredtext, rhtml, roff, ruby, rust, scala, scheme,
    sci, sed, sgml, sql, sqlmysql, sqlpostgresql, tcl, texinfo, verilog, vhdl,
    xml, xorg, xslt, xul, yacc, yaml
Default user data directory: /root/.pandoc
Copyright (C) 2006-2013 John MacFarlane
Web:  http://johnmacfarlane.net/pandoc
This is free software; see the source for copying conditions.  There is no
warranty, not even for merchantability or fitness for a particular purpose.

# yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

# yum install -y pandoc

# pandoc -v

pandoc 1.12.3.1

Compiled with texmath 0.6.6, highlighting-kate 0.5.6.

Syntax highlighting is supported for the following languages:

actionscript, ada, apache, asn1, asp, awk, bash, bibtex, boo, c, changelog,

clojure, cmake, coffee, coldfusion, commonlisp, cpp, cs, css, curry, d,

diff, djangotemplate, doxygen, doxygenlua, dtd, eiffel, email, erlang,

fortran, fsharp, gnuassembler, go, haskell, haxe, html, ini, java, javadoc,

javascript, json, jsp, julia, latex, lex, literatecurry, literatehaskell,

lua, makefile, mandoc, markdown, matlab, maxima, metafont, mips, modelines,

modula2, modula3, monobasic, nasm, noweb, objectivec, objectivecpp, ocaml,

octave, pascal, perl, php, pike, postscript, prolog, python, r,

relaxngcompact, restructuredtext, rhtml, roff, ruby, rust, scala, scheme,

sci, sed, sgml, sql, sqlmysql, sqlpostgresql, tcl, texinfo, verilog, vhdl,

xml, xorg, xslt, xul, yacc, yaml

Default user data directory: /root/.pandoc

Web: http://johnmacfarlane.net/pandoc

This is free software; see the source for copying conditions. There is no

warranty, not even for merchantability or fitness for a particular purpose.

イメージのIDを確認してコンテナイメージを作成します。

$ docker ps -a
$ docker commit 85a95b686219 pandoc

$ docker ps -a

$ docker commit 85a95b686219 pandoc

テストするためにローカルディレクトリをマウントさせてコンテナを起動しました。

$ docker run -v /Users/xxx/Documents/docker/pandoc:/tmp -it pandoc /bin/bash

1 2	$ docker run -v /Users/xxx/Documents/docker/pandoc:/tmp -it pandoc /bin/bash

ローカルのディレクトリはフルパスで指定するんですね。
そしてそのパスは、Docker for Macの設定で設定されているディレクトリの配下である必要があるそうです。

何はともあれ、マウントできたので、変換テストをしてみます。

# pandoc -f markdown sample.md -o sample.epub
# pandoc -f markdown sample_ja.md -o sample_ja.epub

# pandoc -f markdown sample.md -o sample.epub

# pandoc -f markdown sample_ja.md -o sample_ja.epub

日本語でもテストをしてみました。

コンテナ上で作成したファイルが、マウント先のMacのディレクトリにもできてました。

Sample.mdの内容はこちらです。

# Sample

## Module1

test
test

# Sample

## Module1

test

Sample_ja.mdの内容はこちらです。

# サンプル

## 第一章

テスト
テスト

# サンプル

## 第一章

テスト

確認してみると、日本語もちゃんとEPUBになってました。

これでとりあえずイメージが出来たので先にすすめます。
今日はひとまずここまで。

あと、今回よく使ったコマンドで、Dockerコンテナの削除です。

$ docker rm `docker ps -aq`

1 2	$ docker rm `docker ps -aq`

試してダメならコンテナを削除してイメージからやり直せばいいので、すごく便利ですね。
コンテナが便利なことは頭ではわかっていたのですが、手を動かして実感すると違います。

最後までお読みいただきましてありがとうございました！

「AWS認定資格試験テキスト＆問題集　AWS認定ソリューションアーキテクト - プロフェッショナル改訂第2版」という本を書きました。

「AWS認定資格試験テキスト AWS認定クラウドプラクティショナー改訂第3版」という本を書きました。

「ポケットスタディ AWS認定デベロッパーアソシエイト［DVA-C02対応］」という本を書きました。

「要点整理から攻略するAWS認定ソリューションアーキテクト-アソシエイト」という本を書きました。

「AWSではじめるLinux入門ガイド」という本を書きました。

@yamamanx

開発ベンダー5年、ユーザ企業システム部門通算9年、ITインストラクター5年目でプロトタイプビルダーもやりだしたSoftware Engineerです。
質問はコメントかSNSなどからお気軽にどうぞ。
出来る限りなるべく答えます。

このブログの内容/発言の一切は個人の見解であり、所属する組織とは関係ありません。
このブログは経験したことなどの共有を目的としており、手順や結果などを保証するものではありません。
ご参考にされる際は、読者様自身のご判断にてご対応をお願いいたします。

また、勉強会やイベントのレポートは自分が気になったことをメモしたり、聞いて思ったことを書いていますので、登壇者の意見や発表内容ではありません。

- AWS AWS, batch, docker

: AWSのアカウントを新規作成と、最低限やっておいた方がいいMFAの設定

AWSのアカウントを新規作成する手順を書き出しておきます。 ※2017年8月6日 …

: AWS Lambdaで「Process exited before completing request」

AWS lambdaで「Process exited before comple …

: DynamoDB Accelerator(DAX)のサンプルアプリケーション(Python)を実行

DynamoDBデベロッパーガイドのDynamoDB Accelerator(D …

: Amazon API GatewayのIAM認証の動作を確認しました

API GatewayのIAM認証は、IAMユーザーが実行できるように認証する、 …

: EC2インスタンスプロファイルによってAssumeRoleされた認証情報の有効期限は短くできるのでしょうか

「EC2インスタンスプロファイルによってAssumeRoleされた認証情報の有効 …

: EC2 Windows インスタンス PowerShellでメタデータを見る

Linuxインスタンスならcurlコマンドで確認すればいいのですが、Window …

: LINE Bot APIのファーストステップをLambda+API Gatewayでやってみたらものすごく簡単で驚いた

トライアル当初はホワイトリストのしばりや、初回反応するまで時間がかかったりとみな …

: LINE BOT AWARDS 2017に応募しました

LINEの友達追加QRです。動作のご確認にどうぞ LINE BOT AWARD …

: AWS Elastic Beanstalkによって作成されたS3バケットはDeleteBucketが拒否されていた

ちょっとした検証をしたあとに、Elastic Beanstalkのアプリケーショ …

: AWS DeepLens開封の儀

去年(2019年)7月にamazon.co.jpでDeepLens買えますやんっ …

PREV: Amazon CloudSearchからAmazon Elasticsearch Serviceへ変えました
NEXT: ECR(Amazon Elastic Container Registry)にコンテナイメージをアップロードする

Pandocサーバーのコンテナイメージを作成する

Pandocのコンテナイメージをローカルにダウンロードする

Amazon Linux コンテナイメージにPandocをインストールする

ad

ad

関連記事