README for minio-s3

This is a Dockerized deployment of Minio for quickly simulting an S3 instance, with additional tools for using s3cmd to communicate with the instance.

Minio can also work with AWS::SDK and aws-cli.

Deployment

• Make the directories for config and data: mkdir -p test/.minio/config and mkdir -p test/.minio/data.

• Copy .env.example to .env and input dummy keys for MINIO_ACCESS_KEY and MINIO_SECRET_KEY.

• Copy s3minio.cfg.example to s3minio.cfg and modify the values set for access_key (line 2) and secret_key (line 57) to match the values of the dummy keys specified in .env for MINIO_ACCESS_KEY and MINIO_SECRET_KEY respectively.

• Run docker-compose up.

• You can visit your locally-deployed minio instance at http://localhost:9000/minio, using the values of MINIO_ACCESS_KEY and MINIO_SECRET_KEY to log in.

Sample commands

Add a bucket

s3cmd -c s3minio.cfg mb s3://sandwich

List buckets

s3cmd -c s3minio.cfg ls

Add file(s) to a bucket

s3cmd -c s3minio.cfg put FILE [FILE...] s3://sandwich

List contents of a bucket

s3cmd -c s3minio.cfg ls s3://sandwich