» heroku_formation

A formation represents the formation of processes that should be set for an application.

NOTE: - The application must have a dyno in order to update its formation. - If the heroku formation resource is removed and deleted, this will be a no-op action in Heroku. The Heroku Platform does not have a DELETE endpoint for formation. - This resource works well with the heroku_app_release resource, which allows you to deploy a slug/release to an application before the formation can be updated.

» Example Usage

# Creates a new application called foobar
resource "heroku_app" "foobar" {
    name = "foobar"
    region = "us"
}

# Creates a new release for application foobar using a slug id
resource "heroku_app_release" "foobar-release" {
    app = "${heroku_app.foobar.name}"
    slug_id = "01234567-89ab-cdef-0123-456789abcdef"
}

# Update the web formation for the foobar application's web
resource "heroku_formation" "foobar-web" {
    app = "${heroku_app.foobar.name}"
    type = "web"
    quantity = 2
    size = "standard-2x"

    # Tells Terraform that this formation must be created/updated only after the app release has been created
    depends_on = ["heroku_app_release.foobar-release"]
}

» Argument Reference

app - (Required) The name of the application
type - (Required) type of process such as "web"
quantity - (Required) number of processes to maintain
size - (Required) dyno size (Example: “standard-1X”). Capitalization does not matter.

» Attributes Reference

The following attributes are exported:

id - The ID of the formation

» Import

Existing formations can be imported using the combination of the application name, a colon, and the formation's type.

For example:

$ terraform import heroku_formation.foobar-web foobar:web