Dockerコンテナ上のアプリケーションのログのローテーション

Dockerコンテナ上のphpアプリケーションログを日時とサイズでローテションさせた時のメモ

・Monologにサイズでローテションしてくれる機能がなかったのでLogrotateを使ってローテションをしたって話。

構成
Docker + alpine + php + Monolog + logrotate + cron

Dockerfile

• logrotateをインストール

RUN apk add logrotate

• logrotateの設定ファイルをコピー
  予め、ログの設定を記述したファイルを用意しておきコンテナ内にコピーします。 下記の例の場合 local/log配下に設定ファイルを置いてある感じです。

RUN cp -rf local/log/logrotate.conf /etc/
COPY local/log/logrotate.d/php-log.conf /etc/logrotate.d

ちなみに設定ファイルはこんな感じにしました。

# see "man logrotate" for details
# rotate log files weekly
weekly # 週１ローテ

# keep 4 weeks worth of backlogs
rotate 4 # デフォルトのログは4世代分まで管理（週１× 4回 = 1ヶ月分）

# create new (empty) log files after rotating old ones
create # ローテ後に空のファイルをつくる

# uncomment this if you want your log files compressed
#compress

# packages drop log rotation information into this directory
include /etc/logrotate.d # 個別ファイルを読み込む設定はコレ

# system-specific logs may be configured here

1日1回またはファイルサイズが10Mを超えたらローテーションを行う

/var/log/php/php-app.log {
    daily # 1日1回ローテーション
    missingok
    rotate 30 # 30世代分
    dateext # ローテ時には日付でsufix
    dateformat -%Y-%m-%d-%s
    delaycompress # ローテ後、圧縮を1回遅らせる
    size 10M # ファイルサイズが10Mを超えたらローテーションする
    su www-data www-data # 実行ユーザーを指定
}

entrypoint.sh

logrotateのcron設定を反映しcronを再起動

# setup entrypoint
COPY ./entrypoint.sh /usr/local/bin/
ENTRYPOINT ["entrypoint.sh"]

entrypoint.shはこんな感じ。

cp -f /etc/periodic/daily/logrotate /etc/periodic/15min
crond restart
chmod o+x /var/log
mkdir /var/log/php
chown www-data:www-data /var/log/php

補足

logrotateのローテション作業はcronを介して行われます。
つまり、daily,weekly,hourlyのローテションもcronの設定次第というわけです。

/etc/periodic/daily/logrotateのファイルをcronでどのタイミングで見に行かせるかが要というわけですね。
alpineのcrontabの設定を覗いてみたら、日時、毎時、15分毎（もっとディレクトリあったかも）に下記のディレクトリを覗きにいって実行している設定になっており、logrotateはデフォルトでは日時フォルダ内にlogrotateを設置しています。
logrotateの実行タイミングを15分毎にすることによって、1日1回、またはログサイズが10Mを超えた時点でローテーションを行うようにしています。
※logrotateの実行タイミングが1日1回のままだとファイルサイズが10Mを超えていてもcronのタイミング（つまり1日1回）でしかローテーションは実行されません。

日時：/etc/periodic/daily
毎時：/etc/periodic/hourly
15分ごと：/etc/periodic/15min

logrotateのコマンド

もし参考にされる方がいましたらlogrotate -d /etc/logrotate.confは必ず実行することをお勧めします。
パーミッションや重複エラーなど何らかしらのエラーがあるとローテーションは実行されません。
phpアプリケーション側に合わせてディレクトリのパーミッションを緩くしたりするとパーミッションが緩いってlogrotateさんが怒ってきてローテーションを実行してくれません。

おわりに

前にやったことなので思い出しながらつらつらと書いています。
大体こんな感じだったと思います。
大したことやってないんですが、Monologにファイルサイズでローテーションする機能がなかったので。
Monologじゃなくても、PHPじゃなくても、ファイルサイズでローテーションすることが今後あるかもしれないと思って書き綴っています。