# nginx-s3-upload

Uploads files to s3 bucket. Basically an [nginx](http://nginx.org/en/docs/) which `proxy_pass` `HTTP POST` requests to [S3](https://aws.amazon.com/s3) directly

## Configuration
Environment variables are used to provide configuration.

  | Variable name  | Comment |
  |----------------|---------|
  | S3_BUCKET_NAME | Mandatory |
  | AWS_REGION | Mandatory |
  | RETURN_URL | Mandatory |
  | AWS_ACCESS_KEY_ID | Optional - will be fetched from IAM policy on AWS |
  | AWS_SECRET_ACCESS_KEY | Optional - will be fetched from IAM policy on AWS |


## Testing
    docker run --rm --env AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID} --env AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY} --env S3_BUCKET_NAME=upload.example.com --env AWS_REGION=eu-west-1 --env RETURN_URL=images.example.com -p 8000:80 gitlab.com/unboundsoftware/nginx-s3-upload:1.1.0

Try it out:

    curl localhost:8000/upload -d 'some data' -v
    ...
    > PUT /upload HTTP/1.1
     ...
    < X-File-URL: https://images.example.com/59389abb021973a41d05e0d7d79949b17b83b142058a3704c98f274b6e563cfc403e64db6550f233
    ...

The header `X-File-URL` will contain the URL to the uploaded file.