OpenStack Object Storage Developer Guide/Swift官方API文档 -- 翻译 （五）

OK啦，这是最后一篇，其实从原官方文档的组织上，该小节是3.3——container之后，object之前，为了API整体思路的连贯性，我自己擅作主张放到了最后一部分。这章是我觉得swift中比较有趣的一章，可以直接将swift配置成静态站点，作为数据下载站，直接解决了静态站点数据备份的问题。

于是，让我们愉快的继续吧 =D

 

3.3. 创建静态站点（Create Static Website）

你可以使用swift账户在互联网上创建一个静态站点。这种模式通常是匿名请求的，如果你希望在这种模式下使用认证请求，则需要在请求头中将 X-Web-Mode 设置为 TRUE。过滤器 staticweb 也应该添加到配置文件 /etc/swift/proxy-server.conf 中认证中间件后的管道上。staticweb 中间件的配置必需添加到pipeline后，如：

[DEFAULT]

...



[pipeline:main]

pipeline = healthcheck cache tempauth staticweb proxy-server



...



[filter:staticweb]

use = egg:swift#staticweb

# Seconds to cache container x-container-meta-web-* header values.

# cache_timeout = 300

# You can override the default log routing for this filter here:

# set log_name = staticweb

# set log_facility = LOG_LOCAL0

# set log_level = INFO

# set access_log_name = staticweb

# set access_log_facility = LOG_LOCAL0

# set access_log_level = INFO

# set log_headers = False

 

你的公共可读的container应该包含 X-Container-Meta-Web-Index 和 X-Container-Meta-Web-Error 这两个头（ X-Container-Meta-Web-Error 这个header将在后文“为静态站点设置出错页”中讨论）。

X-Container-Meta-Web-Index 用于指定站点的默认访问页（default页，或者index.html文件）。当一个用户第一次进入你的站点时，他不需要指定特殊的index文件，你的站点就会自动将index.html展示给他。如果你通过创建伪目录的方式为你的站点创建了子目录，则每个子目录的默认访问页的名称都将是X-Container-Meta-Web-Index 指定的页面。如果你的伪目录中不包含一个同X-Container-Meta-Web-Index 指定的页面名字相同的index file，则当用户访问这个子目录时，将会返回一个404错误。

你也可以选择展示子目录中的文件列表，而非一个网页。如果要实现展示子目录中的文件列表功能，只需将头 X-Container-Meta-Web-Listtings 设置为 TRUE。你可以通过设置 X-Container-Meta-Web-Listings-CSS 为你的文件列表添加样式（如lists.css）。

 

3.3.1. 通过Swift实现的静态网页中间件（Static Web Middleware via swift）

　　例3.38. 设置Container为公共可读的

　　设置Container为公共可读的。一旦container被设置成公共可读的，那么你可以直接访问的容器中的对象，但是你需要为站点的主URL（即container的URL）和它的子目录设置index file。

swift post -r '.r:*' container

　　例3.39. 设置站点的Index文件

　　设置站点的Index文件。在这个例子中，index.html是站点的默认访问页。

swift post -m 'web-index:index.html' container

　　例3.40. 启用文件列表

　　启用文件列表。如果你没有设置index文件，则要将container中的对象列表展示出来。设置样式的命令在下一个例子中。

swift post -m 'web-listings: true' container

　　例3.41. 为文件列表设置CSS样式

　　为文件列表设置样式。

swift post -m 'web-listings-css:listings.css' container

 

3.3.2. 为静态站点设置出错页（Set Error Pages for Static Website）

你可能需要为你的站点设置自定义的错误页。目前，只支持401（Unauthorized）和404（Not Found）这两个错误。为了实现自定义错误页，你需要设置元数据头 X-Container-Meta-Web-Error。

真正的错误页根据 状态码 和你所设置的 X-Container-Meta-Web-Error名称 来决定。例如，你将 X-Container-Meta-Web-Error 设置为 error.html，则当出现401错误时，将会展示 401error.html 页面，类似的，当出现404错误时，将会展示 404error.html 页面。在你设置为container设置 X-Container-Meta-Web-Error 后，你可以为这两种错误分别创建错误页，也可以不创建，让他们访问公共的错误页。

你只需要为整个站点设置一次 X-Container-Meta-Web-Error 即可。

　　例3.42. 为文静态站点设置错误页

swift post -m 'web-error:error.html' container

任何一个2xx的响应都表示执行成功了。

 

 

至此，OpenStack对象存储的官方API算是翻译完成啦！不要问我第1章和第4章，我是死活都不会翻的！第4章主要是使用cURL与swift交互的介绍，比较直接，没太多需要理解的东西，自己看看就好，不要懒哦 =P