monolithic kernel

HTTPでVarnishのキャッシュをpurge

January 16, 2011

Varnishは標準でvarnishadmコマンドとtelnetによる管理が実装されていますが、VCLを少し記述するとHTTPで操作することもできます。認証がかけられないという問題はありますが、IPアドレスによる制限は可能ですし、Webアプリに組み込むのであればHTTPのほうが楽な気がします。

今回はWebアプリで使う頻度が高いであろうpurgeをHTTPから実行してみます。

VCLの記述

methodがPURGEのリクエストが送られてきた場合にはreq.urlをパスの正規表現と解釈してpurgeを行うように記述します。また、以下の例ではHostヘッダで対象とするVirtualHostを指定できるようにしています。

backend app {  .host = "127.0.0.1";  .port = "9000";  .connect_timeout = 30s;}// Access Control List// 接続を許可するホストの一覧を記述しているacl purge {  "localhost";}sub vcl_recv {  if (req.request == "PURGE") {    // ~ 演算子を使うとACLに含まれるかどうかを判定できる    if (!client.ip ~ purge) {      error 405 "Not allowed.";    }    // パターンにマッチするキャッシュを削除する    purge("req.http.host == " req.http.host " && req.url ~ " req.url);    error 200 "Purged.";  }  elsif (req.http.host == "app.example.com") {    // purge以外の処理    set req.backend = app;  }  return(lookup);}

コマンドラインからの呼び出し

curl -X PURGE -H 'Host: app.example.com' 'http://localhost:6081/posts/' -I


HTTP/1.1 200 Purged.Server: VarnishRetry-After: 0Content-Type: text/html; charset=utf-8Content-Length: 451Date: Sun, 16 Jan 2011 06:35:25 GMTX-Varnish: 528212595Age: 0Via: 1.1 varnishConnection: close

Rubyからの呼び出し(Net::HTTP)

require 'net/http'class Net::HTTP  class Purge < Net::HTTPRequest    METHOD = 'PURGE'    REQUEST_HAS_BODY = false    RESPONSE_HAS_BODY = true  endendNet::HTTP.start('localhost', 6081) do |http|  req = Net::HTTP::Purge.new('/posts/')  req['Host'] = 'app.example.com'  p http.request(req)end


#<Net::HTTPOK 200 Purged. readbody=true>

Rubyからの呼び出し(EventMachine)

EventMachineのほかにEM-HTTP-Requestを使っています。

require 'eventmachine'require 'em-http'class EventMachine::HttpRequest  def purge(options = {}, &block)    setup_request(:purge, options, &block)  endendEventMachine.run do  http = EventMachine::HttpRequest.new('http://localhost:6081/posts/').purge(:head => { 'Host' => 'app.example.com' })  http.callback do    p http.response    EventMachine.stop_event_loop  end  http.errback do    p http.response    EventMachine.stop_event_loop  endend


"\n<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Strict//EN\"\n \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd\">\n<html>\n  <head>\n    <title>200 Purged.</title>\n  </head>\n  <body>\n    <h1>Error 200 Purged.</h1>\n    <p>Purged.</p>\n    <h3>Guru Meditation:</h3>\n    <p>XID: 528212591</p>\n    <hr>\n    <address>\n       <a href=\"http://www.varnish-cache.org/\">Varnish cache server</a>\n    </address>\n  </body>\n</html>\n"

参考