@btc-embedded/cdk-extensions 0.19.0 → 0.20.1

package/API.md

@@ -2409,6 +2409,169 @@ public readonly securityGroup: ISecurityGroup;
 ---
 
 
+### EcsCluster <a name="EcsCluster" id="@btc-embedded/cdk-extensions.EcsCluster"></a>
+
+- *Implements:* <a href="#@btc-embedded/cdk-extensions.IEcsCluster">IEcsCluster</a>
+
+A CDK construct that creates and configures an Amazon ECS cluster with optional features.
+
+This construct provides a standardized way to create ECS clusters with support for:
+- KMS encryption for ECS Exec command sessions
+- Fargate Spot capacity providers
+- Configurable capacity provider strategies with base and weight values
+
+The cluster exports its name and VPC ID as stack parameters, allowing other stacks
+to import and reference the cluster using the `fromBasePlatform` static method.
+
+#### Initializers <a name="Initializers" id="@btc-embedded/cdk-extensions.EcsCluster.Initializer"></a>
+
+```typescript
+import { EcsCluster } from '@btc-embedded/cdk-extensions'
+
+new EcsCluster(scope: Construct, id: string, props: EcsClusterProps)
+```
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsCluster.Initializer.parameter.scope">scope</a></code> | <code>constructs.Construct</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsCluster.Initializer.parameter.id">id</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsCluster.Initializer.parameter.props">props</a></code> | <code><a href="#@btc-embedded/cdk-extensions.EcsClusterProps">EcsClusterProps</a></code> | *No description.* |
+
+---
+
+##### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.EcsCluster.Initializer.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+---
+
+##### `id`<sup>Required</sup> <a name="id" id="@btc-embedded/cdk-extensions.EcsCluster.Initializer.parameter.id"></a>
+
+- *Type:* string
+
+---
+
+##### `props`<sup>Required</sup> <a name="props" id="@btc-embedded/cdk-extensions.EcsCluster.Initializer.parameter.props"></a>
+
+- *Type:* <a href="#@btc-embedded/cdk-extensions.EcsClusterProps">EcsClusterProps</a>
+
+---
+
+#### Methods <a name="Methods" id="Methods"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsCluster.toString">toString</a></code> | Returns a string representation of this construct. |
+
+---
+
+##### `toString` <a name="toString" id="@btc-embedded/cdk-extensions.EcsCluster.toString"></a>
+
+```typescript
+public toString(): string
+```
+
+Returns a string representation of this construct.
+
+#### Static Functions <a name="Static Functions" id="Static Functions"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsCluster.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsCluster.fromBasePlatform">fromBasePlatform</a></code> | *No description.* |
+
+---
+
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.EcsCluster.isConstruct"></a>
+
+```typescript
+import { EcsCluster } from '@btc-embedded/cdk-extensions'
+
+EcsCluster.isConstruct(x: any)
+```
+
+Checks if `x` is a construct.
+
+Use this method instead of `instanceof` to properly detect `Construct`
+instances, even when the construct library is symlinked.
+
+Explanation: in JavaScript, multiple copies of the `constructs` library on
+disk are seen as independent, completely different libraries. As a
+consequence, the class `Construct` in each copy of the `constructs` library
+is seen as a different class, and an instance of one class will not test as
+`instanceof` the other class. `npm install` will not create installations
+like this, but users may manually symlink construct libraries together or
+use a monorepo tool: in those cases, multiple copies of the `constructs`
+library can be accidentally installed, and `instanceof` will behave
+unpredictably. It is safest to avoid using `instanceof`, and using
+this type-testing method instead.
+
+###### `x`<sup>Required</sup> <a name="x" id="@btc-embedded/cdk-extensions.EcsCluster.isConstruct.parameter.x"></a>
+
+- *Type:* any
+
+Any object.
+
+---
+
+##### `fromBasePlatform` <a name="fromBasePlatform" id="@btc-embedded/cdk-extensions.EcsCluster.fromBasePlatform"></a>
+
+```typescript
+import { EcsCluster } from '@btc-embedded/cdk-extensions'
+
+EcsCluster.fromBasePlatform(scope: Construct, id: string, stackName: string)
+```
+
+###### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.EcsCluster.fromBasePlatform.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+---
+
+###### `id`<sup>Required</sup> <a name="id" id="@btc-embedded/cdk-extensions.EcsCluster.fromBasePlatform.parameter.id"></a>
+
+- *Type:* string
+
+---
+
+###### `stackName`<sup>Required</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.EcsCluster.fromBasePlatform.parameter.stackName"></a>
+
+- *Type:* string
+
+---
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsCluster.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsCluster.property.cluster">cluster</a></code> | <code>aws-cdk-lib.aws_ecs.ICluster</code> | *No description.* |
+
+---
+
+##### `node`<sup>Required</sup> <a name="node" id="@btc-embedded/cdk-extensions.EcsCluster.property.node"></a>
+
+```typescript
+public readonly node: Node;
+```
+
+- *Type:* constructs.Node
+
+The tree node.
+
+---
+
+##### `cluster`<sup>Required</sup> <a name="cluster" id="@btc-embedded/cdk-extensions.EcsCluster.property.cluster"></a>
+
+```typescript
+public readonly cluster: ICluster;
+```
+
+- *Type:* aws-cdk-lib.aws_ecs.ICluster
+
+---
+
+
 ### EfsFileSystem <a name="EfsFileSystem" id="@btc-embedded/cdk-extensions.EfsFileSystem"></a>
 
 - *Implements:* <a href="#@btc-embedded/cdk-extensions.IEfsFileSystem">IEfsFileSystem</a>
