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

     1  ---
     2  layout: "heroku"
     3  page_title: "Heroku: heroku_pipeline_"
     4  sidebar_current: "docs-heroku-resource-pipeline-x"
     5  description: |-
     6    Provides a Heroku Pipeline resource.
     7  ---
     8  
     9  # heroku\_pipeline
    10  
    11  
    12  Provides a [Heroku Pipeline](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, and apps are added to different stages using
    17  [`heroku_pipeline_coupling`](./pipeline_coupling.html), you can promote app
    18  slugs to the next stage.
    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  * `name` - (Required) The name of the pipeline.
    56  
    57  ## Attributes Reference
    58  
    59  The following attributes are exported:
    60  
    61  * `id` - The UUID of the pipeline.
    62  * `name` - The name of the pipeline.