Skip to content

Deployment

Source code in docs_src/capo_ecs/types/deployment.py
class Deployment(TypedDict, closed=True):
    id: NotRequired["capo_ecs.types.string.String"]
    """<p>The ID of the deployment.</p>"""
    status: NotRequired["capo_ecs.types.string.String"]
    """<p>The status of the deployment. The following describes each state.</p> <dl> <dt>PRIMARY</dt> <dd> <p>The most recent deployment of a service.</p> </dd> <dt>ACTIVE</dt> <dd> <p>A service deployment that still has running tasks, but are in the process of being replaced with a new <code>PRIMARY</code> deployment.</p> </dd> <dt>INACTIVE</dt> <dd> <p>A deployment that has been completely replaced.</p> </dd> </dl>"""
    task_definition: NotRequired["capo_ecs.types.string.String"]
    """<p>The most recent task definition that was specified for the tasks in the service to use.</p>"""
    desired_count: "capo_ecs.types.integer.Integer"
    """<p>The most recent desired count of tasks that was specified for the service to deploy or maintain.</p>"""
    pending_count: "capo_ecs.types.integer.Integer"
    """<p>The number of tasks in the deployment that are in the <code>PENDING</code> status.</p>"""
    running_count: "capo_ecs.types.integer.Integer"
    """<p>The number of tasks in the deployment that are in the <code>RUNNING</code> status.</p>"""
    failed_tasks: "capo_ecs.types.integer.Integer"
    """<p>The number of consecutively failed tasks in the deployment. A task is considered a failure if the service scheduler can't launch the task, the task doesn't transition to a <code>RUNNING</code> state, or if it fails any of its defined health checks and is stopped.</p> <note> <p>Once a service deployment has one or more successfully running tasks, the failed task count resets to zero and stops being evaluated.</p> </note>"""
    created_at: NotRequired["capo_ecs.types.timestamp.Timestamp"]
    """<p>The Unix timestamp for the time when the service deployment was created.</p>"""
    updated_at: NotRequired["capo_ecs.types.timestamp.Timestamp"]
    """<p>The Unix timestamp for the time when the service deployment was last updated.</p>"""
    capacity_provider_strategy: NotRequired[
        "capo_ecs.types.capacity_provider_strategy.CapacityProviderStrategy"
    ]
    """<p>The capacity provider strategy that the deployment is using.</p>"""
    launch_type: NotRequired["capo_ecs.types.launch_type.LaunchType"]
    """<p>The launch type the tasks in the service 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>.</p>"""
    platform_version: NotRequired["capo_ecs.types.string.String"]
    """<p>The platform version that your tasks in the service run on. A platform version is only specified for tasks using the Fargate launch type. If one isn't specified, the <code>LATEST</code> platform version is used. 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>.</p>"""
    platform_family: NotRequired["capo_ecs.types.string.String"]
    """<p>The operating system that your tasks in the service, or tasks are running on. A platform family is specified only for tasks using the Fargate launch type. </p> <p> All tasks that run as part of this service must use the same <code>platformFamily</code> value as the service, for example, <code> LINUX.</code>.</p>"""
    network_configuration: NotRequired[
        "capo_ecs.types.network_configuration.NetworkConfiguration"
    ]
    """<p>The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the <code>awsvpc</code> networking mode.</p>"""
    rollout_state: NotRequired[
        "capo_ecs.types.deployment_rollout_state.DeploymentRolloutState"
    ]
    """<note> <p>The <code>rolloutState</code> of a service is only returned for services that use the rolling update (<code>ECS</code>) deployment type that aren't behind a Classic Load Balancer.</p> </note> <p>The rollout state of the deployment. When a service deployment is started, it begins in an <code>IN_PROGRESS</code> state. When the service reaches a steady state, the deployment transitions to a <code>COMPLETED</code> state. If the service fails to reach a steady state and circuit breaker is turned on, the deployment transitions to a <code>FAILED</code> state. A deployment in <code>FAILED</code> state doesn't launch any new tasks. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeploymentCircuitBreaker.html">DeploymentCircuitBreaker</a>.</p>"""
    rollout_state_reason: NotRequired["capo_ecs.types.string.String"]
    """<p>A description of the rollout state of a deployment.</p>"""
    service_connect_configuration: NotRequired[
        "capo_ecs.types.service_connect_configuration.ServiceConnectConfiguration"
    ]
    """<p>The details of the Service Connect configuration that's used by this deployment. Compare the configuration between multiple deployments when troubleshooting issues with new deployments.</p> <p>The configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace.</p> <p>Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html">Service Connect</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>"""
    service_connect_resources: NotRequired[
        "capo_ecs.types.service_connect_service_resource_list.ServiceConnectServiceResourceList"
    ]
    """<p>The list of Service Connect resources that are associated with this deployment. Each list entry maps a discovery name to a Cloud Map service name.</p>"""
    volume_configurations: NotRequired[
        "capo_ecs.types.service_volume_configurations.ServiceVolumeConfigurations"
    ]
    """<p>The details of the volume that was <code>configuredAtLaunch</code>. You can configure different settings like the size, throughput, volumeType, and ecryption in <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ServiceManagedEBSVolumeConfiguration.html">ServiceManagedEBSVolumeConfiguration</a>. The <code>name</code> of the volume must match the <code>name</code> from the task definition.</p>"""
    fargate_ephemeral_storage: NotRequired[
        "capo_ecs.types.deployment_ephemeral_storage.DeploymentEphemeralStorage"
    ]
    """<p>The Fargate ephemeral storage settings for the deployment.</p>"""
    vpc_lattice_configurations: NotRequired[
        "capo_ecs.types.vpc_lattice_configurations.VpcLatticeConfigurations"
    ]
    """<p>The VPC Lattice configuration for the service deployment.</p>"""

