Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated to release 2.6.0.

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).

 


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 Service

       

      Cluster Name or ARN

      (Optional) Specify the

      short

      cluster 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. 
      Service NameSpecify the service 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
      to use.
      Desired Count(Optional) Specify
      the 
      the number of
      instantiations of the specified task definition that you would like to place and keep running on your cluster
      tasks to keep running.
      Placement Strategy(Optional) Specify placement strategy objects in JSON format.
      Placement Constraints(Optional) Specify placement constraint objects in JSON format.
      Deployment Configuration(Optional) Specify the deployment configuration in JSON format – refer to Deployment Configuration for details.
      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
      – refer to Service Load Balancing for details.
      Role

      (Conditional) Specify the name or

      full

      Amazon Resource Name (ARN) of the IAM role that allows

      your Amazon

      the ECS container agent to make calls to

      your

      the load balancer

      on your behalf

      .

      •  (info)
       
      • This parameter is only required
      if you are
      • for services using a load balancer
      with your service
      • .
      Advanced Options
       

      Await Steady State TimeoutSpecify how long to await the service reaching a steady state (seconds, 0 to skip).
      Verify Steady State Period Specify how long to verify the service's state staying steady (seconds, 0 to skip).

      Update Service

       

      Cluster Name or ARNsee Create above
      Service Name or ARNSpecify the
      name of the service you want to update
      service name or Amazon Resource Name (ARN).
      Task Definitionsee Create above
      Desired Countsee Create above
      Deployment Configurationsee Create above
      Advanced Options
       

      Await Steady State Timeoutsee Create above
      Verify Steady State Period see Create above

      Delete Service

       

      Cluster Name or ARNsee Create above
      Service
      Specify the name of the service you want to delete.
      Name or ARN
      see Update above

Variables

Include Page
_VariablesNote
_VariablesNote

Create Service

Code Block
languagetext
linenumberstrue
Creating common variables for 1 services:
... bamboo.custom.aws.ecs.service.resources: tawsTAWS-itIT270-270ECSSE-nginx
Creating resource variables for service 'tawsTAWS-itIT270-270ECSSE-nginx':
... bamboo.custom.aws.ecs.service.resources.tawsTAWS-itIT270-270ECSSE-nginx.ClusterArn: arn:aws:ecs:us-east-1:309600995652:cluster/tawsTAWS-itIT270-27043-29ubot
... bamboo.custom.aws.ecs.service.resources.tawsTAWS-itIT270-270ECSSE-nginx.RoleArn: arn:aws:iam::309600995652:role/amazon-ecs-service
... bamboo.custom.aws.ecs.service.resources.tawsTAWS-itIT270-270ECSSE-nginx.ServiceArn: arn:aws:ecs:us-east-1:309600995652:service/tawsTAWS-itIT270-270ECSSE-nginx
... bamboo.custom.aws.ecs.service.resources.tawsTAWS-itIT270-270ECSSE-nginx.ServiceName: tawsTAWS-itIT270-270ECSSE-nginx
... bamboo.custom.aws.ecs.service.resources.tawsTAWS-itIT270-270ECSSE-nginx.Status: ACTIVE
... bamboo.custom.aws.ecs.service.resources.tawsTAWS-itIT270-270ECSSE-nginx.TaskDefinition: arn:aws:ecs:us-east-1:309600995652:task-definition/taws-it-270-nginx:59TAWS-IT270-ECSSE-nginx:124
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.DesiredCount: 2
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.PendingCount: 0
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.RunningCount: 2
Creating common variables for first resource affected by task:
Creating resource variables for service 'tawsTAWS-itIT270-270ECSSE-nginx':
... bamboo.custom.aws.ecs.service.first.ClusterArn: arn:aws:ecs:us-east-1:309600995652:cluster/tawsTAWS-itIT270-27043-29ubot
... bamboo.custom.aws.ecs.service.first.RoleArn: arn:aws:iam::309600995652:role/amazon-ecs-service
... bamboo.custom.aws.ecs.service.first.ServiceArn: arn:aws:ecs:us-east-1:309600995652:service/tawsTAWS-itIT270-270ECSSE-nginx
... bamboo.custom.aws.ecs.service.first.ServiceName: tawsTAWS-itIT270-270ECSSE-nginx
... bamboo.custom.aws.ecs.service.first.Status: ACTIVE
... bamboo.custom.aws.ecs.service.first.TaskDefinition: arn:aws:ecs:us-east-1:309600995652:task-definition/tawsTAWS-itIT270-270ECSSE-nginx:59	124
... bamboo.custom.aws.ecs.service.first.DesiredCount: 2
... bamboo.custom.aws.ecs.service.first.PendingCount: 0
... bamboo.custom.aws.ecs.service.first.RunningCount: 2

Update Service

See Create above.

Delete Service

See Create above.

How-to Articles

Filter by label (Content by label)
max8
showSpacefalse
sorttitle
excerptTypesimple
cqllabel in ("aws-cli","amazon-ecs") and label in ("kb-how-to-article","kb-troubleshooting-article")

Frequently Asked Questions (FAQ)

Questionslist macro
filterpopular
asktrue
limit8
topicamazon-ecs