S3 Object Storage

Deploy RADOS Gateway (RGW) on your Ceph cluster to get S3-compatible object storage.

Prerequisites

A running Ceph cluster with at least 3 OSDs
At least one available node to run the RGW daemon

Deploy RGW

Terminal

$ nf ceph rgw deploy --node <node-id>

You can deploy multiple RGW instances across different nodes for high availability.

Create an S3 User

Terminal

$ nf ceph rgw user create --id myapp --name "My Application" --email app@example.com

This returns S3 access and secret keys. Save them — you’ll need them for all S3 operations.

Using the CLI

Terminal

$ nf s3 --accessKey AKID123 --secretKey SKEY456 bucket list

Terminal

$ nf s3 --accessKey AKID123 --secretKey SKEY456 bucket create --name my-bucket

Terminal

$ nf s3 --accessKey AKID123 --secretKey SKEY456 object list --bucket my-bucket

Using AWS CLI

Since RGW is S3-compatible, you can use any S3 client:

Terminal

$ aws configure AWS Access Key ID: AKID123 AWS Secret Access Key: SKEY456 Default region name: us-east-1 Default output format: json

$ aws —endpoint-url http://<rgw-host>:7480 s3 ls $ aws —endpoint-url http://<rgw-host>:7480 s3 mb s3://my-bucket $ aws —endpoint-url http://<rgw-host>:7480 s3 cp file.txt s3://my-bucket/

Managing Gateways

Terminal

$ nf ceph rgw list

Terminal

$ nf ceph rgw remove --id <rgw-id>