Skip to content
/ sinker Public

Sinker synchronises a directory from your filesystem into an AWS S3 bucket

License

Notifications You must be signed in to change notification settings

thtg88/sinker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sinker

Sinker is a Go executable that synchronises files from a given folder into an AWS S3 bucket.

Please note: this executable only watches for changed files if the executable is running. It will not update files if it was not executing when they have changed.

Requirements

Go installed on your machine. On macOS you can install it via Homebrew with:

brew install go

Make sure to create a user in AWS IAM that has read and write access to your S3 bucket of choice. If you are uncertain what policy to give you can use the following JSON payload to give full rights (not only read/write) to your user on the bucket of choice:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:*",
            "Resource": [
                "arn:aws:s3:::your-bucket-name-here",
                "arn:aws:s3:::your-bucket-name-here/*"
            ]
        }
    ]
}

Setup

Clone the project on your machine:

git clone git@github.com:thtg88/sinker.git

Copy .env.example contents to a .env in the same directory.

Make sure to set the correct env variables:

  • AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY: the access key ID and secret of an AWS user which has read and write access on your AWS S3 bucket
  • AWS_BUCKET: the actual S3 bucket you want to write to
  • SINKER_BASE_PATH: the base directory on your machine, which you want to keep synchronised

Usage

go run .

About

Sinker synchronises a directory from your filesystem into an AWS S3 bucket

Resources

License

Stars

Watchers

Forks

Releases

No releases published