MkDocks 1.5.3 の Docker コンテナ

MkDocs のバージョン 1.5.3 をインストールした Docker コンテナを作成しました。 DockerHub の以下 URL に登録してあります。

sig9/mkdocs

検証環境¶

対象	バージョン
Ubuntu	22.04.4LTS
MkDocs	1.5.3

Dockerfile¶

Dockerfile の内容は以下の通りです。

FROM python:3.12-slim

WORKDIR /docs

RUN apt-get update && \
    apt-get upgrade -y && \
    apt-get install -y --no-install-recommends \
        openssh-client=1:9.2p1-2+deb12u2 \
        rsync=3.2.7-1 && \
    apt-get clean all && \
    rm -rf /var/lib/apt/lists/* && \
    adduser -q --gecos "" --disabled-login mkuser && \
    pip install --no-cache-dir \
        fontawesome-markdown==0.2.6 \
        mdx_unimoji==1.1 \
        mkdocs-material==9.5.17 \
        mkdocs-material-extensions==1.3.1 \
        mkdocs==1.5.3 \
        pymdown-extensions==10.7.1 \
        python-markdown-math==0.8

Docker コンテナイメージのビルド¶

以下のコマンドでビルド出来ます。

docker image build -t sig9/mkdocs:1.5.3 .

mkdocs コマンドは /usr/local/bin/mkdocs にインストールされています。試しにバージョン情報を表示させてみます。

# docker run -it --rm --name mkdocs sig9/mkdocs:1.5.3 mkdocs --version
mkdocs, version 1.5.3 from /usr/local/lib/python3.12/site-packages/mkdocs (Python 3.12)

サイトをビルドする¶

コンテナを使ってサイトをビルドしてみます。まず、作業用のディレクトリを作成します。

mkdir docs

サイトをビルドしてみます。

docker run -v ./docs:/docs -v ./site:/docs/site -it --rm --name mkdocs sig9/mkdocs:1.5.3 mkdocs build --site-dir /var/www/html/