BaseServiceOptions

class aws_cdk.aws_ecs.BaseServiceOptions(*, cluster, capacity_provider_strategies=None, circuit_breaker=None, cloud_map_options=None, deployment_alarms=None, deployment_controller=None, desired_count=None, enable_ecs_managed_tags=None, enable_execute_command=None, health_check_grace_period=None, max_healthy_percent=None, min_healthy_percent=None, propagate_tags=None, service_connect_configuration=None, service_name=None, task_definition_revision=None, volume_configurations=None)

Bases: object

The properties for the base Ec2Service or FargateService service.

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

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

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

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

  • deployment_alarms (Union[DeploymentAlarmConfig, Dict[str, Any], None]) – The alarm(s) to monitor during deployment, and behavior to apply if at least one enters a state of alarm during the deployment or bake time. Default: - No alarms will be monitored during deployment.

  • deployment_controller (Union[DeploymentController, Dict[str, Any], None]) – 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

  • enable_execute_command (Optional[bool]) – Whether to enable the ability to execute into a container. Default: - undefined

  • 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_connect_configuration (Union[ServiceConnectProps, Dict[str, Any], None]) – Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.

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

  • task_definition_revision (Optional[TaskDefinitionRevision]) – Revision number for the task definition or latest to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation

  • volume_configurations (Optional[Sequence[ServiceManagedVolume]]) – Configuration details for a volume used by the service. This allows you to specify details about the EBS volume that can be attched to ECS tasks. Default: - undefined

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk as cdk
from aws_cdk import aws_ecs as ecs
from aws_cdk import aws_servicediscovery as servicediscovery

# cluster: ecs.Cluster
# container_definition: ecs.ContainerDefinition
# log_driver: ecs.LogDriver
# namespace: servicediscovery.INamespace
# service_managed_volume: ecs.ServiceManagedVolume
# task_definition_revision: ecs.TaskDefinitionRevision

base_service_options = ecs.BaseServiceOptions(
    cluster=cluster,

    # the properties below are optional
    capacity_provider_strategies=[ecs.CapacityProviderStrategy(
        capacity_provider="capacityProvider",

        # the properties below are optional
        base=123,
        weight=123
    )],
    circuit_breaker=ecs.DeploymentCircuitBreaker(
        enable=False,
        rollback=False
    ),
    cloud_map_options=ecs.CloudMapOptions(
        cloud_map_namespace=namespace,
        container=container_definition,
        container_port=123,
        dns_record_type=servicediscovery.DnsRecordType.A,
        dns_ttl=cdk.Duration.minutes(30),
        failure_threshold=123,
        name="name"
    ),
    deployment_alarms=ecs.DeploymentAlarmConfig(
        alarm_names=["alarmNames"],

        # the properties below are optional
        behavior=ecs.AlarmBehavior.ROLLBACK_ON_ALARM
    ),
    deployment_controller=ecs.DeploymentController(
        type=ecs.DeploymentControllerType.ECS
    ),
    desired_count=123,
    enable_eCSManaged_tags=False,
    enable_execute_command=False,
    health_check_grace_period=cdk.Duration.minutes(30),
    max_healthy_percent=123,
    min_healthy_percent=123,
    propagate_tags=ecs.PropagatedTagSource.SERVICE,
    service_connect_configuration=ecs.ServiceConnectProps(
        log_driver=log_driver,
        namespace="namespace",
        services=[ecs.ServiceConnectService(
            port_mapping_name="portMappingName",

            # the properties below are optional
            discovery_name="discoveryName",
            dns_name="dnsName",
            idle_timeout=cdk.Duration.minutes(30),
            ingress_port_override=123,
            per_request_timeout=cdk.Duration.minutes(30),
            port=123
        )]
    ),
    service_name="serviceName",
    task_definition_revision=task_definition_revision,
    volume_configurations=[service_managed_volume]
)

Attributes

capacity_provider_strategies

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

Default:
  • undefined

circuit_breaker

Whether to enable the deployment circuit breaker.

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

Default:
  • disabled

cloud_map_options

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

Default:
  • AWS Cloud Map service discovery is not enabled.

cluster

The name of the cluster that hosts the service.

deployment_alarms

The alarm(s) to monitor during deployment, and behavior to apply if at least one enters a state of alarm during the deployment or bake time.

Default:
  • No alarms will be monitored during deployment.

deployment_controller

Specifies which deployment controller to use for the service.

For more information, see Amazon ECS Deployment Types

Default:
  • Rolling update (ECS)

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.

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

enable_execute_command

Whether to enable the ability to execute into a container.

Default:
  • undefined

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

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

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

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

service_connect_configuration

Configuration for Service Connect.

Default:

No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.

service_name

The name of the service.

Default:
  • CloudFormation-generated name.

task_definition_revision

Revision number for the task definition or latest to use the latest active task revision.

Default:
  • Uses the revision of the passed task definition deployed by CloudFormation

volume_configurations

Configuration details for a volume used by the service.

This allows you to specify details about the EBS volume that can be attched to ECS tasks.

Default:
  • undefined