sudo aptitude install s3cmd
Once installed, I found
s3cmd --help was surprisingly helpful. To start with you need to set up an access key on AWS (Amazon Web Services) using your amazon user credentials, then supply this to s3cmd by using
s3cmd --configure and following the prompts.
Working with Buckets
S3 storage works on "buckets" which seem to be like root directories for virtual hosts (hold the walrus jokes, please). These must have unique names across the whole of S3 so some organisation-specific prefixing may be needed here, but the command looks something like:
The bucket name starts with s3:// to denote that it is accessed on S3.
To put files onto S3 there are two commands. For one file, you use
s3cmd put which takes the source and target and copies the file accordingly. For more files, s3cmd has a really handy sync command which will accept a directory as the source argument and a bucket or path as the target, and literally sync the two. I found this very helpful as I had 40+ podcasts to move!
To see what is in a bucket use
s3cmd ls and the name of the bucket. This lists all the files, and you can use the
s3cmd info command if you want to know more about an individual file such as its size, modified date or permissions. I found it really easy to see what was in the bucket.
Since I'm only using S3 as a replacement for an uploads directory, all the files are publicly accessible. Amazon does provide a comprehensive ACL scheme but I didn't use it so I won't write about it this time. To make everything public, I simply did this:
s3cmd setacl --acl-public --recursive
Once the files are there and public, they are web accessible by replacing their
s3://[bucket]/[filename] address with