@@ -4522,7 +4685,7 @@ dedicated VPC, with max 2 AZS and NO Key for Exec
 
 ---
 
-##### `toString` <a name="toString" id="@btc-embedded/cdk-extensions.Vpc.toString"></a>
+##### ~~`toString`~~ <a name="toString" id="@btc-embedded/cdk-extensions.Vpc.toString"></a>
 
 ```typescript
 public toString(): string
@@ -4539,7 +4702,7 @@ Returns a string representation of this construct.
 
 ---
 
-##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.Vpc.isConstruct"></a>
+##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.Vpc.isConstruct"></a>
 
 ```typescript
 import { Vpc } from '@btc-embedded/cdk-extensions'
@@ -4571,7 +4734,7 @@ Any object.
 
 ---
 
-##### `fromBasePlatform` <a name="fromBasePlatform" id="@btc-embedded/cdk-extensions.Vpc.fromBasePlatform"></a>
+##### ~~`fromBasePlatform`~~ <a name="fromBasePlatform" id="@btc-embedded/cdk-extensions.Vpc.fromBasePlatform"></a>
 
 ```typescript
 import { Vpc } from '@btc-embedded/cdk-extensions'
@@ -4609,7 +4772,9 @@ Vpc.fromBasePlatform(scope: Construct, id: string, stackName: string)
 
 ---
 
-##### `node`<sup>Required</sup> <a name="node" id="@btc-embedded/cdk-extensions.Vpc.property.node"></a>
+##### ~~`node`~~<sup>Required</sup> <a name="node" id="@btc-embedded/cdk-extensions.Vpc.property.node"></a>
+
+- *Deprecated:* This class is deprecated. Use {@link VpcV2 } and {@link EcsCluster } classes instead.
 
 ```typescript
 public readonly node: Node;
@@ -4621,7 +4786,9 @@ The tree node.
 
 ---
 
-##### `clusterName`<sup>Required</sup> <a name="clusterName" id="@btc-embedded/cdk-extensions.Vpc.property.clusterName"></a>
+##### ~~`clusterName`~~<sup>Required</sup> <a name="clusterName" id="@btc-embedded/cdk-extensions.Vpc.property.clusterName"></a>
+
+- *Deprecated:* This class is deprecated. Use {@link VpcV2 } and {@link EcsCluster } classes instead.
 
 ```typescript
 public readonly clusterName: string;
@@ -4631,7 +4798,9 @@ public readonly clusterName: string;
 
 ---
 
-##### `fqdn`<sup>Required</sup> <a name="fqdn" id="@btc-embedded/cdk-extensions.Vpc.property.fqdn"></a>
+##### ~~`fqdn`~~<sup>Required</sup> <a name="fqdn" id="@btc-embedded/cdk-extensions.Vpc.property.fqdn"></a>
+
+- *Deprecated:* This class is deprecated. Use {@link VpcV2 } and {@link EcsCluster } classes instead.
 
 ```typescript
 public readonly fqdn: string;
