Instapusher
Makes it easy to push to heroku.
Installation
gem install instapusher
Usage
instapusher
It detects a project name and a branch from the git repo. Else you can specify it from the command line like:
instapusher rails master
After installing the gem you should register in the http://instapusher.com
.
Setup a project using the user and project name from the github. And create a config file .instapusher
with api key.
Example:
api_key: 123123123
Setup Instapusher server
You can provide the env variable LOCAL
like:
instapusher --local
To enable debug messages do
instapusher --debug
Enable quick option as shown below. In the quick mode only code is pushed. No migration is done. No config environment is set. So it is much faster and it leaves the data intact.
instapusher --quick
Pass host info like this
INSTAPUSHER_HOST=instapusher.com instapusher
Also there are other env variables like INSTAPUSHER_PROJECT
and INSTAPUSHER_BRANCH
.
INSTAPUSHER_HOST=instapusher.com INSTAPUSHER_PROJECT=rails INSTAPUSHER_BRANCH=master instapusher
ALSO you can pass your api_key
API_KEY=xxxx instapusher
What problem it solves
Here at BigBinary we create a separate branch for each feature we work
on. Let's say that I am working on authentication with facebook
.
When I am done with the feature then I send pull request to my team
members to review. However in order to review the work all the team
members need to pull down the branch and fire up rails server
and then
review.
We like to see things working. So we developed instapusher
to push a
feature branch to heroku instantly with one command. Executing
instapusher
prints a url and we put that url in the pull request so
that team members can actually test the feature.
Here is how it works
Lets say that I am working with github project nimbleshop
in a branch called
76-facebook-authentication
. When I execute instapusher
then the
application name under which it will be deployed to heroku will be
nimbleshop-76-facebook-ip
.
nimbleshop
is the name of the project.
76-facebook
is the first 10 letters of the branch name.
ip
is characters to mark the instance as temporal.
So in this case the url of the application will be
http://nnimbleshop-76-facebook-ip.herokuapp.com
.
There are three special branches master
, staging
and production
.
For these branches the url generated will be just the application name and the
branch name. For example if I execute instapusher
from staging
branch then the heroku url will be
http://nimbleshop-staging.herokuapp.com
.
License
instapusher
is released under MIT License.