github.com/jmbataller/terraform@v0.6.8-0.20151125192640-b7a12e3a580c/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  description: |-
     6    Provides a Heroku App resource. This can be used to create and manage applications on Heroku.
     7  ---
     8  
     9  # heroku\_app
    10  
    11  Provides a Heroku App resource. This can be used to
    12  create and manage applications on Heroku.
    13  
    14  ## Example Usage
    15  
    16  ```
    17  # Create a new Heroku app
    18  resource "heroku_app" "default" {
    19      name = "my-cool-app"
    20      region = "us"
    21  
    22      config_vars {
    23          FOOBAR = "baz"
    24      }
    25  }
    26  ```
    27  
    28  ## Argument Reference
    29  
    30  The following arguments are supported:
    31  
    32  * `name` - (Required) The name of the application. In Heroku, this is also the
    33     unique ID, so it must be unique and have a minimum of 3 characters.
    34  * `region` - (Required) The region that the app should be deployed in.
    35  * `stack` - (Optional) The application stack is what platform to run the application
    36     in.
    37  * `config_vars` - (Optional) Configuration variables for the application.
    38       The config variables in this map are not the final set of configuration
    39       variables, but rather variables you want present. That is, other
    40       configuration variables set externally won't be removed by Terraform
    41       if they aren't present in this list.
    42  * `organization` - (Optional) A block that can be specified once to define
    43       organization settings for this app. The fields for this block are
    44       documented below.
    45  
    46  The `organization` block supports:
    47  
    48  * `name` (string) - The name of the organization.
    49  * `locked` (boolean)
    50  * `personal` (boolean)
    51  
    52  ## Attributes Reference
    53  
    54  The following attributes are exported:
    55  
    56  * `id` - The ID of the app. This is also the name of the application.
    57  * `name` - The name of the application. In Heroku, this is also the
    58     unique ID.
    59  * `stack` - The application stack is what platform to run the application
    60     in.
    61  * `region` - The region that the app should be deployed in.
    62  * `git_url` - The Git URL for the application. This is used for
    63     deploying new versions of the app.
    64  * `web_url` - The web (HTTP) URL that the application can be accessed
    65     at by default.
    66  * `heroku_hostname` - A hostname for the Heroku application, suitable
    67     for pointing DNS records.
    68  * `all_config_vars` - A map of all of the configuration variables that
    69      exist for the app, containing both those set by Terraform and those
    70      set externally.