Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/boltops-tools/jack
Wrapper tool to manage AWS Elastic Beanstalk environments
https://github.com/boltops-tools/jack
Last synced: about 1 month ago
JSON representation
Wrapper tool to manage AWS Elastic Beanstalk environments
- Host: GitHub
- URL: https://github.com/boltops-tools/jack
- Owner: boltops-tools
- License: mit
- Created: 2015-03-03T20:11:15.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-08-24T16:38:28.000Z (about 4 years ago)
- Last Synced: 2024-09-21T13:22:20.657Z (about 2 months ago)
- Language: Ruby
- Size: 1.68 MB
- Stars: 26
- Watchers: 8
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Jack and the Elastic Beanstalk
[](https://circleci.com/gh/tongueroo/jack)
[](https://codeclimate.com/github/tongueroo/jack)
[](https://gitter.im/tongueroo/jack?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://boltops.com?utm_source=badge&utm_medium=badge&utm_campaign=jack)
[](https://www.boltops.com)
Jack allows you to easily manage your AWS Elastic Beanstalk Jack environments.
Jack provides a `jack apply` command to update the Elastic Beanstalk environment. Before uploading the new configuration Elastic Beanstalk jack first downloads the current configuration and then does a diff on the changes that are about to be applied. This gives a preview of exactly what will be changed. This is particularly helpful when changes are made through the EB GUI and are out of sync with what is stored in the downloaded `jack/cfg` files.
See [jack-eb.com](http://jack-eb.com) for full documentation.
This blog post also provides a good introduction and shows off useful examples of what you can do with the jack tool: [Jack and the Elastic Beanstalk — Tool to Manage AWS Elastic Beanstalk Environments](https://medium.com/@tongueroo/jack-and-the-elastic-beanstalk-easily-manage-aws-environments-3ab496f08ad2#.o7w3x0yd9).
## Use Cases
* Allows codification of the infrastructure by downloading the configuration. You can save the downloaded configs into version control.
* Safely upload new configs by previewing the changes before actually uploading and applying the configuration to the infrastructure.
* Moving EB enviroments from one EB application to another EB application. EB provides a way to clone environments within an application but is unable to move the enivornment to an entirely new application. This is useful if you want to "rename" the EB application.
## Installation
Install jack with RubyGems:
```sh
gem install jack-eb
```
Note that the gem is called jack-eb but the actual command that is installed is called `jack`. If you are installing jack with RubyGems you will need to handle installing the additional dependencies yourself.
More installation instructions are on the [Installation docs](http://jack-eb.com/docs/install/).
## Conventions
Before using the tool, it is good to know that jack follows a convention for the environment and application name. This is done in order to keep the jack commands simple and short. The convention is:
environment_name: [app]-[role]-[env]
application_name: [app]
A concrete example is helpful:
environment_name: hi-web-prod
application_name: hi
The example above means the EB application name will be `hi` and the environment name will be `hi-web-prod`. By convention, the first word, separated by a '-', of the environment name is the application name. This convention can be overridden easily via by configuring the [settings](http://jack-eb.com/docs/settings/). It is also possible to override the application name convention from the cli with the `--app` flag.
## Quick Usage
Here's a quick overview of how to use jack:
```sh
brew cask install boltopslabs/software/bolts
git clone https://github.com/tongueroo/hi # demo sinatra app
cd hi
jack create hi-web-stag # creates a EB App named hi and EB Environment named hi-web-stag
jack download hi-web-stag
# ... make adjustments to jack/cfg/hi-web-stag.yml ...
jack upload hi-web-stag
```
See [jack-eb.com](http://jack-eb.com) for full documentation.
## Contributing
Everyone can contribute to make jack better. Please fork the project and open a pull request! We love your pull requests. Contributions are encouraged and welcomed!
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request