@@ -4641,7 +4810,9 @@ public readonly fqdn: string;
 
 ---
 
-##### `cluster`<sup>Required</sup> <a name="cluster" id="@btc-embedded/cdk-extensions.Vpc.property.cluster"></a>
+##### ~~`cluster`~~<sup>Required</sup> <a name="cluster" id="@btc-embedded/cdk-extensions.Vpc.property.cluster"></a>
+
+- *Deprecated:* This class is deprecated. Use {@link VpcV2 } and {@link EcsCluster } classes instead.
 
 ```typescript
 public readonly cluster: Cluster;
@@ -4651,7 +4822,166 @@ public readonly cluster: Cluster;
 
 ---
 
-##### `vpcInstance`<sup>Required</sup> <a name="vpcInstance" id="@btc-embedded/cdk-extensions.Vpc.property.vpcInstance"></a>
+##### ~~`vpcInstance`~~<sup>Required</sup> <a name="vpcInstance" id="@btc-embedded/cdk-extensions.Vpc.property.vpcInstance"></a>
+
+- *Deprecated:* This class is deprecated. Use {@link VpcV2 } and {@link EcsCluster } classes instead.
+
+```typescript
+public readonly vpcInstance: IVpc;
+```
+
+- *Type:* aws-cdk-lib.aws_ec2.IVpc
+
+---
+
+
+### VpcV2 <a name="VpcV2" id="@btc-embedded/cdk-extensions.VpcV2"></a>
+
+- *Implements:* <a href="#@btc-embedded/cdk-extensions.IVpcV2">IVpcV2</a>
+
+A construct that creates or imports an existing VPC.
+
+Supports importing by VPC ID, VPC name, or creating a new VPC with a specified CIDR block.
+
+#### Initializers <a name="Initializers" id="@btc-embedded/cdk-extensions.VpcV2.Initializer"></a>
+
+```typescript
+import { VpcV2 } from '@btc-embedded/cdk-extensions'
+
+new VpcV2(scope: Construct, id: string, props: VpcV2Props)
+```
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2.Initializer.parameter.scope">scope</a></code> | <code>constructs.Construct</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2.Initializer.parameter.id">id</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2.Initializer.parameter.props">props</a></code> | <code><a href="#@btc-embedded/cdk-extensions.VpcV2Props">VpcV2Props</a></code> | *No description.* |
+
+---
+
+##### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.VpcV2.Initializer.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+---
+
+##### `id`<sup>Required</sup> <a name="id" id="@btc-embedded/cdk-extensions.VpcV2.Initializer.parameter.id"></a>
+
+- *Type:* string
+
+---
+
+##### `props`<sup>Required</sup> <a name="props" id="@btc-embedded/cdk-extensions.VpcV2.Initializer.parameter.props"></a>
+
+- *Type:* <a href="#@btc-embedded/cdk-extensions.VpcV2Props">VpcV2Props</a>
+
+---
+
+#### Methods <a name="Methods" id="Methods"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2.toString">toString</a></code> | Returns a string representation of this construct. |
+
+---
+
+##### `toString` <a name="toString" id="@btc-embedded/cdk-extensions.VpcV2.toString"></a>
+
+```typescript
+public toString(): string
+```
+
+Returns a string representation of this construct.
+
+#### Static Functions <a name="Static Functions" id="Static Functions"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2.fromBasePlatform">fromBasePlatform</a></code> | *No description.* |
+
+---
+
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.VpcV2.isConstruct"></a>
+
+```typescript
+import { VpcV2 } from '@btc-embedded/cdk-extensions'
+
+VpcV2.isConstruct(x: any)
+```
+
+Checks if `x` is a construct.
+
+Use this method instead of `instanceof` to properly detect `Construct`
+instances, even when the construct library is symlinked.
+
+Explanation: in JavaScript, multiple copies of the `constructs` library on
+disk are seen as independent, completely different libraries. As a
+consequence, the class `Construct` in each copy of the `constructs` library
+is seen as a different class, and an instance of one class will not test as
+`instanceof` the other class. `npm install` will not create installations
+like this, but users may manually symlink construct libraries together or
+use a monorepo tool: in those cases, multiple copies of the `constructs`
+library can be accidentally installed, and `instanceof` will behave
+unpredictably. It is safest to avoid using `instanceof`, and using
+this type-testing method instead.
+
+###### `x`<sup>Required</sup> <a name="x" id="@btc-embedded/cdk-extensions.VpcV2.isConstruct.parameter.x"></a>
+
+- *Type:* any
+
+Any object.
+
+---
+
+##### `fromBasePlatform` <a name="fromBasePlatform" id="@btc-embedded/cdk-extensions.VpcV2.fromBasePlatform"></a>
+
+```typescript
+import { VpcV2 } from '@btc-embedded/cdk-extensions'
+
+VpcV2.fromBasePlatform(scope: Construct, id: string, stackName: string)
+```
+
+###### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.VpcV2.fromBasePlatform.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+---
+
+###### `id`<sup>Required</sup> <a name="id" id="@btc-embedded/cdk-extensions.VpcV2.fromBasePlatform.parameter.id"></a>
+
+- *Type:* string
+
+---
+
+###### `stackName`<sup>Required</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.VpcV2.fromBasePlatform.parameter.stackName"></a>
+
+- *Type:* string
+
+---
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2.property.vpcInstance">vpcInstance</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | *No description.* |
+
+---
+
+##### `node`<sup>Required</sup> <a name="node" id="@btc-embedded/cdk-extensions.VpcV2.property.node"></a>
+
+```typescript
+public readonly node: Node;
+```
+
+- *Type:* constructs.Node
+
+The tree node.
+
+---
+
+##### `vpcInstance`<sup>Required</sup> <a name="vpcInstance" id="@btc-embedded/cdk-extensions.VpcV2.property.vpcInstance"></a>
 
 ```typescript
 public readonly vpcInstance: IVpc;
