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.1a7.tar.gz (10.3 kB view details)

Uploaded Source

Built Distribution

buckup-0.1a7-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file buckup-0.1a7.tar.gz.

File metadata

  • Download URL: buckup-0.1a7.tar.gz
  • Upload date:
  • Size: 10.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.3

File hashes

Hashes for buckup-0.1a7.tar.gz
Algorithm Hash digest
SHA256 ca5f521e1856084a11941e5920231848274dd27d613dbf81b313a115d96afb4e
MD5 98acfb2cc690a410d0f7f67814f19d46
BLAKE2b-256 9912c81eddaa26f13190693a7afafd9ce5bf6cc51065ab8d3a3c70833a243561

See more details on using hashes here.

File details

Details for the file buckup-0.1a7-py3-none-any.whl.

File metadata

  • Download URL: buckup-0.1a7-py3-none-any.whl
  • Upload date:
  • Size: 10.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.3

File hashes

Hashes for buckup-0.1a7-py3-none-any.whl
Algorithm Hash digest
SHA256 7dc0449e193b53bc2b564ef98edb8468b7bec2818ae724e7ac76e53fb5b1405e
MD5 6f7200f1822cd3c7e61d66fd46470491
BLAKE2b-256 3567e9c2211a24af26b03e88ba953f05271d576dc4b1eeb39cf2ea2ba37d9fcb

See more details on using hashes here.

Supported by

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