ECS Service Deployment

ECS Service Deployment in AWS represents the details of a deployment within an Amazon ECS service. It tracks information such as the deployment ID, status, desired and running task counts, launch type, and configuration details. This resource helps manage and monitor how new versions of a service are rolled out, ensuring controlled updates and maintaining availability during changes.

aws.ecs_service_deployment

Fields

TitleIDTypeData TypeDescription
_keycorestring
account_idcorestring
alarmscorejsonThe CloudWatch alarms that determine when a service deployment fails.
capacity_provider_strategycorejsonThe capacity provider strategy that are associated with the task set.
cluster_arncorestringThe ARN of the cluster that hosts the service.
computed_desired_countcoreint64The computed desired count for the task set. This is calculated by multiplying the service's <code>desiredCount</code> by the task set's <code>scale</code> percentage. The result is always rounded up. For example, if the computed desired count is 1.2, it rounds up to 2 tasks.
created_atcoretimestampThe time the service deployment was created. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
deployment_circuit_breakercorejsonThe circuit breaker configuration that determines a service deployment failed.
deployment_configurationcorejsonOptional deployment parameters that control how many tasks run during a deployment and the ordering of stopping and starting tasks.
fargate_ephemeral_storagecorejsonThe Fargate ephemeral storage settings for the task set.
finished_atcoretimestampThe time the service deployment finished. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
idcorestringThe ID of the task set.
launch_typecorestringThe launch type the tasks in the task set are using. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html">Amazon ECS launch types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.
load_balancerscorejsonDetails on a load balancer that are used with a task set.
network_configurationcorejsonThe network configuration for the task set.
pending_countcoreint64The number of tasks in the task set that are in the <code>PENDING</code> status during a deployment. A task in the <code>PENDING</code> state is preparing to enter the <code>RUNNING</code> state. A task set enters the <code>PENDING</code> status when it launches for the first time or when it's restarted after being in the <code>STOPPED</code> state.
platform_familycorestringThe operating system that your tasks in the set are running on. A platform family is specified only for tasks that use the Fargate launch type. All tasks in the set must have the same value.
platform_versioncorestringThe Fargate platform version where the tasks in the task set are running. A platform version is only specified for tasks run on Fargate. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html">Fargate platform versions</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.
rollbackcorejsonThe rollback options the service deployment uses when the deployment fails.
running_countcoreint64The number of tasks in the task set that are in the <code>RUNNING</code> status during a deployment. A task in the <code>RUNNING</code> state is running and ready for use.
scalecorejsonA floating-point percentage of your desired number of tasks to place and keep running in the task set.
service_arncorestringThe ARN of the service for this service deployment.
service_deployment_arncorestringThe ARN of the service deployment.
service_registriescorejsonThe details for the service discovery registries to assign to this task set. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html">Service discovery</a>.
source_service_revisionscorejsonThe currently deployed workload configuration.
stability_statuscorestringThe stability status. This indicates whether the task set has reached a steady state. If the following conditions are met, the task set are in <code>STEADY_STATE</code>: <ul> <li> The task <code>runningCount</code> is equal to the <code>computedDesiredCount</code>. </li> <li> The <code>pendingCount</code> is <code>0</code>. </li> <li> There are no tasks that are running on container instances in the <code>DRAINING</code> status. </li> <li> All tasks are reporting a healthy status from the load balancers, service discovery, and container health checks. </li> </ul> If any of those conditions aren't met, the stability status returns <code>STABILIZING</code>.
stability_status_atcoretimestampThe Unix timestamp for the time when the task set stability status was retrieved.
started_atcoretimestampThe time the service deployment statred. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
started_bycorestringThe tag specified when a task set is started. If an CodeDeploy deployment created the task set, the <code>startedBy</code> parameter is <code>CODE_DEPLOY</code>. If an external deployment created the task set, the <code>startedBy</code> field isn't used.
statuscorestringThe service deployment state.
status_reasoncorestringInformation about why the service deployment is in the current status. For example, the circuit breaker detected a failure.
stopped_atcoretimestampThe time the service deployment stopped. The format is yyyy-MM-dd HH:mm:ss.SSSSSS. The service deployment stops when any of the following actions happen: A user manually stops the deployment The rollback option is not in use for the failure detection mechanism (the circuit breaker or alarm-based) and the service fails.
tagscorehstore
target_service_revisioncorejsonThe workload configuration being deployed.
task_definitioncorestringThe task definition that the task set is using.
task_set_arncorestringThe Amazon Resource Name (ARN) of the task set.
updated_atcoretimestampThe time that the service deployment was last updated. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.