メイン環境を汚さない Hugo ＋ Asciidoctor 連携：専用コンテナ切り出しと並行ビルド排他制御（flock）の技術

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

+-------------------------------------------------------------------------+
| メイン開発環境 (DevContainer / Go 環境)                                 |
|                                                                         |
|   Hugo (静的ビルドプロセス)                                             |
|     │                                                                   |
|     │ (1) asciidoctor コマンドを実行（stdin で .adoc 本文を送信）       |
|     ▼                                                                   |
|   CLI ラッパースクリプト (~/.local/bin/asciidoctor)                     |
|     │                                                                   |
|     │ (2) stdin を一時ファイルに読み切り ＋ flock で排他制御            |
|     │ (3) docker run -i で専用コンテナを透過起動                        |
|     ▼                                                                   |
+-------------------------------------------------------------------------+
                                │
                                │ (Docker ソケット中継)
                                ▼
+-------------------------------------------------------------------------+
| Asciidoctor 専用コンテナ (adoc_converter:latest)                        |
|   Ruby 3.4-slim ＋ Asciidoctor ＋ Rouge                                 |
|     │                                                                   |
|     │ (4) HTML に高速変換して stdout へ出力                             |
|     ▼                                                                   |
+-------------------------------------------------------------------------+

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

FROM ruby:3.4-slim-bookworm

RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /converter
COPY Gemfile* ./
RUN bundle install

ENTRYPOINT ["bundle", "exec", "asciidoctor"]

1
2
3
4

source 'https://rubygems.org'

gem 'asciidoctor', '~> 2.0'
gem 'rouge', '~> 4.0'

1

docker build -t adoc_converter:latest -f Dockerfile.asciidoctor .

1
2
3

#!/usr/bin/env bash
# 【失敗例】素朴な中継スクリプト
exec docker run --rm -i adoc_converter:latest "$@"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

[ Hugo からの標準入力 (stdin) ]
             │
             ▼
【ステップ 1】 ロック取得前に、標準入力を即座に一時ファイルへ「読み切る」
             （Hugo 側の stdin 送信タイムアウトをゼロにする）
             │
             ▼
【ステップ 2】 入力データが 0 bytes（空ファイル）ならコンテナを起動せず即終了
             │
             ▼
【ステップ 3】 docker run の実行部分のみを「flock」で排他制御（直列化）
             （Docker デーモンへの同時起動負荷を抑え、安定して 1 つずつ変換）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

#!/usr/bin/env bash
set -euo pipefail

# 一時ファイルの生成と終了時の自動クリーンアップ
TMP_INPUT=$(mktemp /tmp/adoc_in.XXXXXX)
TMP_OUTPUT=$(mktemp /tmp/adoc_out.XXXXXX)
trap 'rm -f "$TMP_INPUT" "$TMP_OUTPUT"' EXIT

# 1. Hugo 側のタイムアウトを防ぐため、ロック取得前に標準入力を即座に読み切る
cat > "$TMP_INPUT"

# 2. 入力が 0 bytes の場合はコンテナを起動せず即座に正常終了
if [[ ! -s "$TMP_INPUT" ]]; then
  exit 0
fi

# 3. docker run の実行部分のみを flock で排他制御（直列化）
(
  flock -x 200
  docker run --rm -i \
    -v "$TMP_INPUT:/tmp/input.adoc:ro" \
    --entrypoint bundle \
    adoc_converter:latest \
    exec asciidoctor -o - "$@" /tmp/input.adoc > "$TMP_OUTPUT"
) 200>/tmp/asciidoctor_build.lock

# 4. 変換結果を Hugo へ返却
cat "$TMP_OUTPUT"

1

chmod +x ~/.local/bin/asciidoctor

1
2
3
4
5

[security]
  enableInlineShortcodes = false
  [security.exec]
    allow = ['^asciidoctor$', '^go$', '^git$']
    osEnv = ['(?i)^(PATH|HOME|USER|DOCKER_HOST)$']