AWS S3 Client

What is this?

A web client app that excercises the AWS S3 functionality via the API

Contains:

• /config = example aws creds config file and example endpoint override (optional) config file
• /controllers = s3Controller for UI and AWS SKD calls
• /public = style sheet
• /views = ejs UI
• app.js - main app, launch it and point browser to port 3000

S3 Functionality:

• Create Bucket
• List Buckets
• Upload (local) file/obj to bucket. Default Local file cat.jpg included in repo for your viewing pleasure! :)
• List files/objs in bucket
• Delete file/obj
• Delete bucket
• Create Signed URLs (proto)

Installation overview

clone the repo and install dependencies:

git clone https://github.com/ajyounguk/aws-s3-demo
cd aws-s3-client
npm install

Credentials

Copy the configuration file and add your AWS creds to it:

cd config
cp aws-config-sample.json aws-config.json

** please take care and don't commit your creds back to git **

(IAM user creds with group policy = AmazonS3SFullAccess works)

Overrride Amazon S3 endpoints

If you need to route your request to a proxy, or want to route s3 requests to a local pseudo AWS service (e.g. goaws or localStack) you can override endopoints by creating a aws-override.json config file:

cd config
cp aws-override-sample.json aws-override.json

and edit the endpoints in the file if needed

How to run it

run the server:

node app.js

point browser at (localIP/remoteIP) port 3000

For more information on S3

https://aws.amazon.com/s3/

EOF Readme..