capacity_provider_strategy instance-attribute

capacity_provider_strategy: NotRequired[CapacityProviderStrategy]

The capacity provider strategy that the deployment is using.

created_at instance-attribute

created_at: NotRequired[Timestamp]

The Unix timestamp for the time when the service deployment was created.

desired_count instance-attribute

desired_count: Integer

The most recent desired count of tasks that was specified for the service to deploy or maintain.

failed_tasks instance-attribute

failed_tasks: Integer

The number of consecutively failed tasks in the deployment. A task is considered a failure if the service scheduler can't launch the task, the task doesn't transition to a RUNNING state, or if it fails any of its defined health checks and is stopped.

Once a service deployment has one or more successfully running tasks, the failed task count resets to zero and stops being evaluated.

fargate_ephemeral_storage instance-attribute

fargate_ephemeral_storage: NotRequired[DeploymentEphemeralStorage]

The Fargate ephemeral storage settings for the deployment.

id instance-attribute

id: NotRequired[String]

The ID of the deployment.

launch_type instance-attribute

launch_type: NotRequired[LaunchType]

The launch type the tasks in the service are using. For more information, see Amazon ECS Launch Types in the Amazon Elastic Container Service Developer Guide.

network_configuration instance-attribute

network_configuration: NotRequired[NetworkConfiguration]

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

pending_count instance-attribute

pending_count: Integer

The number of tasks in the deployment that are in the PENDING status.

platform_family instance-attribute

platform_family: NotRequired[String]

The operating system that your tasks in the service, or tasks are running on. A platform family is specified only for tasks using the Fargate launch type.

All tasks that run as part of this service must use the same platformFamily value as the service, for example, LINUX..

platform_version instance-attribute

platform_version: NotRequired[String]

The platform version that your tasks in the service run on. A platform version is only specified for tasks using the Fargate launch type. If one isn't specified, the LATEST platform version is used. For more information, see Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

rollout_state instance-attribute

rollout_state: NotRequired[DeploymentRolloutState]

The rolloutState of a service is only returned for services that use the rolling update (ECS) deployment type that aren't behind a Classic Load Balancer.

The rollout state of the deployment. When a service deployment is started, it begins in an IN_PROGRESS state. When the service reaches a steady state, the deployment transitions to a COMPLETED state. If the service fails to reach a steady state and circuit breaker is turned on, the deployment transitions to a FAILED state. A deployment in FAILED state doesn't launch any new tasks. For more information, see DeploymentCircuitBreaker.

rollout_state_reason instance-attribute

rollout_state_reason: NotRequired[String]

A description of the rollout state of a deployment.

running_count instance-attribute

running_count: Integer

The number of tasks in the deployment that are in the RUNNING status.

service_connect_configuration instance-attribute

service_connect_configuration: NotRequired[ServiceConnectConfiguration]

The details of the Service Connect configuration that's used by this deployment. Compare the configuration between multiple deployments when troubleshooting issues with new deployments.

The configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

service_connect_resources instance-attribute

service_connect_resources: NotRequired[ServiceConnectServiceResourceList]

The list of Service Connect resources that are associated with this deployment. Each list entry maps a discovery name to a Cloud Map service name.

status instance-attribute

status: NotRequired[String]

The status of the deployment. The following describes each state.

PRIMARY

The most recent deployment of a service.

ACTIVE

A service deployment that still has running tasks, but are in the process of being replaced with a new PRIMARY deployment.

INACTIVE

A deployment that has been completely replaced.

task_definition instance-attribute

task_definition: NotRequired[String]

The most recent task definition that was specified for the tasks in the service to use.

updated_at instance-attribute

updated_at: NotRequired[Timestamp]

The Unix timestamp for the time when the service deployment was last updated.

volume_configurations instance-attribute

volume_configurations: NotRequired[ServiceVolumeConfigurations]

The details of the volume that was configuredAtLaunch. You can configure different settings like the size, throughput, volumeType, and ecryption in ServiceManagedEBSVolumeConfiguration. The name of the volume must match the name from the task definition.

vpc_lattice_configurations instance-attribute

vpc_lattice_configurations: NotRequired[VpcLatticeConfigurations]

The VPC Lattice configuration for the service deployment.