本記事は、 シェルスクリプト Advent Calendar 2021 の 4日目 の記事だ。
そして、 且つ docker Advent Calendar 2021 4日目 の記事でもある。
どちらのカレンダーもまだまだスッカスカなので、禁じ手で埋めにかかってしまった。
Docker 公式イメージ などをベースにして、カスタムしてイメージをビルドして使おうとした際、 なるべくなら /etc/apt/apt.conf.d/ 等のように、設定用のファイルを追加して、ツール側がいい感じにマージして利用してくれるのが望ましい。
しかし、 場合によってはやむを得ず、既存のファイルを sed コマンドなどで編集せざるを得ないこともあるだろう。
カスタムイメージの Dockerfile をビルドする際に、当初は意図通り書き換えられていても、イメージが更新された結果、イメージのリビルド時にファイルの書き換えが意図しない結果となってしまう場合がある。 1
通常、 sed コマンドは、置換が発生してもしなくても、 終了コード 0 で終了する。
このため、書き換えの成否にかかわらず、 docker build 時にエラーにならないため、コンテナ実行時に初めて置換が意図しない結果だったことに気づくことがある。
そこで、sed コマンドの書き換えで適切なパターンが見つからなかった場合に 0以外の終了コードを返し、ビルド時にエラーとする方法を考える。
以下、 sed は GNU sed を前提とし、 "行頭の foo" を BARfooBAR に置き換える場合の例。
ひとつもヒットしなかったら終了コード16 のエラー
まずは、 書き換えるパターンが見つからなかった場合に、エラーコードを返す方法。
sed -e '/^foo/{s//BAR\0BAR/;h};$!b;p;x;/./Q;Q16'参考: https://stackoverflow.com/a/15966279
ざっとコマンドの流れを解説すると、以下のようになる。
- まず、 正規表現アドレス で置換する行を選択する。
- ブロック
{}を用いて、正規表現に一致する行について以下を実行する。- s コマンド で、後方参照を使って FOObarBAR に置換する。
空の正規表現 '//'は最後の正規表現のマッチを繰り返すので、正規表現アドレスでマッチした "行頭の foo" が置き換えられる。 - h コマンド で、パターンスペース の内容をホールドスペース (sed 内のクリップボードみたいなもの) にコピーする。
- s コマンド で、後方参照を使って FOObarBAR に置換する。
$!bの部分は、最終行でなければ次のサイクルに移動する。 すなわち、以降のコマンドは最終行でのみ実行される。- p コマンド でパターンスペースの内容を出力にプリントする。
- x コマンド でパターンスペースの内容とホールドスペースをスワップする。
パターンスペースの内容は結果的に 、1度でも最初の正規表現がヒットすればその文字列に、 最後まで一度も正規表現がヒットしなければ空っぽになる。 - 最後、パターンスペースの内容が空でない (即ち、1度以上正規表現がヒットした) なら、 終了コード 0 で終了し、 そうでなければ 16 で終了する。
ヒットしなければ終了コード16, 2つ以上ヒットしたら終了コード32 のエラー
さらに一歩踏み込んで、 書き換えるパターンが見つからない場合と、 2つ以上見つかってしまった場合両方で、エラーにする方法。
sed -e '/^foo/{s//BAR\0BAR/;x;/./Q32;g};$!b;p;x;/./Q;Q16'基本的な動きは、ひとつもヒットしなかったパターンと同じだ。
ただ、ブロック {} 内部のコマンドを以下のように変更して、複数ヒットした場合にエラーで終了している。
- まず、 正規表現アドレス で置換する行を選択する。
- ブロック
{}を用いて、正規表現に一致する行について以下を実行する。 - 以降は「ひとつもヒットしなかったら…」と同じ
なお、このコマンドは、 2つヒットした時点で出力が止まる。
おわりに
モダンなプログラミング言語が軒並み型推論でコンパイル時にエラーとするように、 Dockerfile もビルド時にエラーにしてしまおう。
-
カスタムイメージの Dockerfile ベースイメージを選択する際、基本的にはタグである程度絞っておくべきだが、それはさておき。 ↩