s3-server-rs/README.md

rust-s3-server

An S3 compatible Object Storage written in Rust. Ideal for local test environment

Building

$ cargo build --release

Running

Getting help

$ target/release/rusts3 --help
Usage: rusts3 [OPTIONS]

Options:
  -b, --base-dir <BASE_DIR>          [default: ./rusts3-data]
      --bind-address <BIND_ADDRESS>  Bind IP address [default: 0.0.0.0]
      --bind-port <BIND_PORT>        Bind port number [default: 8000]
      --log-conf <LOG_CONF>          Log4rs config file [default: ]
  -h, --help                         Print help

Example usage:

$ target/release/rusts3 -b "test-data" --bind-address "192.168.44.172" --bind-port 18000 --log-conf log4rs.yaml

Testing

Creating bucket:

$ aws --endpoint-url http://192.168.44.172:18000 s3 mb s3://new-bucket
make_bucket: new-bucket

Uploading object:

$ aws --endpoint-url http://192.168.44.172:18000 s3 cp ~/Downloads/zulu.dmg s3://new-bucket/some-path/zulu.dmg
upload: ./zulu.dmg to s3://new-bucket/some-path/zulu.dmg 

Downloading object:

$ aws --endpoint-url http://192.168.44.172:18000 s3 cp s3://new-bucket/some-path/zulu.dmg ./new.dmg
download: s3://new-bucket/some-path/zulu.dmg to ./new.dmg 

# files should be the same
$ diff ~/Downloads/zulu.dmg ./new/dmg

Listing object:

$ aws --endpoint-url http://192.168.44.172:18000 s3 ls s3://new-bucket
                           PRE some-path/
$ aws --endpoint-url http://192.168.44.172:18000 s3 ls s3://new-bucket/some-path/
                           PRE some-path/
2023-08-13 11:45:25     615835 zulu.dmg

Deleting object:

$ aws --endpoint-url http://192.168.44.172:18000 s3 rm s3://new-bucket/some-path/zulu.img
delete: s3://new-bucket/some-path/zulu.dmg

---

export AWS_ACCESS_KEY_ID=ABCD
export AWS_SECRET_ACCESS_KEY=EF1234
export AWS_ENDPOINT_URL=http://127.0.0.1:8001