Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Fixed task configuration image source.

You can use the Amazon ECS Service task to create, update or delete an Amazon EC2 Container Service (ECS) service (see Deploying to Amazon ECS for an overview of the ECS component lifecycle and deployment workflow).

Image Added

Image Removed 

Panel
borderColor#bbb
bgColor#eeeeee

On this page:

Table of Contents
exclude(Popular.*|Recent.*)

Panel
borderColor#bbb
bgColor#eeeeee

Related Pages:

Configuration

To configure an Amazon ECS Service task:

  1. Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).
  2. Click the name of an existing Amazon ECS Service task, or click Add Task and then Amazon ECS Service to create a new task.
  3. Complete the following settings:

    1. Common to all tasks

      Include Page
      _CommonTaskParametersTable
      _CommonTaskParametersTable

    2. Actions supported by this task:

       

      Create

       
      Cluster Name or ARN

      (Optional) Specify the short name or full Amazon Resource Name (ARN) of the cluster that you want to run your service on.

      •  (warning) If you do not specify a cluster, the default cluster is assumed. 
      ServiceSpecify the name of the service you want to create.
      Task Definition(Optional) Specify the family and revision (family:revision) or full Amazon Resource Name (ARN) of the task definition that you want to run in your service.
      Desired Count(Optional) Specify the  number of instantiations of the specified task definition that you would like to place and keep running on your cluster.
      Load Balancers(Optional) Specify one or more load balancer objects in JSON format, containing the load balancer name, the container name (as it appears in a container definition), and the container port to access from the load balancer.
      Role

      (Conditional) Specify the name or full Amazon Resource Name (ARN) of the IAM role that allows your Amazon ECS container agent to make calls to your load balancer on your behalf.

      •  (info)  This parameter is only required if you are using a load balancer with your service.
      Generated Variables
      Code Block
      languagetext
      linenumberstrue
      Creating common variables for 1 services:
      ... custom.aws.ecs.service.resources: taws-it-270-nginx
      Creating resource variables for service 'taws-it-270-nginx':
      ... custom.aws.ecs.service.resources.taws-it-270-nginx.ClusterArn: arn:aws:ecs:us-east-1:309600995652:cluster/taws-it-270-29
      ... custom.aws.ecs.service.resources.taws-it-270-nginx.RoleArn: arn:aws:iam::309600995652:role/amazon-ecs-service
      ... custom.aws.ecs.service.resources.taws-it-270-nginx.ServiceArn: arn:aws:ecs:us-east-1:309600995652:service/taws-it-270-nginx
      ... custom.aws.ecs.service.resources.taws-it-270-nginx.ServiceName: taws-it-270-nginx
      ... custom.aws.ecs.service.resources.taws-it-270-nginx.Status: ACTIVE
      ... custom.aws.ecs.service.resources.taws-it-270-nginx.TaskDefinition: arn:aws:ecs:us-east-1:309600995652:task-definition/taws-it-270-nginx:59
      Creating common variables for first resource affected by task:
      Creating resource variables for service 'taws-it-270-nginx':
      ... custom.aws.ecs.service.first.ClusterArn: arn:aws:ecs:us-east-1:309600995652:cluster/taws-it-270-29
      ... custom.aws.ecs.service.first.RoleArn: arn:aws:iam::309600995652:role/amazon-ecs-service
      ... custom.aws.ecs.service.first.ServiceArn: arn:aws:ecs:us-east-1:309600995652:service/taws-it-270-nginx
      ... custom.aws.ecs.service.first.ServiceName: taws-it-270-nginx
      ... custom.aws.ecs.service.first.Status: ACTIVE
      ... custom.aws.ecs.service.first.TaskDefinition: arn:aws:ecs:us-east-1:309600995652:task-definition/taws-it-270-nginx:59	

      Update

       
      Cluster Name or ARNsee Create above
      ServiceSpecify the name of the service you want to update.
      Task Definitionsee Create above
      Desired Countsee Create above
      Generated Variablessee Create above

      Delete

       
      Cluster Name or ARNsee Create above
      ServiceSpecify the name of the service you want to delete.
      Generated Variablessee Create above

Variables

Include Page
_VariablesNote
_VariablesNote

Frequently Asked Questions (FAQ)

Questionslist macro
filterrecent
asktrue
limit8
topicamazon-ecs

number of instantiations of the specified task definition that you would like to place and keep running on your cluster.