BaseServiceProps

class aws_cdk.aws_ecs.BaseServiceProps(*, cluster, capacity_provider_strategies=None, circuit_breaker=None, cloud_map_options=None, deployment_controller=None, desired_count=None, enable_ecs_managed_tags=None, health_check_grace_period=None, max_healthy_percent=None, min_healthy_percent=None, propagate_tags=None, service_name=None, launch_type)

Bases: aws_cdk.aws_ecs.BaseServiceOptions

Complete base service properties that are required to be supplied by the implementation of the BaseService class.

Parameters

  • cluster (ICluster) – The name of the cluster that hosts the service.

  • capacity_provider_strategies (Optional[Sequence[CapacityProviderStrategy]]) – A list of Capacity Provider strategies used to place a service. Default: - undefined

  • circuit_breaker (Optional[DeploymentCircuitBreaker]) – Whether to enable the deployment circuit breaker. If this property is defined, circuit breaker will be implicitly enabled. Default: - disabled

  • cloud_map_options (Optional[CloudMapOptions]) – The options for configuring an Amazon ECS service to use service discovery. Default: - AWS Cloud Map service discovery is not enabled.

  • deployment_controller (Optional[DeploymentController]) – Specifies which deployment controller to use for the service. For more information, see Amazon ECS Deployment Types Default: - Rolling update (ECS)

  • desired_count (Union[int, float, None]) – The desired number of instantiations of the task definition to keep running on the service. Default: - When creating the service, default is 1; when updating the service, default uses the current task number.

  • enable_ecs_managed_tags (Optional[bool]) – Specifies whether to enable Amazon ECS managed tags for the tasks within the service. For more information, see Tagging Your Amazon ECS Resources Default: false

  • health_check_grace_period (Optional[Duration]) – The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set

  • max_healthy_percent (Union[int, float, None]) – The maximum number of tasks, specified as a percentage of the Amazon ECS service’s DesiredCount value, that can run in a service during a deployment. Default: - 100 if daemon, otherwise 200

  • min_healthy_percent (Union[int, float, None]) – The minimum number of tasks, specified as a percentage of the Amazon ECS service’s DesiredCount value, that must continue to run and remain healthy during a deployment. Default: - 0 if daemon, otherwise 50

  • propagate_tags (Optional[PropagatedTagSource]) – Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE

  • service_name (Optional[str]) – The name of the service. Default: - CloudFormation-generated name.

  • launch_type (LaunchType) – The launch type on which to run your service. LaunchType will be omitted if capacity provider strategies are specified on the service.

Attributes

capacity_provider_strategies

A list of Capacity Provider strategies used to place a service.

Default

  • undefined

Return type

Optional[List[CapacityProviderStrategy]]

circuit_breaker

Whether to enable the deployment circuit breaker.

If this property is defined, circuit breaker will be implicitly enabled.

Default

  • disabled

Return type

Optional[DeploymentCircuitBreaker]

cloud_map_options

The options for configuring an Amazon ECS service to use service discovery.

Default

  • AWS Cloud Map service discovery is not enabled.

Return type

Optional[CloudMapOptions]

cluster

The name of the cluster that hosts the service.

Return type

ICluster

deployment_controller

Specifies which deployment controller to use for the service.

For more information, see Amazon ECS Deployment Types

Default

  • Rolling update (ECS)

Return type

Optional[DeploymentController]

desired_count

The desired number of instantiations of the task definition to keep running on the service.

Default

  • When creating the service, default is 1; when updating the service, default uses

the current task number.

Return type

Union[int, float, None]

enable_ecs_managed_tags

Specifies whether to enable Amazon ECS managed tags for the tasks within the service.

For more information, see Tagging Your Amazon ECS Resources

Default

false

Return type

Optional[bool]

health_check_grace_period

The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started.

Default

  • defaults to 60 seconds if at least one load balancer is in-use and it is not already set

Return type

Optional[Duration]

launch_type

The launch type on which to run your service.

LaunchType will be omitted if capacity provider strategies are specified on the service.

See

Valid values are: LaunchType.ECS or LaunchType.FARGATE

Return type

LaunchType

max_healthy_percent

The maximum number of tasks, specified as a percentage of the Amazon ECS service’s DesiredCount value, that can run in a service during a deployment.

Default

  • 100 if daemon, otherwise 200

Return type

Union[int, float, None]

min_healthy_percent

The minimum number of tasks, specified as a percentage of the Amazon ECS service’s DesiredCount value, that must continue to run and remain healthy during a deployment.

Default

  • 0 if daemon, otherwise 50

Return type

Union[int, float, None]

propagate_tags

Specifies whether to propagate the tags from the task definition or the service to the tasks in the service.

Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE

Default

PropagatedTagSource.NONE

Return type

Optional[PropagatedTagSource]

service_name

The name of the service.

Default

  • CloudFormation-generated name.

Return type

Optional[str]