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.