nginxのproxy_passにIPではなくホスト名を使うときの注意点

nginxの背後にELBがいて、proxy_pass https://xxx.yyy.comみたいに指定していたんだが、突然クライアントにHTTP 499が返却されてしまうという事案が発生した。なおこの記事の対象はnginx1.8系とnginx1.6系。調べたところによると割とみんなよくハマる定期ネタのようだ。



どういうことか

nginxの仕様としてproxy_passに名前を使っている場合、その名前解決はnginx起動時に行われる。そしてそのときに取得したIPはnginxにキャッシュされてnginxの再起動もしくはHUPを受け取るまで解放されない。

なのでELBのようにIPが変化するものをnginxの後段に置くときは注意する。

proxy_pass https://xxx.yyy.com;

だけでなく、resolverでDNSとそのキャッシュのexpireを指定、さらにset $xxxでホスト名を変数にセットする必要がある。

resolver 10.0.0.2 valid=5s;
set $endpoint “xxx.yyy.com”;
proxy_pass https://$endpoint;

下記の参考欄を見ると、set $endpoint “xxx.yyy.com”を入れていないケースがあるが、nginx1.8系、1.6系で試したところ、set$endpoint “xxx.yyy.com”は必要だった。

参考:

• NginxとInternalELBとのDNS名前解決方法
  
  • http://kkurahar.github.io/blog/2013/07/18/elb-nginx-499/
• Nginx のDNS 名前解決とS3 やELB へのリバースプロキシ
  
  • https://yulii.github.io/nginx-dns-cache-20150815.html
• Nginxと名前解決の話
  
  • http://papix.hatenablog.com/entry/2015/07/29/225750
• Nginxでproxy_passにホスト名を書いた時の名前解決のタイミング
  
  • http://d.hatena.ne.jp/hirose31/20131112/1384251646