@@ -7189,6 +7519,88 @@ public readonly vpc: IVpc;
 
 ---
 
+### EcsClusterProps <a name="EcsClusterProps" id="@btc-embedded/cdk-extensions.EcsClusterProps"></a>
+
+#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.EcsClusterProps.Initializer"></a>
+
+```typescript
+import { EcsClusterProps } from '@btc-embedded/cdk-extensions'
+
+const ecsClusterProps: EcsClusterProps = { ... }
+```
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsClusterProps.property.vpc">vpc</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | The VPC in which to create the ECS cluster. |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsClusterProps.property.capacityProvidersBase">capacityProvidersBase</a></code> | <code>number</code> | The base value for the capacity provider strategy. |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsClusterProps.property.capacityProvidersWeight">capacityProvidersWeight</a></code> | <code>number</code> | The weight value for the capacity provider strategy. |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsClusterProps.property.createKmsExecCommandKey">createKmsExecCommandKey</a></code> | <code>boolean</code> | Whether to create a KMS key for execute command encryption. |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsClusterProps.property.enableFargateSpotCapacityProvider">enableFargateSpotCapacityProvider</a></code> | <code>boolean</code> | Whether to enable Fargate Spot capacity provider. |
+
+---
+
+##### `vpc`<sup>Required</sup> <a name="vpc" id="@btc-embedded/cdk-extensions.EcsClusterProps.property.vpc"></a>
+
+```typescript
+public readonly vpc: IVpc;
+```
+
+- *Type:* aws-cdk-lib.aws_ec2.IVpc
+
+The VPC in which to create the ECS cluster.
+
+---
+
+##### `capacityProvidersBase`<sup>Optional</sup> <a name="capacityProvidersBase" id="@btc-embedded/cdk-extensions.EcsClusterProps.property.capacityProvidersBase"></a>
+
+```typescript
+public readonly capacityProvidersBase: number;
+```
+
+- *Type:* number
+
+The base value for the capacity provider strategy.
+
+---
+
+##### `capacityProvidersWeight`<sup>Optional</sup> <a name="capacityProvidersWeight" id="@btc-embedded/cdk-extensions.EcsClusterProps.property.capacityProvidersWeight"></a>
+
+```typescript
+public readonly capacityProvidersWeight: number;
+```
+
+- *Type:* number
+
+The weight value for the capacity provider strategy.
+
+---
+
+##### `createKmsExecCommandKey`<sup>Optional</sup> <a name="createKmsExecCommandKey" id="@btc-embedded/cdk-extensions.EcsClusterProps.property.createKmsExecCommandKey"></a>
+
+```typescript
+public readonly createKmsExecCommandKey: boolean;
+```
+
+- *Type:* boolean
+
+Whether to create a KMS key for execute command encryption.
+
+---
+
+##### `enableFargateSpotCapacityProvider`<sup>Optional</sup> <a name="enableFargateSpotCapacityProvider" id="@btc-embedded/cdk-extensions.EcsClusterProps.property.enableFargateSpotCapacityProvider"></a>
+
+```typescript
+public readonly enableFargateSpotCapacityProvider: boolean;
+```
+
+- *Type:* boolean
+
+Whether to enable Fargate Spot capacity provider.
+
+---
+
 ### EfsFileSystemLookupOptions <a name="EfsFileSystemLookupOptions" id="@btc-embedded/cdk-extensions.EfsFileSystemLookupOptions"></a>
 
 Lookup options for importing a filesystem from the base stack.
