terraform/website/source/docs/providers/heroku/r/pipeline_coupling.html.markdown

layout	page_title	sidebar_current	description
heroku	Heroku: heroku_pipeline_coupling	docs-heroku-resource-pipeline-coupling	Provides a Heroku Pipeline Coupling resource.

heroku_pipeline_coupling

Provides a Heroku Pipeline Coupling resource.

A pipeline is a group of Heroku apps that share the same codebase. Once a pipeline is created using heroku_pipeline, and apps are added to different stages using heroku_pipeline_coupling, you can promote app slugs to the downstream stages.

Example Usage

# Create Heroku apps for staging and production
resource "heroku_app" "staging" {
  name = "test-app-staging"
}

resource "heroku_app" "production" {
  name = "test-app-production"
}

# Create a Heroku pipeline
resource "heroku_pipeline" "test-app" {
  name = "test-app"
}

# Couple apps to different pipeline stages
resource "heroku_pipeline_coupling" "staging" {
  app      = "${heroku_app.staging.name}"
  pipeline = "${heroku_pipeline.test-app.id}"
  stage    = "staging"
}

resource "heroku_pipeline_coupling" "production" {
  app      = "${heroku_app.production.name}"
  pipeline = "${heroku_pipeline.test-app.id}"
  stage    = "production"
}

Argument Reference

The following arguments are supported:

• app - (Required) The name of the app for this coupling.
• pipeline - (Required) The ID of the pipeline to add this app to.
• stage - (Required) The stage to couple this app to. Must be one of review, development, staging, or production.

Attributes Reference

The following attributes are exported:

• id - The UUID of this pipeline coupling.
• app - The name of the application.
• pipeline - The UUID of the pipeline.
• stage - The stage for this coupling.