設定テストとreload
設定ミスは、打った瞬間には分からない
これまで何度も nginx -t を打ってきました。ここで、あれが何を守っているのかをはっきりさせます。
nginx は起動するときに設定を読みます。書き間違えたまま systemctl restart を打つと、いったん止まったあと、読み込みに失敗して立ち上がれません。つまりサイトが落ちます。しかも落ちたことに気づくのは、たいてい訪問者からの連絡です。
止まる前に気づくための道具が -t です。
ターミナル
nginx -t
# nginx: configuration file /etc/nginx/nginx.conf test is successful動いているサービスには一切触れず、設定が読めるかどうかだけを確かめます。
わざと壊すと、どこを直せばいいか分かる
設定の書き間違いで最も多いのは、行末のセミコロンの付け忘れです。試しに1つ外してみると、-t はこう答えます。
nginx: [emerg] invalid number of arguments in "root" directive in /etc/nginx/sites-available/mysite.conf:5
nginx: configuration file /etc/nginx/nginx.conf test failedファイル名と行番号まで出ています。セミコロンが無いと、nginx は次の行までを同じ指示の続きとして読むので、行番号は壊した行のすぐ下を指すことがあります。エラーの文面を読まずに設定全体を眺め直す人が多いのですが、答えはたいていこの1行に書いてあります。まず読む、と決めてください。
最後の行が test is successful か test failed か。判定はここだけを見れば分かります。
1か所だけ書き換える
ファイルの一部だけを替えるときは sed -i を使います。
ターミナル
echo 'きょうの天気は晴れ' > /tmp/weather.txt
sed -i 's/晴れ/くもり/' /tmp/weather.txt
cat /tmp/weather.txt
# きょうの天気はくもりs/前/後/ は「前の文字列を見つけたら、後の文字列に置き換える」という指示で、各行で最初に見つかった1か所が替わります。-i を付けるとファイルそのものを書き換え、付けないと結果を画面に出すだけでファイルは変わりません。
置き換える文字列に / が入るときは、区切りを | に替えて s|前|後| と書けます。パスを含む設定の行は、たいていこちらが楽です。前の文字列の末尾に $ を付けると、行の終わりにある場合だけ当たります。s/晴れ$/晴れのち雨/ なら「晴れ」で終わる行だけが替わり、すでに「晴れのち雨」になった行には当たりません。何度打っても結果が同じになるので、戻す操作に向いています。書き換えたら cat か grep で、狙った行が狙ったとおりに変わったかを必ず見てください。
reload は止めずに読み直させる
検査を通ったら反映します。ここで restart ではなく reload を使います。
ターミナル
systemctl reload nginx2章で見たとおり、restart は一度止めてから起動するので、その瞬間サイトが応答できません。reload は master プロセスを残したまま、新しい設定を読んだ worker を用意し、古い worker には処理中のリクエストを最後まで終わらせてから退場してもらいます。だから訪問者から見て途切れる時間が生まれません。
違いは Main PID を見れば分かります。
ターミナル
systemctl show -p MainPID --value nginx # 1234
systemctl reload nginx
systemctl show -p MainPID --value nginx # 1234 のまま2章の restart では番号が変わりました。ここでは変わりません。同じプロセスのまま止まらずに済んだ、ということです。設定が入ったかどうかは、curl や nginx -T で見ます。
身につけるべき順番は3つ
設定を触るときの手順は、いつも同じです。書く、検査する、反映する。書くのは、まるごとなら cat > ファイル <<'EOF'、1か所だけなら sed -i です。
ターミナル
sed -i 's/前/後/' /etc/nginx/sites-available/mysite.conf # 書く
nginx -t # 検査する
systemctl reload nginx # 反映する検査を飛ばして反映すると、reload そのものが失敗します。このとき nginx は古い設定のまま動き続けるので、サイトは落ちません。それでも「直したはずなのに変わらない」という混乱が起きます。順番を守るのが結局いちばん早い道です。
手を動かす
設定をわざと壊して -t に検知させ、その出力を記録します。そのあと直して検査を通し、reload で反映します。プロセスの番号が変わらないことも確かめます。
ヒント
まだ開いていません
付箋は 2 枚。下の段ほど答えに近づきます
ヒント 2答えに近い