@@ -8797,6 +9209,84 @@ public readonly vpcCidr: IIpAddresses;
 
 ---
 
+### VpcV2Props <a name="VpcV2Props" id="@btc-embedded/cdk-extensions.VpcV2Props"></a>
+
+#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.VpcV2Props.Initializer"></a>
+
+```typescript
+import { VpcV2Props } from '@btc-embedded/cdk-extensions'
+
+const vpcV2Props: VpcV2Props = { ... }
+```
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2Props.property.maxAzs">maxAzs</a></code> | <code>number</code> | The maximum number of Availability Zones to use when creating a new VPC. |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2Props.property.vpcCidr">vpcCidr</a></code> | <code>aws-cdk-lib.aws_ec2.IIpAddresses</code> | The IP address allocation strategy for creating a new VPC. |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2Props.property.vpcId">vpcId</a></code> | <code>string</code> | The ID of an existing VPC to import. |
+| <code><a href="#@btc-embedded/cdk-extensions.VpcV2Props.property.vpcName">vpcName</a></code> | <code>string</code> | The name of the VPC. |
+
+---
+
+##### `maxAzs`<sup>Optional</sup> <a name="maxAzs" id="@btc-embedded/cdk-extensions.VpcV2Props.property.maxAzs"></a>
+
+```typescript
+public readonly maxAzs: number;
+```
+
+- *Type:* number
+
+The maximum number of Availability Zones to use when creating a new VPC.
+
+Defaults to 2.
+
+---
+
+##### `vpcCidr`<sup>Optional</sup> <a name="vpcCidr" id="@btc-embedded/cdk-extensions.VpcV2Props.property.vpcCidr"></a>
+
+```typescript
+public readonly vpcCidr: IIpAddresses;
+```
+
+- *Type:* aws-cdk-lib.aws_ec2.IIpAddresses
+
+The IP address allocation strategy for creating a new VPC.
+
+Required when creating a new VPC.
+
+---
+
+##### `vpcId`<sup>Optional</sup> <a name="vpcId" id="@btc-embedded/cdk-extensions.VpcV2Props.property.vpcId"></a>
+
+```typescript
+public readonly vpcId: string;
+```
+
+- *Type:* string
+
+The ID of an existing VPC to import.
+
+If provided, the VPC will be looked up by ID.
+
+---
+
+##### `vpcName`<sup>Optional</sup> <a name="vpcName" id="@btc-embedded/cdk-extensions.VpcV2Props.property.vpcName"></a>
+
+```typescript
+public readonly vpcName: string;
+```
+
+- *Type:* string
+
+The name of the VPC.
+
+If importing an existing VPC, it will be looked up by this name.
+If creating a new VPC, this will be used as the VPC name.
+
+---
+
 ## Classes <a name="Classes" id="Classes"></a>
 
 ### ApiGatewayExtension <a name="ApiGatewayExtension" id="@btc-embedded/cdk-extensions.ApiGatewayExtension"></a>
@@ -13750,6 +14240,29 @@ public readonly securityGroup: ISecurityGroup;
 
 ---
 
