OpenStack Swift API

RustFS は、S3 API と同じ HTTP エンドポイントで OpenStack Swift 互換 API を提供できます。このガイドでは、オプションの swift 機能を有効にしたビルド、Keystone トークン検証の設定、基本的なアカウント、コンテナ、オブジェクト操作の確認方法を説明します。

Swift と RustFS の対応関係

Swift リクエストは、RustFS の S3 API エンドポイント上の /v1/AUTH_<project-id>/... パスを使用します。

URL のプロジェクト ID は、検証済み Keystone トークンのプロジェクト ID と一致する必要があります。RustFS は X-Auth-Token または X-Storage-Token でトークンを受け取ります。

確認済みの主要操作は次のとおりです。

Swift サポートを有効にしてビルドする

RustFS のデフォルト機能セットには Swift が含まれません。rustfs/rustfs リポジトリで明示的にビルドします。

cargo build --release --features swift

生成されたバイナリは、設定済みの S3 API アドレスで Swift パスを提供します。Swift 専用のリスナーやポートはありません。

Keystone を設定する

RustFS を起動する前に、Keystone を有効にして認証エンドポイントを設定します。

export RUSTFS_KEYSTONE_ENABLE=true
export RUSTFS_KEYSTONE_AUTH_URL=https://keystone.example.com
export RUSTFS_KEYSTONE_VERSION=v3
export RUSTFS_KEYSTONE_VERIFY_SSL=true

TLS 検証は有効のままにすることを推奨します。Keystone が送信されたトークンを拒否した場合、RustFS は 401 Unauthorized を返し、そのリクエストをローカル認証情報へフォールバックしません。

API を確認する

Keystone からスコープ付きトークンとプロジェクト ID を取得し、次のシェル変数を設定します。

export SWIFT_TOKEN='<your-keystone-token>'
export SWIFT_ACCOUNT='AUTH_<your-project-id>'
export SWIFT_URL="http://localhost:9000/v1/${SWIFT_ACCOUNT}"

プロジェクトから参照できるコンテナを一覧表示します。

curl --fail-with-body \
	--header "X-Auth-Token: ${SWIFT_TOKEN}" \
	"${SWIFT_URL}"

my-bucket を作成し、hello.txt をアップロードしてダウンロードします。

curl --fail-with-body --request PUT \
	--header "X-Auth-Token: ${SWIFT_TOKEN}" \
	"${SWIFT_URL}/my-bucket"

curl --fail-with-body --request PUT \
	--header "X-Auth-Token: ${SWIFT_TOKEN}" \
	--upload-file /path/to/hello.txt \
	"${SWIFT_URL}/my-bucket/hello.txt"

curl --fail-with-body \
	--header "X-Auth-Token: ${SWIFT_TOKEN}" \
	"${SWIFT_URL}/my-bucket/hello.txt"

トークンのプロジェクトと一致しない AUTH_<project-id> アカウントへのリクエストには、403 Forbidden が返されます。

次のステップ

• S3 互換性マトリックスを確認する
• RustFS の認証情報を管理する
• RustFS の TLS を設定する