Octopus.AwsUpdateEcsService exported 2026-07-22 by Octopus Deploy belongs to ‘Aws’ category.
Updates an existing Amazon ECS service by registering a new task definition revision and updating the service to use it. Runs against an AWS ECS Cluster deployment target that supplies the cluster name, region, and AWS credentials; the properties below cover only the per-deployment inputs.
Parameters
When this step is included in a project’s deployment process, the parameters below can be set.
ECS Service Name
Octopus.Action.Aws.Ecs.Update.ServiceName (required)
The name of the ECS service to update.
Target Task Definition Family
Octopus.Action.Aws.Ecs.Update.TargetTaskDefinitionName (required)
Family name of the task definition that will be registered and rolled out to the service. A new revision is created on each run.
Template Task Definition Family
Octopus.Action.Aws.Ecs.Update.TemplateTaskDefinitionName
Optional family name of an existing task definition used as the base for the new revision. Defaults to the target family when omitted.
Container Updates
Octopus.Action.Aws.Ecs.Update.ContainerUpdates (required)
Per-container updates to apply to the template task definition as a JSON array. Each element identifies a container by name and may set a new image (via PackageReference), environment variables, and environment files. At least one container is required.
Example: [{"containerName":"web","packageReference":"web","environmentVariables":{"action":"Replace","items":[{"type":"Plain","key":"LOG_LEVEL","value":"info"}]}}]
Tags
Octopus.Action.Aws.Tags
Optional user-supplied AWS resource tags as a JSON array of key/value pairs. Merged with Octopus default tags identifying the deployment context (project, environment, tenant, release, action, machine, etc.) and applied to the ECS service and the new task definition revision.
Example: [{"key":"Environment","value":"Production"}]
Wait Option
Octopus.Action.Aws.Ecs.WaitOption (required)
How to wait for the service to stabilise on the new task definition. JSON-encoded object: {“type”:“WaitUntilCompleted”|“WaitWithTimeout”|“DontWait”,“timeoutMinutes”:"
Example: {"type":"WaitWithTimeout","timeoutMinutes":"30"}
Page updated on Wednesday, July 22, 2026