背景
静态网站托管（s3website）相比普通s3请求，多了几个核心功能：
- 默认请求页面。当用户url以"/"结尾时返回的页面。
- 错误页面。当用户请求的url发生错误时返回的页面。
- 转发设置。针对一个bucket或者bucket下某个对象设置请求跳转。
除此之外，s3website模式和s3模式相差不大。
设置方法
- 使用s3cmd设置bucket为静态网站托管模式方法如下：
s3cmd ws-create --ws-index=<default.html> --ws-error=<error.html> s3://<bucket-name>
达到的效果就是当用户访问http://<endpoint>/<bucket-name>/时，会返回s3://<bucket-name>/<default.html>对象，更一般的情况是用户访问http://<endpoint>/<bucket-name>/<path>/时，实际返回s3://<bucket-name>/<path>/<default.html>对象；如果用户访问的url没有对应的s3 object，则返回s3://<bucket-name>/<error.html>对象。
- 使用REST API设置bucket为静态网站托管的方法如下：
#!/bin/bash
host=<ip>:<normal-rgw-port>
resource="/<bucket_name>"
indexPage="<index.html>"
errorPage="<error.html>"
contentType="XXYYZZ"
dateValue=`date -R -u`
stringToSign="PUT
${contentType}
${dateValue}
${resource}"
s3Key=<key>
s3Secret=<secret>
#计算签名
signature=`/bin/echo -n "$stringToSign" | openssl sha1 -hmac ${s3Secret} -binary | base64`
curl -X PUT \
-H "Date: ${dateValue}" \
-H "Content-Type: ${contentType}" \
-H "Authorization: AWS ${s3Key}:${signature}" \
-d "<WebsiteConfiguration><IndexDocument><Suffix>${indexPage}</Suffix></IndexDocument><ErrorDocument><Key>${errorPage}</Key></ErrorDocument><RoutingRules><RoutingRule><Condition><KeyPrefixEquals>docs/</KeyPrefixEquals></Condition><Redirect><ReplaceKeyPrefixWith>documents/</ReplaceKeyPrefixWith></Redirect></RoutingRule></RoutingRules></WebsiteConfiguration>" \
"http://${host}${resource}?website"
注意：相应的
GET,DELHTTP方法可用于获取和清空bucket的静态网站托管配置。
接收请求的RGW需要手动配置的配置项有：
rgw_enable_apis = "s3, s3website, swift, swift_auth, admin"
rgw_enable_static_website = true
使用静态网站托管bucket时需要向特定的RGW发送请求，这些RGW的配置和常规用于s3访问的RGW不同：
rgw_enable_apis="s3website, s3, swift, swift_auth, admin"
代码实现
设置bucket
将bucket设置成静态网站托管模式时，使用的rgw_api仍然是s3，和常规对象存储相同。
url中的website请求参数会标识本次请求是一次“设置bucket为website模式”的请求:
RGWOp *RGWHandler_REST_Bucket_S3::op_put()
{
...
if (s->info.args.sub_resource_exists("website")) {
if (!s->cct->_conf->rgw_enable_static_website) {
return NULL;
}
return new RGWSetBucketWebsite_ObjStore_S3;
}
...
使用bucket
为了以website模式对一个bucket进行访问，需要将接收请求的RGW的rgw_api设置成s3website优先。当RGW接收到请求后，会将请求标志成s3website模式
int RGWREST::preprocess(struct req_state *s, RGWClientIO* cio)
{
...
if (s3website_enabled && api_priority_s3website > api_priority_s3) {
in_hosted_domain_s3website = 1;
}
if (in_hosted_domain_s3website) {
s->prot_flags |= RGW_REST_WEBSITE;
}
...
}
在随后的RGWHandler选择中会据此选用相应的Handler
RGWHandler_REST* RGWRESTMgr_S3::get_handler(struct req_state *s)
{
bool is_s3website = enable_s3website && (s->prot_flags & RGW_REST_WEBSITE);
int ret = RGWHandler_REST_S3::init_from_header(s,
is_s3website ? RGW_FORMAT_HTML :
RGW_FORMAT_XML, true);
if (ret < 0)
return NULL;
RGWHandler_REST* handler;
// TODO: Make this more readable
if (is_s3website) {
if (s->init_state.url_bucket.empty()) {
handler = new RGWHandler_REST_Service_S3Website;
} else if (s->object.empty()) {
handler = new RGWHandler_REST_Bucket_S3Website;
} else {
handler = new RGWHandler_REST_Obj_S3Website;
}
...
RGWHandler_REST_Service_S3Website, RGWHandler_REST_Bucket_S3Website和RGWHandler_REST_Object_S3Website均继承自RGWHandler_REST_S3Website, 三者在get_obj失败时便会调用RGWHandler_REST_S3Website::error_handler()，从而实现错误界面的返回。
默认页面的返回是由RGWHandler_REST_S3Website::retarget()实现，此函数在rgw_process.cc中被调用：
int process_request(RGWRados* store, RGWREST* rest, RGWRequest* req,
RGWStreamIO* client_io, OpsLogSocket* olog)
{
...
/**
* Only some accesses support website mode, and website mode does NOT apply
* if you are using the REST endpoint either (ergo, no authenticated access)
*/
req->log(s, "recalculating target");
ret = handler->retarget(op, &op);
...
因此retarget动作永远会执行，不论是s3还是s3website。
总结
在RGW中使用静态网站托管功能需要配置两套RGW示例，分别用于配置bucket和访问bucket。且默认页面需要在没个“目录”下放置（这一点可能和其他厂商的对象存储服务有区别），否则会导致404，进而返回错误页面。
