Skip to main content

Create S3 buckets in seconds from your command line to use on your website.

Project description

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

Homebrew

Buckup can be installed from Torchbox’s Homebrew tap.

brew tap torchbox/tap
brew install buckup

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.

Screenshot of buckup’s command line output, showing the creation of a test bucket

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

buckup-0.2.tar.gz (10.5 kB view details)

Uploaded Source

Built Distribution

buckup-0.2-py3-none-any.whl (10.5 kB view details)

Uploaded Python 3

File details

Details for the file buckup-0.2.tar.gz.

File metadata

  • Download URL: buckup-0.2.tar.gz
  • Upload date:
  • Size: 10.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for buckup-0.2.tar.gz
Algorithm Hash digest
SHA256 7e6bb972ba74f648bac6f7d1d956a706ef00a1367cabbf084fba609ae4d9b649
MD5 87d0ea08eb96bde4e835395da6b1eaa7
BLAKE2b-256 d45ad02f05a2cdf8cf75fb5d72abdf749c990c8f760e272eedf5fa273158cbca

See more details on using hashes here.

File details

Details for the file buckup-0.2-py3-none-any.whl.

File metadata

  • Download URL: buckup-0.2-py3-none-any.whl
  • Upload date:
  • Size: 10.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for buckup-0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 54f80f3b12d0b367e5088921d481c9ff33fbf28b2a969693e51f173b9d9056f3
MD5 c2caa09917a6d11835830b395ff30cb8
BLAKE2b-256 032757aeb22bae59d2ebbec7c202f11613937536e2b3fda889f1eba183fef83c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page