github.com/hobbeswalsh/terraform@v0.3.7-0.20150619183303-ad17cf55a0fa/website/source/docs/providers/aws/r/ecs_task_definition.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_ecs_task_definition"
     4  sidebar_current: "docs-aws-resource-ecs-task-definition"
     5  description: |-
     6    Provides an ECS task definition.
     7  ---
     8  
     9  # aws\_ecs\_task\_definition
    10  
    11  Provides an ECS task definition to be used in `aws_ecs_service`.
    12  
    13  ~> **NOTE:** There is currently no way to unregister
    14  any previously registered task definition.
    15  See related [thread in AWS forum](https://forums.aws.amazon.com/thread.jspa?threadID=170378&tstart=0).
    16  
    17  ## Example Usage
    18  
    19  ```
    20  resource "aws_ecs_task_definition" "jenkins" {
    21    family = "jenkins"
    22    container_definitions = "${file("task-definitions/jenkins.json")}"
    23  
    24    volume {
    25      name = "jenkins-home"
    26      host_path = "/ecs/jenkins-home"
    27    }
    28  }
    29  ```
    30  
    31  ## Argument Reference
    32  
    33  The following arguments are supported:
    34  
    35  * `family` - (Required) The family, unique name for your task definition.
    36  * `container_definitions` - (Required) A list of container definitions in JSON format. See [AWS docs](http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html) for syntax.
    37  * `volume` - (Optional) A volume block. Volumes documented below.
    38  
    39  Volumes support the following:
    40  
    41  * `name` - (Required) The name of the volume. This name is referenced in the `sourceVolume` parameter of container definition `mountPoints`.
    42  * `host_path` - (Required) The path on the host container instance that is presented to the container.
    43  
    44  ## Attributes Reference
    45  
    46  The following attributes are exported:
    47  
    48  * `arn` - Full ARN of the task definition (including both `family` & `revision`)
    49  * `family` - The family of the task definition.
    50  * `revision` - The revision of the task in a particular family.