注:swift1.1版使用swift-auth-add-user生成用户,swift1.3之后用户信息全部记录在proxy-server.conf 的[filter:tempauth]过滤器里,差别并不明显。文章完成时的安装环境为swift1.1,swift版本稳定之后会补充说明因版本差异而造成的变动!
3.2swift应该如何使用
OpenStack Object Storage Developer Guide 列举了通用API,这里只是对常用的操作做简单举例
约定:
- account: test
- user:tester
- password: testing
用户的生成参照1.1节swift安装教程。
(注:st是swifttool 的缩写,swift1.3之后st更名为swift,因此实践时请注意版本差异!)
3.2.1 使用st
任何安装了st的机器都可以使用,并不限于storage node 或者 proxy-auth node
查询用户状态
- swift@node31:~$ st -v -A https://192.168.1.31:11000/v1.0 -U test:tester -K testing stat
- StorageURL: https://192.168.1.31:8080/v1/AUTH_d6084598cca04ee6a0951dbdd89612c6
- Auth Token: AUTH_tkefdc936d7e94493982d78f3dd6c16ead
- Account: AUTH_d6084598cca04ee6a0951dbdd89612c6
- Containers: 2
- Objects: 8
- Bytes: 15177385
列表用户的container和object
- swift@node31:~$ st -A https://192.168.1.31:11000/v1.0 -U test:tester -K testing list
- images
- mp3
- swift@node31:~$ st -v -A https://192.168.1.31:11000/v1.0 -U test:tester -K testing list images
- 1Mb.file
- test.jpg
- test1.jpg
上传object
- swift@node31:~$ st -v -A https://192.168.1.31:11000/v1.0 -U test:tester -K testing upload images 1Mb.file
下载object
- swift@node31:~$ st -v -A https://192.168.1.31:11000/v1.0 -U test:tester -K testing download images 1Mb.file
- 1Mb.file
3.2.2使用curl
curl用来自定义网络报文,因此可以和提供Restful API的swift进行交互。从curl的格式来看,大概能窥测到使用语言封装object请求的方法。:)
查询用户状态
- zzfancy@129:~$ curl -k -D - -H 'X-Storage-User: test:tester' -H 'X-Storage-Pass: testing' https://192.168.1.31:11000/v1.0
- HTTP/1.1 204 No Content
- X-Storage-Url: https://192.168.1.31:8080/v1/AUTH_d6084598cca04ee6a0951dbdd89612c6
- X-Storage-Token: AUTH_tkefdc936d7e94493982d78f3dd6c16ead
- X-Auth-Token: AUTH_tkefdc936d7e94493982d78f3dd6c16ead
- Content-Length: 0
- Date: Tue, 02 Aug 2011 08:43:10 GMT
查看空间使用情况
- zzfancy@129:~$ curl -k -X HEAD -D - -H 'X-Auth-Token: AUTH_tkefdc936d7e94493982d78f3dd6c16ead' https://192.168.1.31:8080/v1/AUTH_d6084598cca04ee6a0951dbdd89612c6
- HTTP/1.1 204 No Content
- X-Account-Object-Count: 8
- X-Account-Bytes-Used: 15177385
- X-Account-Container-Count: 2
- Content-Length: 0
- Date: Tue, 02 Aug 2011 08:47:02 GMT
列表用户的container和object,可加参数(本例中参数为format-xml,详情请查询API)
- zzfancy@129:~$ curl -k -X GET -H 'X-Auth-Token: AUTH_tkefdc936d7e94493982d78f3dd6c16ead' https://192.168.1.31:8080/v1.0/AUTH_d6084598cca04ee6a0951dbdd89612c6/images
- 1Mb.file
- test.jpg
- test1.jpg
- zzfancy@129:~$ curl -k -X GET -H 'X-Auth-Token: AUTH_tkefdc936d7e94493982d78f3dd6c16ead' https://192.168.1.31:8080/v1.0/AUTH_d6084598cca04ee6a0951dbdd89612c6/images?format=xml
- <?xml version="1.0" encoding="UTF-8"?>
- <container name="images">
- <object>
- <name>1Mb.file</name>
- <hash>b6d81b360a5672d80c27430f39153e2c</hash>
- <bytes>1048576</bytes>
- <content_type>application/octet-stream</content_type>
- <last_modified>2011-06-20T07:57:34.523220</last_modified>
- </object>
- <object>
- <name>test.jpg</name>
- <hash>a9d7d0f2d01bf737027256b8e7e9bf6a</hash>
- <bytes>87345</bytes>
- <content_type>image/jpeg</content_type>
- <last_modified>2011-06-17T03:32:21.838280</last_modified>
- </object>
- <object><name>test1.jpg</name>
- <hash>a9d7d0f2d01bf737027256b8e7e9bf6a</hash>
- <bytes>87345</bytes>
- <content_type>image/jpeg</content_type>
- <last_modified>2011-06-19T16:07:39.431260</last_modified>
- </object>
- </container>
创建container并上传object
- zzfancy@129:~$ curl -k -X PUT -T ./2Mb.jpeg -H 'Content-Type: image/jpeg' -H 'X-Auth-Token: AUTH_tkefdc936d7e94493982d78f3dd6c16ead' https://192.168.1.31:8080/v1.0/AUTH_d6084598cca04ee6a0951dbdd89612c6/images/2Mb.jpeg
- <html>
- <head>
- <title>201 Created</title>
- </head>
- <body>
- <h1>201 Created</h1>
- <br /><br />
- </body>
- </html>
下载object
- zzfancy@129:~$ curl -s -k -X GET -H 'X-Auth-Token: AUTH_tkefdc936d7e94493982d78f3dd6c16ead' https://192.168.1.31:8080/v1/AUTH_d6084598cca04ee6a0951dbdd89612c6/images/2Mb.jpeg -O .
3.2.3cyberduck
cyberduck 支持的服务类型非常广泛,详见官网[1]。虽然swift1.3之后没有再引入对cyberduck的介绍,但并不影响其使用。
笔者用的cyberduck版本为4.0.2(8601)。
填入服务器地址,端口,用户名和key
“路径”选项选填,默认为空