bunker is a command line program for setting up an ec2 in AWS for remote development or as a backup. It can clone your git repos, and transfer ignored files from your machine to the ec2.
Bunker is a command line program for setting up an ec2 in AWS for remote development or as a backup. Among other things, it can clone your git repos and transfer ignored files from your machine to the ec2.
Working remotely, using cellular networks has been possible for ~15 years. As networks have evolved, bandwidth has become less and less of an issue, but even on today's cellular networks it is both impractical and costly to download large files, like docker images, zip archives, etc. One solution is to ssh into a VM on the cloud, and work from there, but managing git repos and private or ignored files across several machines quickly becomes problematic.
With bunker it is easier to automate this process. All you need is an instance ID for and AWS EC2 running ubuntu, and you can run shell scripts, source files to .profile, and copy over as many repos and ignored files as you want. Example:
# init bunker with your instance ID, etc $ bunker init # save some files to the ignored files list $ bunker ignore config.ini .env.production terraform.tfvars # run `/home/ubuntu/install-things.sh` on the instance $ bunker install /home/ubuntu/install-things.sh # source `/home/ubuntu/.prompt` to the .profile on the instance $ bunker prompt /home/ubuntu/.prompt # clone a local repo on the instance, and then copy over any files from the ignored file list $ bunker build -r /path/to/local/repo
When used with our sample Terraform files (https://gitlab.com/shindagger/bunker), you can spin up a brand new EC2, clone the repos you need, copy over the ignored files, and be working in ~5 minutes. Terraform will output an instance ID you can use for
bunker init. Then you can do the rest with a single command like:
$ bunker install -y && bunker prompt -y && bunker build -r /path/to/local/repo -y
For more information see the Terraform and Usage sections below.
- aws cli
Also, you will need an EC2 instance on AWS, preferably running ubuntu>=18.04. This EC2 will need ssh (port 22) open and an attached SSM role (AmazonEC2RoleforSSM).
For more information on creating the SSM role for EC2 see:
$ pip intall aws-bunker
NOTE: see shell scripts, and terraform sections below:
PROJECT HOME PAGE: https://gitlab.com/shindagger/bunker
prompt subcommands assume there will be shell scripts on the EC2. The default names (without positional arguments) are:
the first shell script is intended for essential software (like python, pip, node, and npm). If the script is not already executable, use the [-e] flag.
prompt simply sources a file in ~/.profile on the EC2.
See example scripts here (https://gitlab.com/shindagger/bunker) as well as the terraform section below:
We have also included terraform files (https://gitlab.com/shindagger/bunker) which, when configured will spin up an EC2 instance you can use for bunker, with all the example shell scripts and your
.vimrc provisioned. Of course you're encouraged to change these files according to preference. Terraform will output an instance ID you can use to init bunker with.
To configure and use these terraform files:
Clone this repo (https://gitlab.com/shindagger/bunker.git)
cd into the repo dir and
ls *.default. These are the files you will need to edit before you init terraform. Each one of these files will need the extension
alfa.tfand ensure that the region is correct.
beta.tfand change the s3 bucket to a bucket you own. Also ensure the region is correct.
terraform.tfvarswith your AWS SDK access id and key. Also make sure you are configured to this account with
variables.tfand change the default values to reflect your wishes. NOTE: if you don't have them already, you will need to create your own ssm role, and ssh key file manually.
ec2_key_nameis just the name of the keypair in AWS, while
ssh_private_keyis the full (absolute) path to your .pem file on your local machine.
terraform plan && terraform apply
before you init bunker
You have an EC2 instance ID. (see "terraform" above)
You have a directory (prefix) in which you will keep
ignoredfiles.txt. You can copy sample files from this repo, and edit them to reflect your repos and ignored files.
You have a .pem file and you know the path to its location. You have a keypair name set for your EC2, which uses this .pem file.
You know the username for the EC2 (should be "ubuntu"). We may choose to support other OSs in future versions.
You have created a private key for your git provider, and you added the public key in your git provider settings. Also, you have configured your local ssh to use this key and tested or used it at least once.
$ bunker -h
Show main bunker help page and exit
$ bunker build -h
Show help page for the subcommand
build and exit. This will work with any available subcommand
$ bunker init
Write the bunker config file
~/.config-bunker.ini. If the file exists already, answers will be populated with existing values [underlined], and only overwritten if you offer a replacement value.
[default] prefix = /Users/username/bunker-config repos = repositories.txt ignored = ignoredfiles.txt pem = /Users/username/somename.pem instance_id = i-04xxxxxxxxxxxx148 username = ubuntu gitkeys = /Users/username/.ssh/git_rsa
$ bunker repo path/to/repo /absolute/path/to/another-repo ../somerepo
Add or remove repo directories to/from repo file. Use relative or absolute paths.
$ bunker ignore .env.local config.ini terraform.tfvars
Add or remove filenames to/from ignore file.
$ bunker install
$ bunker install /home/ubuntu/script.sh
Install essential software on your EC2 instance. This command will run an executable shell script on your EC2. The default script (without defining the positional argument) is named
/home/ubuntu/install-essentials.sh. This is intended to install any software essential to using your EC2. In an effort to stay agnostic about what software users want on their EC2, bunker does not install with included shell scripts. We do however provide example shell scripts (as well as terraform for the EC2) at the project homepage:
$ bunker prompt
$ bunker prompt /home/ubuntu/another-prompt.sh
Source a custom prompt file in
/home/ubuntu/.profile. This command will source a file in
/home/ubuntu/.profile. The default name is:
$ bunker build
Clone list of git repos (repositories.txt) on your EC2 and then rsync list of ignored files (ignoredfiles.txt) from your local repos to the EC2 repos.
git clone will use ssh, assuming you have a public key setup at your git provider, a working
~/.ssh/config tested at least once with
ssh -T git@PROVIDERURL, and the associated private key set using
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size aws_bunker-0.4.5-py3-none-any.whl (26.6 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size aws-bunker-0.4.5.tar.gz (15.3 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for aws_bunker-0.4.5-py3-none-any.whl