github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/heroku/r/pipeline_coupling.html.markdown (about)

     1  ---
     2  layout: "heroku"
     3  page_title: "Heroku: heroku_pipeline_coupling"
     4  sidebar_current: "docs-heroku-resource-pipeline-coupling"
     5  description: |-
     6    Provides a Heroku Pipeline Coupling resource.
     7  ---
     8  
     9  # heroku\_pipeline\_coupling
    10  
    11  
    12  Provides a [Heroku Pipeline Coupling](https://devcenter.heroku.com/articles/pipelines)
    13  resource.
    14  
    15  A pipeline is a group of Heroku apps that share the same codebase. Once a
    16  pipeline is created using [`heroku_pipeline`](./pipeline), and apps are added
    17  to different stages using `heroku_pipeline_coupling`, you can promote app slugs
    18  to the downstream stages.
    19  
    20  ## Example Usage
    21  
    22  ```hcl
    23  # Create Heroku apps for staging and production
    24  resource "heroku_app" "staging" {
    25    name = "test-app-staging"
    26  }
    27  
    28  resource "heroku_app" "production" {
    29    name = "test-app-production"
    30  }
    31  
    32  # Create a Heroku pipeline
    33  resource "heroku_pipeline" "test-app" {
    34    name = "test-app"
    35  }
    36  
    37  # Couple apps to different pipeline stages
    38  resource "heroku_pipeline_coupling" "staging" {
    39    app      = "${heroku_app.staging.name}"
    40    pipeline = "${heroku_pipeline.test-app.id}"
    41    stage    = "staging"
    42  }
    43  
    44  resource "heroku_pipeline_coupling" "production" {
    45    app      = "${heroku_app.production.name}"
    46    pipeline = "${heroku_pipeline.test-app.id}"
    47    stage    = "production"
    48  }
    49  ```
    50  
    51  ## Argument Reference
    52  
    53  The following arguments are supported:
    54  
    55  * `app` - (Required) The name of the app for this coupling.
    56  * `pipeline` - (Required) The ID of the pipeline to add this app to.
    57  * `stage` - (Required) The stage to couple this app to. Must be one of
    58  `review`, `development`, `staging`, or `production`.
    59  
    60  ## Attributes Reference
    61  
    62  The following attributes are exported:
    63  
    64  * `id` - The UUID of this pipeline coupling.
    65  * `app` - The name of the application.
    66  * `pipeline` - The UUID of the pipeline.
    67  * `stage` - The stage for this coupling.