vaguerent/website/source/docs/push/heroku.html.md
Seth Vargo 5093f3120e Merge docs and www into a single static site
This is a big commit, and I apologize in advance for the future
git-blames all pointing to me. This commit does a few things:

1.  Merges the website/docs and website/www repo into a single website repo
    to be in line with other HashiCorp projects
2.  Updates to use middleman-hashicorp
3.  Converts less to scss to be in line with other projects
4.  Updates page styles to be in line with other projects
5.  Optimizes images
6.  Prepare for S3 + Fastly deployment with scripts, etc.
7.  Removes blog posts (they have been transferred to hashicorp.com with
    redirects in place
8.  Updated sitemap generation script for better SEO
9.  Fixed many broken links
10. Add description to all fields
2016-01-19 14:35:05 -05:00

63 lines
2.0 KiB
Markdown

---
layout: "docs"
page_title: "Vagrant Push - Heroku Strategy"
sidebar_current: "push-heroku"
description: |-
The Vagrant Push Heroku strategy pushes your application's code to Heroku.
Only files which are committed to the Git repository are pushed to Heroku.
---
# Vagrant Push
## Heroku Strategy
[Heroku][] is a public PAAS provider that makes it easy to deploy an
application. The Vagrant Push Heroku strategy pushes your application's code to
Heroku.
<div class="alert alert-warning">
<strong>Warning:</strong> The Vagrant Push Heroku strategy requires you
have configured your Heroku credentials and created the Heroku application.
This documentation will not cover these prerequisites, but you can read more
about them in the <a href="https://devcenter.heroku.com">Heroku documentation</a>.
</div>
Only files which are committed to the Git repository will be pushed to Heroku.
Additionally, the current working branch is always pushed to the Heroku, even if
it is not the "master" branch.
The Vagrant Push Heroku strategy supports the following configuration options:
- `app` - The name of the Heroku application. If the Heroku application does not
exist, an exception will be raised. If this value is not specified, the
basename of the directory containing the `Vagrantfile` is assumed to be the
name of the Heroku application. Since this value can change between users, it
is highly recommended that you add the `app` setting to your `Vagrantfile`.
- `dir` - The base directory containing the Git repository to upload to Heroku.
By default this is the same directory as the Vagrantfile, but you can specify
this if you have a nested Git directory.
- `remote` - The name of the Git remote where Heroku is configured. The default
value is "heroku".
### Usage
The Vagrant Push Heroku strategy is defined in the `Vagrantfile` using the
`heroku` key:
```ruby
config.push.define "heroku" do |push|
push.app = "my_application"
end
```
And then push the application to Heroku:
```shell
$ vagrant push
```
[Heroku]: https://heroku.com/ "Heroku"