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`

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

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

【PR】「AWS認定試験対策 AWS クラウドプラクティショナー」という本を書きました。

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

@yamamanx

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

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

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

- AWS AWS, batch, docker

: AWS DeepLens開封の儀

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

: 「関西AWSスタートアップ勉強会」に行ってきました

第2回関西スタートアップAWS勉強会に行ってきました。 akippa 拠点数コ …

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

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

: ブログ画像のシンガポールリージョンへのレプリケーションはじめました

このブログの画像はS3バケットに保存して、CloudFront経由で配信していま …

: EC2とRDSのMySQLを他のAWSアカウントへ移設する

他のAWSアカウントへシステムごと移設した場合の手順です。構成はEC2とRDS …

: AWS 認定クラウドプラクティショナーのサンプル問題

AWS認定クラウドプラクティショナのサンプル問題2018年9月25日現在で、英語 …

: Amazon API GatewayをLambda(Python)で削除する

やりたいこと特定のAWSアカウント、特定のリージョン内のAPI Gateway …

: AWS Lambda(Python)からTwitterに投稿する

「GoogleフォームからAPI Gatewayで作成したREST APIにPO …

: AWS Data Pipelineを使ってDynamoDBのアイテムを全件S3バケットに書き出した

ちょっと試してみたくてやってみました。手順はこちらのチュートリアルを参考にすす …

: Amazon Auroraのスナップショットの暗号化とリージョン間コピーを改めて試しました

Amazon Auroraデータベースを暗号化して、スナップショットを作成、クロ …

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

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

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

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

ad

ad

関連記事