Skip to content
Creating S3 buckets for your site with ease.
Python Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
buckup Handle NoCredentialError Jun 27, 2018
.gitignore Add PKGBUILD Aug 10, 2018
CHANGELOG.rst
LICENSE Update license Jun 15, 2018
PKGBUILD Update md5sums in PKGBUILD Mar 19, 2019
README.rst Use python3 pip command explicitly in the README Aug 14, 2018
buckup.spec
logo.png Add logo (#1) Jun 26, 2018
screenshot.png Add screenshot to the README Jun 26, 2018
setup.cfg
setup.py

README.rst

Buckup logo

buckup

Create S3 bucket, policy and user with one command. After creation it is ready to use on your project.

Features

  • Create bucket
  • Enable versioning
  • Set CORS
  • Create user and generate access key pair and give it permissions to the bucket.
  • Set policy to enable s3:GetObject permission on every object in your bucket to the public.

Dependencies

Installation

PyPI (pip)

python3 -m pip install buckup

Arch User Repository

Buckup can be found on AUR.

cd /tmp
git clone https://aur.archlinux.org/buckup.git
cd buckup
makepkg -si

Development build

You can easily install buckup inside a virtual environment and work on it there, e.g.

git clone git@github.com:torchbox/buckup.git
cd buckup
python3 -m venv venv
source venv/bin/activate
pip install -e .
buckup

Usage

  1. First you need an AWS account. You need programmatic access key to use it with buckup.

    • If you have AWS CLI installed, you can save your credentials with aws configure; or
    • you can set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variable containing your credentials.

    Read boto3 documentation for more detail.

    1. If you want to restrict your access only to essential credentials to use buckup, please set them to:
      • iam:ListAccountAliases (not required to use)
      • s3:PutBucketPolicy
      • s3:CreateBucket
      • iam:GetUser
      • iam:CreateUser
      • s3:PutBucketCORS
      • s3:PutBucketVersioning
      • iam:CreateAccessKey
  2. After you set that up, you can type buckup and that should open the prompt.

    1. If you want to specify other than the default region, please use --region flag with buckup, e.g. buckup --region eu-west-2.
  3. After you answer all the questions you should obtain your bucket details that are ready to use in your application.

Buckup screenshot

You can’t perform that action at this time.