+### IEcsCluster <a name="IEcsCluster" id="@btc-embedded/cdk-extensions.IEcsCluster"></a>
+
+- *Implemented By:* <a href="#@btc-embedded/cdk-extensions.EcsCluster">EcsCluster</a>, <a href="#@btc-embedded/cdk-extensions.IEcsCluster">IEcsCluster</a>
+
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.IEcsCluster.property.cluster">cluster</a></code> | <code>aws-cdk-lib.aws_ecs.ICluster</code> | *No description.* |
+
+---
+
+##### `cluster`<sup>Required</sup> <a name="cluster" id="@btc-embedded/cdk-extensions.IEcsCluster.property.cluster"></a>
+
+```typescript
+public readonly cluster: ICluster;
+```
+
+- *Type:* aws-cdk-lib.aws_ecs.ICluster
+
+---
+
 ### IEfsFileSystem <a name="IEfsFileSystem" id="@btc-embedded/cdk-extensions.IEfsFileSystem"></a>
 
 - *Implemented By:* <a href="#@btc-embedded/cdk-extensions.EfsFileSystem">EfsFileSystem</a>, <a href="#@btc-embedded/cdk-extensions.IEfsFileSystem">IEfsFileSystem</a>
@@ -13881,6 +14394,29 @@ public readonly fqdn: string;
 
 ---
 
+### IVpcV2 <a name="IVpcV2" id="@btc-embedded/cdk-extensions.IVpcV2"></a>
+
+- *Implemented By:* <a href="#@btc-embedded/cdk-extensions.VpcV2">VpcV2</a>, <a href="#@btc-embedded/cdk-extensions.IVpcV2">IVpcV2</a>
+
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.IVpcV2.property.vpcInstance">vpcInstance</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | *No description.* |
+
+---
+
+##### `vpcInstance`<sup>Required</sup> <a name="vpcInstance" id="@btc-embedded/cdk-extensions.IVpcV2.property.vpcInstance"></a>
+
+```typescript
+public readonly vpcInstance: IVpc;
+```
+
+- *Type:* aws-cdk-lib.aws_ec2.IVpc
+
+---
+
 ## Enums <a name="Enums" id="Enums"></a>
 
 ### EfsAccessMode <a name="EfsAccessMode" id="@btc-embedded/cdk-extensions.EfsAccessMode"></a>

package/CHANGELOG.md

@@ -1,4 +1,34 @@
 
+## [0.20.0](https://github.com/btc-embedded/cdk-extensions/compare/v0.19.0...v0.20.0) (2026-01-15)
+
+
+### ⚠ BREAKING CHANGES
+
+* Provinding VPC and ECS cluster as constructs
+
+### Features
+
+* add fargate spot capacity provider to ecs cluster ([72db2cf](https://github.com/btc-embedded/cdk-extensions/commit/72db2cf970526dd3cb65eb8877924e0fb45082bd))
+* Provinding VPC and ECS cluster as constructs ([553f891](https://github.com/btc-embedded/cdk-extensions/commit/553f891b2e66654668eacbbf3e640628ce9a908f))
+
+
+### Bug Fixes
+
+* code bug ([99bd9f0](https://github.com/btc-embedded/cdk-extensions/commit/99bd9f023875abae2bde5568318c146a410d3cd3))
+* refactor the code ([f633af6](https://github.com/btc-embedded/cdk-extensions/commit/f633af629963cccbb70053619299d70ae7f6e9b2))
+* update doc and vpcv2 instance variables ([c07c72e](https://github.com/btc-embedded/cdk-extensions/commit/c07c72e6b3fbcd3c023600cce72836b8a0b61c4c))
+
+## [0.19.0](https://github.com/btc-embedded/cdk-extensions/compare/v0.18.1...v0.19.0) (2026-01-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* separate OIDC from ALB extension
+
+### Features
+
+* separate OIDC from ALB extension ([c52b73a](https://github.com/btc-embedded/cdk-extensions/commit/c52b73a14637ff1b51afe64ba2147009af3f5c2b))
+
 ## [0.18.1](https://github.com/btc-embedded/cdk-extensions/compare/v0.18.0...v0.18.1) (2026-01-14)