Skip to content

Drop-in docker-based CLI replacement for s3cmd for systems (like macos) where s3cmd doesn't work properly

License

Notifications You must be signed in to change notification settings

sam0x17/s3cmd-shim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

s3cmd shim

This docker image provides a working s3cmd CLI tool that can be used as a drop-in replacement for a local s3cmd installation on systems where certain features of s3cmd are not currently functioning. In particular, I created this to get around the fact that support for the cf-invalidate option on macos has been broken since 2018. I have also written a medium article on the subject.

Linux and Macos are supported. Windows will work but you will need to write your own s3cmd script as a .bat file.

Prerequisites

  1. docker must be installed and enabled for non-root users
  2. your system must have curl installed (basically every system does)

Installation

Simply run this in a terminal:

curl -o- https://raw.githubusercontent.com/sam0x17/s3cmd-shim/master/install.sh | bash

Now re-open your terminal and you'll be all set.

You can now use s3cmd on your host system as you normally would, and integration should be fully seamless.

The script will set up your environment so that the latest s3cmd shell script is located at ~/.s3cmd_shim/s3cmd and will add this to your PATH. If you use ash or zsh or fish or something weird you may have to manually add ~/.s3cmd_shim/ to your PATH.

Updating / Uninstalling

  • To uninstall, clone the repo, cd into it and run ./uninstall.sh. If you care enough, you can also manually remove the PATH entries from the usual locations.
  • To update, just re-run the installation one-liner and you should be good to go.

Status

  • tested and working, even on macos
  • working with absolute paths
  • tested with current directory based paths
  • tested with relative paths (should work fine)

About

Drop-in docker-based CLI replacement for s3cmd for systems (like macos) where s3cmd doesn't work properly

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published