Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ajyounguk/aws-s3-client

Demo for basic s3 functionality in nodejs
https://github.com/ajyounguk/aws-s3-client

amazon-web-services aws bucket cli client demo demo-app harness html node nodejs s3 testing utility

Last synced: about 3 hours ago
JSON representation

Demo for basic s3 functionality in nodejs

Awesome Lists containing this project

README

        

## AWS S3 Client

## What is this?
A web client app that excercises the AWS S3 functionality via the API

![Alt text](/screenshots/s3upload.png)

## 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..