Using the Amazon ECS Service task in Bamboo
- Steffen Opel [Utoolity]
- Jana Lehmann [Utoolity]
You can use the Amazon ECS Service task to create, update or delete an Amazon Elastic Container Service (ECS) service (see Deploying to Amazon ECS for an overview of the ECS component lifecycle and deployment workflow).
On this page:
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:
a. Common to all tasks
b. Actions supported by this task:
Create Service |
|
|---|---|
Launch Type | Select the launch type on which to run your service. |
Task Definition | Specify the family and revision (family:revision) or Amazon Resource Name (ARN) of the task definition to use. |
Cluster Name or ARN | (Optional) Specify the cluster name or Amazon Resource Name (ARN).
|
Service Name | Specify the service name. |
Desired Count | (Optional) Specify the number of tasks to keep running. |
Deployment Configuration | (Optional) Specify the deployment configuration in JSON format – refer to Deployment Configuration for details. |
Network Configuration | (Optional) Specify an awsvpc network configuration (JSON – inline or via URL) – refer to Task Networking with the awsvpc Network Mode for details. |
Load Balancers | (Optional) Specify one or more load balancer objects (JSON – inline or via URL) – refer to Service Load Balancing for details. |
Role Name or ARN | (Conditional) Specify the name or Amazon Resource Name (ARN) of the IAM role that allows the ECS container agent to make calls to the load balancer.
|
Tags | Specify the tags to apply (JSON – inline or via URL). |
EC2 Options |
|
Placement Strategy | (Optional) Specify placement strategy objects (JSON – inline or via URL) – refer to Amazon ECS Task Placement Strategies for details. |
Placement Constraints | (Optional) Specify placement constraint objects in (JSON – inline or via URL) – refer to Amazon ECS Task Placement Constraints for details. |
Advanced Options |
|
Fargate Platform Version | (Optional) Specify the platform version on which to run your task. If none is specified, Fargate defaults to the latest version. |
Await Steady State Timeout | Specify 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 |
|
Force new deployment | Check to enforce a new deployment of the service – refer to the UpdateService API action for details. |
Task Definition | see Create Service above |
Cluster Name or ARN | see Create Service above |
Service Name or ARN | Specify the service name or Amazon Resource Name (ARN). |
Desired Count | see Create Service above |
Deployment Configuration | see Create Service above |
Network Configuration | see Create Service above |
Advanced Options |
|
Fargate Platform Version | see Create Service above |
Await Steady State Timeout | see Create Service above |
Verify Steady State Period | see Create Service above |
Delete Service |
|
Cluster Name or ARN | see Create Service above |
Service Name or ARN | see Update Service above |
Variables
Create Service
Creating common variables for 1 services:
... bamboo.custom.aws.ecs.service.resources: TAWS-IT270-ECSSE-nginx
Creating resource variables for service 'TAWS-IT270-ECSSE-nginx':
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.ClusterArn: arn:aws:ecs:us-east-1:309600995652:cluster/TAWS-IT270-43-ubot
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.RoleArn: arn:aws:iam::309600995652:role/amazon-ecs-service
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.ServiceArn: arn:aws:ecs:us-east-1:309600995652:service/TAWS-IT270-ECSSE-nginx
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.ServiceName: TAWS-IT270-ECSSE-nginx
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.Status: ACTIVE
... bamboo.custom.aws.ecs.service.resources.TAWS-IT270-ECSSE-nginx.TaskDefinition: arn:aws:ecs:us-east-1:309600995652:task-definition/TAWS-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 'TAWS-IT270-ECSSE-nginx':
... bamboo.custom.aws.ecs.service.first.ClusterArn: arn:aws:ecs:us-east-1:309600995652:cluster/TAWS-IT270-43-ubot
... 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/TAWS-IT270-ECSSE-nginx
... bamboo.custom.aws.ecs.service.first.ServiceName: TAWS-IT270-ECSSE-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/TAWS-IT270-ECSSE-nginx:124
... bamboo.custom.aws.ecs.service.first.DesiredCount: 2
... bamboo.custom.aws.ecs.service.first.PendingCount: 0
... bamboo.custom.aws.ecs.service.first.RunningCount: 2Update Service
See Create above.
Delete Service
See Create above.
How-to Articles
Frequently Asked Questions (FAQ)
Related content
Amazon Web Services™, AWS™ and the “Powered by Amazon Web Services” logo are trademarks of Amazon.com, Inc. or its affiliates in the United States and/or other countries.
Utoolity® is a registered trademark of Utoolity GmbH.
© 2024 Utoolity GmbH. All rights reserved.