github.com/bengesoff/terraform@v0.3.1-0.20141018223233-b25a53629922/website/source/docs/providers/heroku/r/app.html.markdown (about)

     1  ---
     2  layout: "heroku"
     3  page_title: "Heroku: heroku_app"
     4  sidebar_current: "docs-heroku-resource-app"
     5  ---
     6  
     7  # heroku\_app
     8  
     9  Provides a Heroku App resource. This can be used to
    10  create and manage applications on Heroku.
    11  
    12  ## Example Usage
    13  
    14  ```
    15  # Create a new heroku app
    16  resource "heroku_app" "default" {
    17      name = "my-cool-app"
    18  
    19      config_vars {
    20          FOOBAR = "baz"
    21      }
    22  }
    23  ```
    24  
    25  ## Argument Reference
    26  
    27  The following arguments are supported:
    28  
    29  * `name` - (Required) The name of the application. In Heroku, this is also the
    30     unique ID, so it must be unique and have a minimum of 3 characters.
    31  * `region` - (Required) The region that the app should be deployed in.
    32  * `stack` - (Optional) The application stack is what platform to run the application
    33     in.
    34  * `config_vars` - (Optional) Configuration variables for the application.
    35       The config variables in this map are not the final set of configuration
    36       variables, but rather variables you want present. That is, other
    37       configuration variables set externally won't be removed by Terraform
    38       if they aren't present in this list.
    39  * `organization` - (Optional) The organization name to create the application
    40      under. You must have the correct permissions for this organization on Heroku to
    41      create new applications inside an organization.
    42  
    43  
    44  ## Attributes Reference
    45  
    46  The following attributes are exported:
    47  
    48  * `id` - The ID of the app. This is also the name of the application.
    49  * `name` - The name of the application. In Heroku, this is also the
    50     unique ID.
    51  * `stack` - The application stack is what platform to run the application
    52     in.
    53  * `region` - The region that the app should be deployed in.
    54  * `git_url` - The Git URL for the application. This is used for
    55     deploying new versions of the app.
    56  * `web_url` - The web (HTTP) URL that the application can be accessed
    57     at by default.
    58  * `heroku_hostname` - A hostname for the Heroku application, suitable
    59     for pointing DNS records.
    60  * `all_config_vars` - A map of all of the configuration variables that
    61      exist for the app, containing both those set by Terraform and those
    62      set externally.