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

: Mountpoint for Amazon S3を試しました

このブログでは、画像などの配信にS3を使用しています。 WordPressのプラ …

: 「AWS認定資格試験テキスト AWS認定クラウドプラクティショナー」執筆裏話

今日2019/4/20発売となりました「AWS認定資格試験テキスト AWS認定ク …

: 「re:CAP ~サーバーワークス re:Invent 2018 報告会~」でre:Invent2018について思われたことを聞かせていただいた

サーバーワークスさんのre:Invent re:CAPにおじゃましました。 re …

: AWS IAMのMFA「エンティティは既に存在しています」に対応しました

エンティティは既に存在しています MFA Device entity at th …

: JAWS FESTA 2017 Reverse X re:Birth

JAWS FESTA 2017 中四国今年はブログタイトル「JAWS FEST …

: ブログのアーキテクチャをコストベースで見直しました

当ブログはAWSで構築しています。アーキテクチャをコストを最重視して見直しまし …

: 「CMC_Central 2024」に参加しました

個人サポーターとしてCMC_Central 2024に参加しました。オープニン …

: AWSアカウントでルートユーザーが使用されたときにTeamsへ投稿する

Organizations組織内のアカウントのいずれかでルートユーザーが使用され …

: QuickSightのVisualizeをダッシュボード化して定期メール

「Backlogの実績工数をAmazon QuickSightで可視化してわかっ …

: CodeBuildで執筆原稿データをまとめた

今書いている原稿に対して編集者さんから、「できればで構わないのですが、章ごとにマ …

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

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

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

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

ad

ad

関連記事