https://github.com/neoskop/s3surgeon
Sync your files to AWS S3 with surgical precision.
https://github.com/neoskop/s3surgeon
aws cli cloudfront s3
Last synced: about 1 year ago
JSON representation
Sync your files to AWS S3 with surgical precision.
- Host: GitHub
- URL: https://github.com/neoskop/s3surgeon
- Owner: neoskop
- License: apache-2.0
- Created: 2019-04-26T09:06:45.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-04-14T01:41:17.000Z (about 1 year ago)
- Last Synced: 2025-04-14T18:08:23.446Z (about 1 year ago)
- Topics: aws, cli, cloudfront, s3
- Language: TypeScript
- Homepage: https://neolabs.io
- Size: 1.32 MB
- Stars: 5
- Watchers: 3
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# s3surgeon
Sync your files to [AWS S3][1] with surgical precision.
## Overview
When using `aws s3 sync` to synchronize local files with a S3 bucket, the CLI will only compare file sizes and timestamps. `s3surgeon` instead only compares the respective file hashes.
## Quickstart
Install the CLI by installing the NPM package `s3surgeon` as a global dependency:
```bash
$ npm i -g s3surgeon
```
You can sync all files from the current directory to an S3 bucket like so:
```bash
$ s3surgeon \
--access-key-id \
--secret-access-key
--bucket
Upload: foo.txt
Upload: foo/bar.bar
```
For a complete reference of available switches and options run:
```bash
$ s3surgeon -h
```
## Non-AWS-Usage
For an example on how to use `s3surgeon` with MinIO instead of AWS S3 see `docker-compose.yml`
## License
This project is under the terms of the Apache License, Version 2.0. A copy of this license is included with the sources.
[1]: https://aws.amazon.com/de/s3/