ClusterProps

class aws_cdk.aws_ecs.ClusterProps(*, capacity=None, capacity_providers=None, cluster_name=None, container_insights=None, default_cloud_map_namespace=None, enable_fargate_capacity_providers=None, execute_command_configuration=None, vpc=None)

Bases: object

The properties used to define an ECS cluster.

Parameters

  • capacity (Optional[AddCapacityOptions]) – The ec2 capacity to add to the cluster. Default: - no EC2 capacity will be added, you can use addCapacity to add capacity later.

  • capacity_providers (Optional[Sequence[str]]) – (deprecated) The capacity providers to add to the cluster. Default: - None. Currently only FARGATE and FARGATE_SPOT are supported.

  • cluster_name (Optional[str]) – The name for the cluster. Default: CloudFormation-generated name

  • container_insights (Optional[bool]) – If true CloudWatch Container Insights will be enabled for the cluster. Default: - Container Insights will be disabled for this cluser.

  • default_cloud_map_namespace (Optional[CloudMapNamespaceOptions]) – The service discovery namespace created in this cluster. Default: - no service discovery namespace created, you can use addDefaultCloudMapNamespace to add a default service discovery namespace later.

  • enable_fargate_capacity_providers (Optional[bool]) – Whether to enable Fargate Capacity Providers. Default: false

  • execute_command_configuration (Optional[ExecuteCommandConfiguration]) – The execute command configuration for the cluster. Default: - no configuration will be provided.

  • vpc (Optional[IVpc]) – The VPC where your ECS instances will be running or your ENIs will be deployed. Default: - creates a new VPC with two AZs

Attributes

capacity

The ec2 capacity to add to the cluster.

Default

  • no EC2 capacity will be added, you can use addCapacity to add capacity later.

Return type

Optional[AddCapacityOptions]

capacity_providers

(deprecated) The capacity providers to add to the cluster.

Default

  • None. Currently only FARGATE and FARGATE_SPOT are supported.

Deprecated

Use {@link ClusterProps.enableFargateCapacityProviders} instead.

Stability

deprecated

Return type

Optional[List[str]]

cluster_name

The name for the cluster.

Default

CloudFormation-generated name

Return type

Optional[str]

container_insights

If true CloudWatch Container Insights will be enabled for the cluster.

Default

  • Container Insights will be disabled for this cluser.

Return type

Optional[bool]

default_cloud_map_namespace

The service discovery namespace created in this cluster.

Default

  • no service discovery namespace created, you can use addDefaultCloudMapNamespace to add a

default service discovery namespace later.

Return type

Optional[CloudMapNamespaceOptions]

enable_fargate_capacity_providers

Whether to enable Fargate Capacity Providers.

Default

false

Return type

Optional[bool]

execute_command_configuration

The execute command configuration for the cluster.

Default

  • no configuration will be provided.

Return type

Optional[ExecuteCommandConfiguration]

vpc

The VPC where your ECS instances will be running or your ENIs will be deployed.

Default

  • creates a new VPC with two AZs

Return type

Optional[IVpc]