tm-cdk-constructs 0.0.13 → 0.0.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.jsii +135 -2
- package/API.md +949 -0
- package/lib/cdn/cloudfront/cachePolicy.d.ts +26 -0
- package/lib/cdn/cloudfront/cachePolicy.js +45 -0
- package/lib/cdn/cloudfront/prefixList.d.ts +13 -0
- package/lib/cdn/cloudfront/prefixList.js +36 -0
- package/lib/cdn/index.d.ts +2 -0
- package/lib/cdn/index.js +19 -0
- package/lib/containers/ecs/ecs-base-pattern.d.ts +26 -0
- package/lib/containers/ecs/ecs-base-pattern.js +84 -0
- package/lib/containers/index.d.ts +1 -0
- package/lib/containers/index.js +18 -0
- package/lib/databases/rds-aurora-mysql-serverless.js +1 -1
- package/lib/index.d.ts +1 -0
- package/lib/index.js +2 -1
- package/lib/network/vpc-base.js +1 -1
- package/lib/pipeline/index.js +1 -1
- package/package.json +1 -1
package/API.md
CHANGED
|
@@ -2,6 +2,238 @@
|
|
|
2
2
|
|
|
3
3
|
## Constructs <a name="Constructs" id="Constructs"></a>
|
|
4
4
|
|
|
5
|
+
### TmApplicationLoadBalancedFargateService <a name="TmApplicationLoadBalancedFargateService" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService"></a>
|
|
6
|
+
|
|
7
|
+
#### Initializers <a name="Initializers" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.Initializer"></a>
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
import { TmApplicationLoadBalancedFargateService } from 'tm-cdk-constructs'
|
|
11
|
+
|
|
12
|
+
new TmApplicationLoadBalancedFargateService(scope: Construct, id: string, props: TmApplicationLoadBalancedFargateServiceProps)
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
| **Name** | **Type** | **Description** |
|
|
16
|
+
| --- | --- | --- |
|
|
17
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.Initializer.parameter.scope">scope</a></code> | <code>constructs.Construct</code> | *No description.* |
|
|
18
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.Initializer.parameter.id">id</a></code> | <code>string</code> | *No description.* |
|
|
19
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.Initializer.parameter.props">props</a></code> | <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps">TmApplicationLoadBalancedFargateServiceProps</a></code> | *No description.* |
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
##### `scope`<sup>Required</sup> <a name="scope" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.Initializer.parameter.scope"></a>
|
|
24
|
+
|
|
25
|
+
- *Type:* constructs.Construct
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
##### `id`<sup>Required</sup> <a name="id" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.Initializer.parameter.id"></a>
|
|
30
|
+
|
|
31
|
+
- *Type:* string
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
##### `props`<sup>Required</sup> <a name="props" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.Initializer.parameter.props"></a>
|
|
36
|
+
|
|
37
|
+
- *Type:* <a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps">TmApplicationLoadBalancedFargateServiceProps</a>
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
#### Methods <a name="Methods" id="Methods"></a>
|
|
42
|
+
|
|
43
|
+
| **Name** | **Description** |
|
|
44
|
+
| --- | --- |
|
|
45
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.toString">toString</a></code> | Returns a string representation of this construct. |
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
##### `toString` <a name="toString" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.toString"></a>
|
|
50
|
+
|
|
51
|
+
```typescript
|
|
52
|
+
public toString(): string
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Returns a string representation of this construct.
|
|
56
|
+
|
|
57
|
+
#### Static Functions <a name="Static Functions" id="Static Functions"></a>
|
|
58
|
+
|
|
59
|
+
| **Name** | **Description** |
|
|
60
|
+
| --- | --- |
|
|
61
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
##### ~~`isConstruct`~~ <a name="isConstruct" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.isConstruct"></a>
|
|
66
|
+
|
|
67
|
+
```typescript
|
|
68
|
+
import { TmApplicationLoadBalancedFargateService } from 'tm-cdk-constructs'
|
|
69
|
+
|
|
70
|
+
TmApplicationLoadBalancedFargateService.isConstruct(x: any)
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Checks if `x` is a construct.
|
|
74
|
+
|
|
75
|
+
###### `x`<sup>Required</sup> <a name="x" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.isConstruct.parameter.x"></a>
|
|
76
|
+
|
|
77
|
+
- *Type:* any
|
|
78
|
+
|
|
79
|
+
Any object.
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
#### Properties <a name="Properties" id="Properties"></a>
|
|
84
|
+
|
|
85
|
+
| **Name** | **Type** | **Description** |
|
|
86
|
+
| --- | --- | --- |
|
|
87
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
|
|
88
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.cluster">cluster</a></code> | <code>aws-cdk-lib.aws_ecs.ICluster</code> | The cluster that hosts the service. |
|
|
89
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.listener">listener</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationListener</code> | The listener for the service. |
|
|
90
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.loadBalancer">loadBalancer</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationLoadBalancer</code> | The Application Load Balancer for the service. |
|
|
91
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.targetGroup">targetGroup</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationTargetGroup</code> | The target group for the service. |
|
|
92
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.certificate">certificate</a></code> | <code>aws-cdk-lib.aws_certificatemanager.ICertificate</code> | Certificate Manager certificate to associate with the load balancer. |
|
|
93
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.internalDesiredCount">internalDesiredCount</a></code> | <code>number</code> | The desired number of instantiations of the task definition to keep running on the service. |
|
|
94
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.redirectListener">redirectListener</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationListener</code> | The redirect listener for the service if redirectHTTP is enabled. |
|
|
95
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.assignPublicIp">assignPublicIp</a></code> | <code>boolean</code> | Determines whether the service will be assigned a public IP address. |
|
|
96
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.service">service</a></code> | <code>aws-cdk-lib.aws_ecs.FargateService</code> | The Fargate service in this construct. |
|
|
97
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.taskDefinition">taskDefinition</a></code> | <code>aws-cdk-lib.aws_ecs.FargateTaskDefinition</code> | The Fargate task definition in this construct. |
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
##### `node`<sup>Required</sup> <a name="node" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.node"></a>
|
|
102
|
+
|
|
103
|
+
```typescript
|
|
104
|
+
public readonly node: Node;
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
- *Type:* constructs.Node
|
|
108
|
+
|
|
109
|
+
The tree node.
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
##### `cluster`<sup>Required</sup> <a name="cluster" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.cluster"></a>
|
|
114
|
+
|
|
115
|
+
```typescript
|
|
116
|
+
public readonly cluster: ICluster;
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
- *Type:* aws-cdk-lib.aws_ecs.ICluster
|
|
120
|
+
|
|
121
|
+
The cluster that hosts the service.
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
##### `listener`<sup>Required</sup> <a name="listener" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.listener"></a>
|
|
126
|
+
|
|
127
|
+
```typescript
|
|
128
|
+
public readonly listener: ApplicationListener;
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationListener
|
|
132
|
+
|
|
133
|
+
The listener for the service.
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
##### `loadBalancer`<sup>Required</sup> <a name="loadBalancer" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.loadBalancer"></a>
|
|
138
|
+
|
|
139
|
+
```typescript
|
|
140
|
+
public readonly loadBalancer: ApplicationLoadBalancer;
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationLoadBalancer
|
|
144
|
+
|
|
145
|
+
The Application Load Balancer for the service.
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
##### `targetGroup`<sup>Required</sup> <a name="targetGroup" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.targetGroup"></a>
|
|
150
|
+
|
|
151
|
+
```typescript
|
|
152
|
+
public readonly targetGroup: ApplicationTargetGroup;
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationTargetGroup
|
|
156
|
+
|
|
157
|
+
The target group for the service.
|
|
158
|
+
|
|
159
|
+
---
|
|
160
|
+
|
|
161
|
+
##### `certificate`<sup>Optional</sup> <a name="certificate" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.certificate"></a>
|
|
162
|
+
|
|
163
|
+
```typescript
|
|
164
|
+
public readonly certificate: ICertificate;
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
- *Type:* aws-cdk-lib.aws_certificatemanager.ICertificate
|
|
168
|
+
|
|
169
|
+
Certificate Manager certificate to associate with the load balancer.
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
##### `internalDesiredCount`<sup>Optional</sup> <a name="internalDesiredCount" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.internalDesiredCount"></a>
|
|
174
|
+
|
|
175
|
+
```typescript
|
|
176
|
+
public readonly internalDesiredCount: number;
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
- *Type:* number
|
|
180
|
+
|
|
181
|
+
The desired number of instantiations of the task definition to keep running on the service.
|
|
182
|
+
|
|
183
|
+
The default is 1 for all new services and uses the existing services desired count
|
|
184
|
+
when updating an existing service if one is not provided.
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
188
|
+
##### `redirectListener`<sup>Optional</sup> <a name="redirectListener" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.redirectListener"></a>
|
|
189
|
+
|
|
190
|
+
```typescript
|
|
191
|
+
public readonly redirectListener: ApplicationListener;
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationListener
|
|
195
|
+
|
|
196
|
+
The redirect listener for the service if redirectHTTP is enabled.
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
##### `assignPublicIp`<sup>Required</sup> <a name="assignPublicIp" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.assignPublicIp"></a>
|
|
201
|
+
|
|
202
|
+
```typescript
|
|
203
|
+
public readonly assignPublicIp: boolean;
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
- *Type:* boolean
|
|
207
|
+
|
|
208
|
+
Determines whether the service will be assigned a public IP address.
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
##### `service`<sup>Required</sup> <a name="service" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.service"></a>
|
|
213
|
+
|
|
214
|
+
```typescript
|
|
215
|
+
public readonly service: FargateService;
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
- *Type:* aws-cdk-lib.aws_ecs.FargateService
|
|
219
|
+
|
|
220
|
+
The Fargate service in this construct.
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
224
|
+
##### `taskDefinition`<sup>Required</sup> <a name="taskDefinition" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateService.property.taskDefinition"></a>
|
|
225
|
+
|
|
226
|
+
```typescript
|
|
227
|
+
public readonly taskDefinition: FargateTaskDefinition;
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
- *Type:* aws-cdk-lib.aws_ecs.FargateTaskDefinition
|
|
231
|
+
|
|
232
|
+
The Fargate task definition in this construct.
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
|
|
5
237
|
### TmPipeline <a name="TmPipeline" id="tm-cdk-constructs.TmPipeline"></a>
|
|
6
238
|
|
|
7
239
|
A CDK construct that creates a CodePipeline.
|
|
@@ -1607,6 +1839,723 @@ The default subnet configuration if natGateways specified to be 0.
|
|
|
1607
1839
|
|
|
1608
1840
|
## Structs <a name="Structs" id="Structs"></a>
|
|
1609
1841
|
|
|
1842
|
+
### TmApplicationLoadBalancedFargateServiceProps <a name="TmApplicationLoadBalancedFargateServiceProps" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps"></a>
|
|
1843
|
+
|
|
1844
|
+
Represents the configuration for an ecsPatterns.
|
|
1845
|
+
|
|
1846
|
+
#### Initializer <a name="Initializer" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.Initializer"></a>
|
|
1847
|
+
|
|
1848
|
+
```typescript
|
|
1849
|
+
import { TmApplicationLoadBalancedFargateServiceProps } from 'tm-cdk-constructs'
|
|
1850
|
+
|
|
1851
|
+
const tmApplicationLoadBalancedFargateServiceProps: TmApplicationLoadBalancedFargateServiceProps = { ... }
|
|
1852
|
+
```
|
|
1853
|
+
|
|
1854
|
+
#### Properties <a name="Properties" id="Properties"></a>
|
|
1855
|
+
|
|
1856
|
+
| **Name** | **Type** | **Description** |
|
|
1857
|
+
| --- | --- | --- |
|
|
1858
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.capacityProviderStrategies">capacityProviderStrategies</a></code> | <code>aws-cdk-lib.aws_ecs.CapacityProviderStrategy[]</code> | A list of Capacity Provider strategies used to place a service. |
|
|
1859
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.certificate">certificate</a></code> | <code>aws-cdk-lib.aws_certificatemanager.ICertificate</code> | Certificate Manager certificate to associate with the load balancer. |
|
|
1860
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.circuitBreaker">circuitBreaker</a></code> | <code>aws-cdk-lib.aws_ecs.DeploymentCircuitBreaker</code> | Whether to enable the deployment circuit breaker. |
|
|
1861
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.cloudMapOptions">cloudMapOptions</a></code> | <code>aws-cdk-lib.aws_ecs.CloudMapOptions</code> | The options for configuring an Amazon ECS service to use service discovery. |
|
|
1862
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.cluster">cluster</a></code> | <code>aws-cdk-lib.aws_ecs.ICluster</code> | The name of the cluster that hosts the service. |
|
|
1863
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.deploymentController">deploymentController</a></code> | <code>aws-cdk-lib.aws_ecs.DeploymentController</code> | Specifies which deployment controller to use for the service. |
|
|
1864
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.desiredCount">desiredCount</a></code> | <code>number</code> | The desired number of instantiations of the task definition to keep running on the service. |
|
|
1865
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.domainName">domainName</a></code> | <code>string</code> | The domain name for the service, e.g. "api.example.com.". |
|
|
1866
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.domainZone">domainZone</a></code> | <code>aws-cdk-lib.aws_route53.IHostedZone</code> | The Route53 hosted zone for the domain, e.g. "example.com.". |
|
|
1867
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.enableECSManagedTags">enableECSManagedTags</a></code> | <code>boolean</code> | Specifies whether to enable Amazon ECS managed tags for the tasks within the service. |
|
|
1868
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.enableExecuteCommand">enableExecuteCommand</a></code> | <code>boolean</code> | Whether ECS Exec should be enabled. |
|
|
1869
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.healthCheckGracePeriod">healthCheckGracePeriod</a></code> | <code>aws-cdk-lib.Duration</code> | 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. |
|
|
1870
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.idleTimeout">idleTimeout</a></code> | <code>aws-cdk-lib.Duration</code> | The load balancer idle timeout, in seconds. |
|
|
1871
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.listenerPort">listenerPort</a></code> | <code>number</code> | Listener port of the application load balancer that will serve traffic to the service. |
|
|
1872
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.loadBalancer">loadBalancer</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.IApplicationLoadBalancer</code> | The application load balancer that will serve traffic to the service. |
|
|
1873
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.loadBalancerName">loadBalancerName</a></code> | <code>string</code> | Name of the load balancer. |
|
|
1874
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.maxHealthyPercent">maxHealthyPercent</a></code> | <code>number</code> | 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. |
|
|
1875
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.minHealthyPercent">minHealthyPercent</a></code> | <code>number</code> | 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. |
|
|
1876
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.openListener">openListener</a></code> | <code>boolean</code> | Determines whether or not the Security Group for the Load Balancer's Listener will be open to all traffic by default. |
|
|
1877
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.propagateTags">propagateTags</a></code> | <code>aws-cdk-lib.aws_ecs.PropagatedTagSource</code> | Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. |
|
|
1878
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.protocol">protocol</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationProtocol</code> | The protocol for connections from clients to the load balancer. |
|
|
1879
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.protocolVersion">protocolVersion</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationProtocolVersion</code> | The protocol version to use. |
|
|
1880
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.publicLoadBalancer">publicLoadBalancer</a></code> | <code>boolean</code> | Determines whether the Load Balancer will be internet-facing. |
|
|
1881
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.recordType">recordType</a></code> | <code>aws-cdk-lib.aws_ecs_patterns.ApplicationLoadBalancedServiceRecordType</code> | Specifies whether the Route53 record should be a CNAME, an A record using the Alias feature or no record at all. |
|
|
1882
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.redirectHTTP">redirectHTTP</a></code> | <code>boolean</code> | Specifies whether the load balancer should redirect traffic on port 80 to port 443 to support HTTP->HTTPS redirects This is only valid if the protocol of the ALB is HTTPS. |
|
|
1883
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.serviceName">serviceName</a></code> | <code>string</code> | The name of the service. |
|
|
1884
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.sslPolicy">sslPolicy</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.SslPolicy</code> | The security policy that defines which ciphers and protocols are supported by the ALB Listener. |
|
|
1885
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.targetProtocol">targetProtocol</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationProtocol</code> | The protocol for connections from the load balancer to the ECS tasks. |
|
|
1886
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.taskImageOptions">taskImageOptions</a></code> | <code>aws-cdk-lib.aws_ecs_patterns.ApplicationLoadBalancedTaskImageOptions</code> | The properties required to create a new task definition. |
|
|
1887
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.vpc">vpc</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | The VPC where the container instances will be launched or the elastic network interfaces (ENIs) will be deployed. |
|
|
1888
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.cpu">cpu</a></code> | <code>number</code> | The number of cpu units used by the task. |
|
|
1889
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.ephemeralStorageGiB">ephemeralStorageGiB</a></code> | <code>number</code> | The amount (in GiB) of ephemeral storage to be allocated to the task. |
|
|
1890
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.memoryLimitMiB">memoryLimitMiB</a></code> | <code>number</code> | The amount (in MiB) of memory used by the task. |
|
|
1891
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.platformVersion">platformVersion</a></code> | <code>aws-cdk-lib.aws_ecs.FargatePlatformVersion</code> | The platform version on which to run your service. |
|
|
1892
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.runtimePlatform">runtimePlatform</a></code> | <code>aws-cdk-lib.aws_ecs.RuntimePlatform</code> | The runtime platform of the task definition. |
|
|
1893
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.taskDefinition">taskDefinition</a></code> | <code>aws-cdk-lib.aws_ecs.FargateTaskDefinition</code> | The task definition to use for tasks in the service. TaskDefinition or TaskImageOptions must be specified, but not both. |
|
|
1894
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.assignPublicIp">assignPublicIp</a></code> | <code>boolean</code> | Determines whether the service will be assigned a public IP address. |
|
|
1895
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.healthCheck">healthCheck</a></code> | <code>aws-cdk-lib.aws_ecs.HealthCheck</code> | The health check command and associated configuration parameters for the container. |
|
|
1896
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.securityGroups">securityGroups</a></code> | <code>aws-cdk-lib.aws_ec2.ISecurityGroup[]</code> | The security groups to associate with the service. |
|
|
1897
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.taskSubnets">taskSubnets</a></code> | <code>aws-cdk-lib.aws_ec2.SubnetSelection</code> | The subnets to associate with the service. |
|
|
1898
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.containerPort">containerPort</a></code> | <code>number</code> | The container port. |
|
|
1899
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.customHttpHeaderValue">customHttpHeaderValue</a></code> | <code>string</code> | The custom http header value. |
|
|
1900
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.maxTaskCount">maxTaskCount</a></code> | <code>number</code> | The maximum number of task. |
|
|
1901
|
+
| <code><a href="#tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.minTaskCount">minTaskCount</a></code> | <code>number</code> | The minumun number od tasks. |
|
|
1902
|
+
|
|
1903
|
+
---
|
|
1904
|
+
|
|
1905
|
+
##### `capacityProviderStrategies`<sup>Optional</sup> <a name="capacityProviderStrategies" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.capacityProviderStrategies"></a>
|
|
1906
|
+
|
|
1907
|
+
```typescript
|
|
1908
|
+
public readonly capacityProviderStrategies: CapacityProviderStrategy[];
|
|
1909
|
+
```
|
|
1910
|
+
|
|
1911
|
+
- *Type:* aws-cdk-lib.aws_ecs.CapacityProviderStrategy[]
|
|
1912
|
+
- *Default:* undefined
|
|
1913
|
+
|
|
1914
|
+
A list of Capacity Provider strategies used to place a service.
|
|
1915
|
+
|
|
1916
|
+
---
|
|
1917
|
+
|
|
1918
|
+
##### `certificate`<sup>Optional</sup> <a name="certificate" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.certificate"></a>
|
|
1919
|
+
|
|
1920
|
+
```typescript
|
|
1921
|
+
public readonly certificate: ICertificate;
|
|
1922
|
+
```
|
|
1923
|
+
|
|
1924
|
+
- *Type:* aws-cdk-lib.aws_certificatemanager.ICertificate
|
|
1925
|
+
- *Default:* No certificate associated with the load balancer, if using the HTTP protocol. For HTTPS, a DNS-validated certificate will be created for the load balancer's specified domain name if a domain name and domain zone are specified.
|
|
1926
|
+
|
|
1927
|
+
Certificate Manager certificate to associate with the load balancer.
|
|
1928
|
+
|
|
1929
|
+
Setting this option will set the load balancer protocol to HTTPS.
|
|
1930
|
+
|
|
1931
|
+
---
|
|
1932
|
+
|
|
1933
|
+
##### `circuitBreaker`<sup>Optional</sup> <a name="circuitBreaker" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.circuitBreaker"></a>
|
|
1934
|
+
|
|
1935
|
+
```typescript
|
|
1936
|
+
public readonly circuitBreaker: DeploymentCircuitBreaker;
|
|
1937
|
+
```
|
|
1938
|
+
|
|
1939
|
+
- *Type:* aws-cdk-lib.aws_ecs.DeploymentCircuitBreaker
|
|
1940
|
+
- *Default:* disabled
|
|
1941
|
+
|
|
1942
|
+
Whether to enable the deployment circuit breaker.
|
|
1943
|
+
|
|
1944
|
+
If this property is defined, circuit breaker will be implicitly
|
|
1945
|
+
enabled.
|
|
1946
|
+
|
|
1947
|
+
---
|
|
1948
|
+
|
|
1949
|
+
##### `cloudMapOptions`<sup>Optional</sup> <a name="cloudMapOptions" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.cloudMapOptions"></a>
|
|
1950
|
+
|
|
1951
|
+
```typescript
|
|
1952
|
+
public readonly cloudMapOptions: CloudMapOptions;
|
|
1953
|
+
```
|
|
1954
|
+
|
|
1955
|
+
- *Type:* aws-cdk-lib.aws_ecs.CloudMapOptions
|
|
1956
|
+
- *Default:* AWS Cloud Map service discovery is not enabled.
|
|
1957
|
+
|
|
1958
|
+
The options for configuring an Amazon ECS service to use service discovery.
|
|
1959
|
+
|
|
1960
|
+
---
|
|
1961
|
+
|
|
1962
|
+
##### `cluster`<sup>Optional</sup> <a name="cluster" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.cluster"></a>
|
|
1963
|
+
|
|
1964
|
+
```typescript
|
|
1965
|
+
public readonly cluster: ICluster;
|
|
1966
|
+
```
|
|
1967
|
+
|
|
1968
|
+
- *Type:* aws-cdk-lib.aws_ecs.ICluster
|
|
1969
|
+
- *Default:* create a new cluster; if both cluster and vpc are omitted, a new VPC will be created for you.
|
|
1970
|
+
|
|
1971
|
+
The name of the cluster that hosts the service.
|
|
1972
|
+
|
|
1973
|
+
If a cluster is specified, the vpc construct should be omitted. Alternatively, you can omit both cluster and vpc.
|
|
1974
|
+
|
|
1975
|
+
---
|
|
1976
|
+
|
|
1977
|
+
##### `deploymentController`<sup>Optional</sup> <a name="deploymentController" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.deploymentController"></a>
|
|
1978
|
+
|
|
1979
|
+
```typescript
|
|
1980
|
+
public readonly deploymentController: DeploymentController;
|
|
1981
|
+
```
|
|
1982
|
+
|
|
1983
|
+
- *Type:* aws-cdk-lib.aws_ecs.DeploymentController
|
|
1984
|
+
- *Default:* Rolling update (ECS)
|
|
1985
|
+
|
|
1986
|
+
Specifies which deployment controller to use for the service.
|
|
1987
|
+
|
|
1988
|
+
For more information, see
|
|
1989
|
+
[Amazon ECS Deployment Types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html)
|
|
1990
|
+
|
|
1991
|
+
---
|
|
1992
|
+
|
|
1993
|
+
##### `desiredCount`<sup>Optional</sup> <a name="desiredCount" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.desiredCount"></a>
|
|
1994
|
+
|
|
1995
|
+
```typescript
|
|
1996
|
+
public readonly desiredCount: number;
|
|
1997
|
+
```
|
|
1998
|
+
|
|
1999
|
+
- *Type:* number
|
|
2000
|
+
- *Default:* The default is 1 for all new services and uses the existing service's desired count when updating an existing service.
|
|
2001
|
+
|
|
2002
|
+
The desired number of instantiations of the task definition to keep running on the service.
|
|
2003
|
+
|
|
2004
|
+
The minimum value is 1
|
|
2005
|
+
|
|
2006
|
+
---
|
|
2007
|
+
|
|
2008
|
+
##### `domainName`<sup>Optional</sup> <a name="domainName" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.domainName"></a>
|
|
2009
|
+
|
|
2010
|
+
```typescript
|
|
2011
|
+
public readonly domainName: string;
|
|
2012
|
+
```
|
|
2013
|
+
|
|
2014
|
+
- *Type:* string
|
|
2015
|
+
- *Default:* No domain name.
|
|
2016
|
+
|
|
2017
|
+
The domain name for the service, e.g. "api.example.com.".
|
|
2018
|
+
|
|
2019
|
+
---
|
|
2020
|
+
|
|
2021
|
+
##### `domainZone`<sup>Optional</sup> <a name="domainZone" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.domainZone"></a>
|
|
2022
|
+
|
|
2023
|
+
```typescript
|
|
2024
|
+
public readonly domainZone: IHostedZone;
|
|
2025
|
+
```
|
|
2026
|
+
|
|
2027
|
+
- *Type:* aws-cdk-lib.aws_route53.IHostedZone
|
|
2028
|
+
- *Default:* No Route53 hosted domain zone.
|
|
2029
|
+
|
|
2030
|
+
The Route53 hosted zone for the domain, e.g. "example.com.".
|
|
2031
|
+
|
|
2032
|
+
---
|
|
2033
|
+
|
|
2034
|
+
##### `enableECSManagedTags`<sup>Optional</sup> <a name="enableECSManagedTags" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.enableECSManagedTags"></a>
|
|
2035
|
+
|
|
2036
|
+
```typescript
|
|
2037
|
+
public readonly enableECSManagedTags: boolean;
|
|
2038
|
+
```
|
|
2039
|
+
|
|
2040
|
+
- *Type:* boolean
|
|
2041
|
+
- *Default:* false
|
|
2042
|
+
|
|
2043
|
+
Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
|
|
2044
|
+
|
|
2045
|
+
For more information, see
|
|
2046
|
+
[Tagging Your Amazon ECS Resources](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html)
|
|
2047
|
+
|
|
2048
|
+
---
|
|
2049
|
+
|
|
2050
|
+
##### `enableExecuteCommand`<sup>Optional</sup> <a name="enableExecuteCommand" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.enableExecuteCommand"></a>
|
|
2051
|
+
|
|
2052
|
+
```typescript
|
|
2053
|
+
public readonly enableExecuteCommand: boolean;
|
|
2054
|
+
```
|
|
2055
|
+
|
|
2056
|
+
- *Type:* boolean
|
|
2057
|
+
- *Default:* false
|
|
2058
|
+
|
|
2059
|
+
Whether ECS Exec should be enabled.
|
|
2060
|
+
|
|
2061
|
+
---
|
|
2062
|
+
|
|
2063
|
+
##### `healthCheckGracePeriod`<sup>Optional</sup> <a name="healthCheckGracePeriod" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.healthCheckGracePeriod"></a>
|
|
2064
|
+
|
|
2065
|
+
```typescript
|
|
2066
|
+
public readonly healthCheckGracePeriod: Duration;
|
|
2067
|
+
```
|
|
2068
|
+
|
|
2069
|
+
- *Type:* aws-cdk-lib.Duration
|
|
2070
|
+
- *Default:* defaults to 60 seconds if at least one load balancer is in-use and it is not already set
|
|
2071
|
+
|
|
2072
|
+
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.
|
|
2073
|
+
|
|
2074
|
+
---
|
|
2075
|
+
|
|
2076
|
+
##### `idleTimeout`<sup>Optional</sup> <a name="idleTimeout" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.idleTimeout"></a>
|
|
2077
|
+
|
|
2078
|
+
```typescript
|
|
2079
|
+
public readonly idleTimeout: Duration;
|
|
2080
|
+
```
|
|
2081
|
+
|
|
2082
|
+
- *Type:* aws-cdk-lib.Duration
|
|
2083
|
+
- *Default:* CloudFormation sets idle timeout to 60 seconds
|
|
2084
|
+
|
|
2085
|
+
The load balancer idle timeout, in seconds.
|
|
2086
|
+
|
|
2087
|
+
Can be between 1 and 4000 seconds
|
|
2088
|
+
|
|
2089
|
+
---
|
|
2090
|
+
|
|
2091
|
+
##### `listenerPort`<sup>Optional</sup> <a name="listenerPort" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.listenerPort"></a>
|
|
2092
|
+
|
|
2093
|
+
```typescript
|
|
2094
|
+
public readonly listenerPort: number;
|
|
2095
|
+
```
|
|
2096
|
+
|
|
2097
|
+
- *Type:* number
|
|
2098
|
+
- *Default:* The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
|
|
2099
|
+
|
|
2100
|
+
Listener port of the application load balancer that will serve traffic to the service.
|
|
2101
|
+
|
|
2102
|
+
---
|
|
2103
|
+
|
|
2104
|
+
##### `loadBalancer`<sup>Optional</sup> <a name="loadBalancer" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.loadBalancer"></a>
|
|
2105
|
+
|
|
2106
|
+
```typescript
|
|
2107
|
+
public readonly loadBalancer: IApplicationLoadBalancer;
|
|
2108
|
+
```
|
|
2109
|
+
|
|
2110
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.IApplicationLoadBalancer
|
|
2111
|
+
- *Default:* a new load balancer will be created.
|
|
2112
|
+
|
|
2113
|
+
The application load balancer that will serve traffic to the service.
|
|
2114
|
+
|
|
2115
|
+
The VPC attribute of a load balancer must be specified for it to be used
|
|
2116
|
+
to create a new service with this pattern.
|
|
2117
|
+
|
|
2118
|
+
[disable-awslint:ref-via-interface]
|
|
2119
|
+
|
|
2120
|
+
---
|
|
2121
|
+
|
|
2122
|
+
##### `loadBalancerName`<sup>Optional</sup> <a name="loadBalancerName" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.loadBalancerName"></a>
|
|
2123
|
+
|
|
2124
|
+
```typescript
|
|
2125
|
+
public readonly loadBalancerName: string;
|
|
2126
|
+
```
|
|
2127
|
+
|
|
2128
|
+
- *Type:* string
|
|
2129
|
+
- *Default:* Automatically generated name.
|
|
2130
|
+
|
|
2131
|
+
Name of the load balancer.
|
|
2132
|
+
|
|
2133
|
+
---
|
|
2134
|
+
|
|
2135
|
+
##### `maxHealthyPercent`<sup>Optional</sup> <a name="maxHealthyPercent" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.maxHealthyPercent"></a>
|
|
2136
|
+
|
|
2137
|
+
```typescript
|
|
2138
|
+
public readonly maxHealthyPercent: number;
|
|
2139
|
+
```
|
|
2140
|
+
|
|
2141
|
+
- *Type:* number
|
|
2142
|
+
- *Default:* 100 if daemon, otherwise 200
|
|
2143
|
+
|
|
2144
|
+
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.
|
|
2145
|
+
|
|
2146
|
+
---
|
|
2147
|
+
|
|
2148
|
+
##### `minHealthyPercent`<sup>Optional</sup> <a name="minHealthyPercent" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.minHealthyPercent"></a>
|
|
2149
|
+
|
|
2150
|
+
```typescript
|
|
2151
|
+
public readonly minHealthyPercent: number;
|
|
2152
|
+
```
|
|
2153
|
+
|
|
2154
|
+
- *Type:* number
|
|
2155
|
+
- *Default:* 0 if daemon, otherwise 50
|
|
2156
|
+
|
|
2157
|
+
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.
|
|
2158
|
+
|
|
2159
|
+
---
|
|
2160
|
+
|
|
2161
|
+
##### `openListener`<sup>Optional</sup> <a name="openListener" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.openListener"></a>
|
|
2162
|
+
|
|
2163
|
+
```typescript
|
|
2164
|
+
public readonly openListener: boolean;
|
|
2165
|
+
```
|
|
2166
|
+
|
|
2167
|
+
- *Type:* boolean
|
|
2168
|
+
- *Default:* true -- The security group allows ingress from all IP addresses.
|
|
2169
|
+
|
|
2170
|
+
Determines whether or not the Security Group for the Load Balancer's Listener will be open to all traffic by default.
|
|
2171
|
+
|
|
2172
|
+
---
|
|
2173
|
+
|
|
2174
|
+
##### `propagateTags`<sup>Optional</sup> <a name="propagateTags" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.propagateTags"></a>
|
|
2175
|
+
|
|
2176
|
+
```typescript
|
|
2177
|
+
public readonly propagateTags: PropagatedTagSource;
|
|
2178
|
+
```
|
|
2179
|
+
|
|
2180
|
+
- *Type:* aws-cdk-lib.aws_ecs.PropagatedTagSource
|
|
2181
|
+
- *Default:* none
|
|
2182
|
+
|
|
2183
|
+
Specifies whether to propagate the tags from the task definition or the service to the tasks in the service.
|
|
2184
|
+
|
|
2185
|
+
Tags can only be propagated to the tasks within the service during service creation.
|
|
2186
|
+
|
|
2187
|
+
---
|
|
2188
|
+
|
|
2189
|
+
##### `protocol`<sup>Optional</sup> <a name="protocol" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.protocol"></a>
|
|
2190
|
+
|
|
2191
|
+
```typescript
|
|
2192
|
+
public readonly protocol: ApplicationProtocol;
|
|
2193
|
+
```
|
|
2194
|
+
|
|
2195
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationProtocol
|
|
2196
|
+
- *Default:* HTTP. If a certificate is specified, the protocol will be set by default to HTTPS.
|
|
2197
|
+
|
|
2198
|
+
The protocol for connections from clients to the load balancer.
|
|
2199
|
+
|
|
2200
|
+
The load balancer port is determined from the protocol (port 80 for
|
|
2201
|
+
HTTP, port 443 for HTTPS). If HTTPS, either a certificate or domain
|
|
2202
|
+
name and domain zone must also be specified.
|
|
2203
|
+
|
|
2204
|
+
---
|
|
2205
|
+
|
|
2206
|
+
##### `protocolVersion`<sup>Optional</sup> <a name="protocolVersion" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.protocolVersion"></a>
|
|
2207
|
+
|
|
2208
|
+
```typescript
|
|
2209
|
+
public readonly protocolVersion: ApplicationProtocolVersion;
|
|
2210
|
+
```
|
|
2211
|
+
|
|
2212
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationProtocolVersion
|
|
2213
|
+
- *Default:* ApplicationProtocolVersion.HTTP1
|
|
2214
|
+
|
|
2215
|
+
The protocol version to use.
|
|
2216
|
+
|
|
2217
|
+
---
|
|
2218
|
+
|
|
2219
|
+
##### `publicLoadBalancer`<sup>Optional</sup> <a name="publicLoadBalancer" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.publicLoadBalancer"></a>
|
|
2220
|
+
|
|
2221
|
+
```typescript
|
|
2222
|
+
public readonly publicLoadBalancer: boolean;
|
|
2223
|
+
```
|
|
2224
|
+
|
|
2225
|
+
- *Type:* boolean
|
|
2226
|
+
- *Default:* true
|
|
2227
|
+
|
|
2228
|
+
Determines whether the Load Balancer will be internet-facing.
|
|
2229
|
+
|
|
2230
|
+
---
|
|
2231
|
+
|
|
2232
|
+
##### `recordType`<sup>Optional</sup> <a name="recordType" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.recordType"></a>
|
|
2233
|
+
|
|
2234
|
+
```typescript
|
|
2235
|
+
public readonly recordType: ApplicationLoadBalancedServiceRecordType;
|
|
2236
|
+
```
|
|
2237
|
+
|
|
2238
|
+
- *Type:* aws-cdk-lib.aws_ecs_patterns.ApplicationLoadBalancedServiceRecordType
|
|
2239
|
+
- *Default:* ApplicationLoadBalancedServiceRecordType.ALIAS
|
|
2240
|
+
|
|
2241
|
+
Specifies whether the Route53 record should be a CNAME, an A record using the Alias feature or no record at all.
|
|
2242
|
+
|
|
2243
|
+
This is useful if you need to work with DNS systems that do not support alias records.
|
|
2244
|
+
|
|
2245
|
+
---
|
|
2246
|
+
|
|
2247
|
+
##### `redirectHTTP`<sup>Optional</sup> <a name="redirectHTTP" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.redirectHTTP"></a>
|
|
2248
|
+
|
|
2249
|
+
```typescript
|
|
2250
|
+
public readonly redirectHTTP: boolean;
|
|
2251
|
+
```
|
|
2252
|
+
|
|
2253
|
+
- *Type:* boolean
|
|
2254
|
+
- *Default:* false
|
|
2255
|
+
|
|
2256
|
+
Specifies whether the load balancer should redirect traffic on port 80 to port 443 to support HTTP->HTTPS redirects This is only valid if the protocol of the ALB is HTTPS.
|
|
2257
|
+
|
|
2258
|
+
---
|
|
2259
|
+
|
|
2260
|
+
##### `serviceName`<sup>Optional</sup> <a name="serviceName" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.serviceName"></a>
|
|
2261
|
+
|
|
2262
|
+
```typescript
|
|
2263
|
+
public readonly serviceName: string;
|
|
2264
|
+
```
|
|
2265
|
+
|
|
2266
|
+
- *Type:* string
|
|
2267
|
+
- *Default:* CloudFormation-generated name.
|
|
2268
|
+
|
|
2269
|
+
The name of the service.
|
|
2270
|
+
|
|
2271
|
+
---
|
|
2272
|
+
|
|
2273
|
+
##### `sslPolicy`<sup>Optional</sup> <a name="sslPolicy" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.sslPolicy"></a>
|
|
2274
|
+
|
|
2275
|
+
```typescript
|
|
2276
|
+
public readonly sslPolicy: SslPolicy;
|
|
2277
|
+
```
|
|
2278
|
+
|
|
2279
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.SslPolicy
|
|
2280
|
+
- *Default:* The recommended elastic load balancing security policy
|
|
2281
|
+
|
|
2282
|
+
The security policy that defines which ciphers and protocols are supported by the ALB Listener.
|
|
2283
|
+
|
|
2284
|
+
---
|
|
2285
|
+
|
|
2286
|
+
##### `targetProtocol`<sup>Optional</sup> <a name="targetProtocol" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.targetProtocol"></a>
|
|
2287
|
+
|
|
2288
|
+
```typescript
|
|
2289
|
+
public readonly targetProtocol: ApplicationProtocol;
|
|
2290
|
+
```
|
|
2291
|
+
|
|
2292
|
+
- *Type:* aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationProtocol
|
|
2293
|
+
- *Default:* HTTP.
|
|
2294
|
+
|
|
2295
|
+
The protocol for connections from the load balancer to the ECS tasks.
|
|
2296
|
+
|
|
2297
|
+
The default target port is determined from the protocol (port 80 for
|
|
2298
|
+
HTTP, port 443 for HTTPS).
|
|
2299
|
+
|
|
2300
|
+
---
|
|
2301
|
+
|
|
2302
|
+
##### `taskImageOptions`<sup>Optional</sup> <a name="taskImageOptions" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.taskImageOptions"></a>
|
|
2303
|
+
|
|
2304
|
+
```typescript
|
|
2305
|
+
public readonly taskImageOptions: ApplicationLoadBalancedTaskImageOptions;
|
|
2306
|
+
```
|
|
2307
|
+
|
|
2308
|
+
- *Type:* aws-cdk-lib.aws_ecs_patterns.ApplicationLoadBalancedTaskImageOptions
|
|
2309
|
+
- *Default:* none
|
|
2310
|
+
|
|
2311
|
+
The properties required to create a new task definition.
|
|
2312
|
+
|
|
2313
|
+
TaskDefinition or TaskImageOptions must be specified, but not both.
|
|
2314
|
+
|
|
2315
|
+
---
|
|
2316
|
+
|
|
2317
|
+
##### `vpc`<sup>Optional</sup> <a name="vpc" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.vpc"></a>
|
|
2318
|
+
|
|
2319
|
+
```typescript
|
|
2320
|
+
public readonly vpc: IVpc;
|
|
2321
|
+
```
|
|
2322
|
+
|
|
2323
|
+
- *Type:* aws-cdk-lib.aws_ec2.IVpc
|
|
2324
|
+
- *Default:* uses the VPC defined in the cluster or creates a new VPC.
|
|
2325
|
+
|
|
2326
|
+
The VPC where the container instances will be launched or the elastic network interfaces (ENIs) will be deployed.
|
|
2327
|
+
|
|
2328
|
+
If a vpc is specified, the cluster construct should be omitted. Alternatively, you can omit both vpc and cluster.
|
|
2329
|
+
|
|
2330
|
+
---
|
|
2331
|
+
|
|
2332
|
+
##### `cpu`<sup>Optional</sup> <a name="cpu" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.cpu"></a>
|
|
2333
|
+
|
|
2334
|
+
```typescript
|
|
2335
|
+
public readonly cpu: number;
|
|
2336
|
+
```
|
|
2337
|
+
|
|
2338
|
+
- *Type:* number
|
|
2339
|
+
- *Default:* 256
|
|
2340
|
+
|
|
2341
|
+
The number of cpu units used by the task.
|
|
2342
|
+
|
|
2343
|
+
Valid values, which determines your range of valid values for the memory parameter:
|
|
2344
|
+
|
|
2345
|
+
256 (.25 vCPU) - Available memory values: 0.5GB, 1GB, 2GB
|
|
2346
|
+
|
|
2347
|
+
512 (.5 vCPU) - Available memory values: 1GB, 2GB, 3GB, 4GB
|
|
2348
|
+
|
|
2349
|
+
1024 (1 vCPU) - Available memory values: 2GB, 3GB, 4GB, 5GB, 6GB, 7GB, 8GB
|
|
2350
|
+
|
|
2351
|
+
2048 (2 vCPU) - Available memory values: Between 4GB and 16GB in 1GB increments
|
|
2352
|
+
|
|
2353
|
+
4096 (4 vCPU) - Available memory values: Between 8GB and 30GB in 1GB increments
|
|
2354
|
+
|
|
2355
|
+
8192 (8 vCPU) - Available memory values: Between 16GB and 60GB in 4GB increments
|
|
2356
|
+
|
|
2357
|
+
16384 (16 vCPU) - Available memory values: Between 32GB and 120GB in 8GB increments
|
|
2358
|
+
|
|
2359
|
+
This default is set in the underlying FargateTaskDefinition construct.
|
|
2360
|
+
|
|
2361
|
+
---
|
|
2362
|
+
|
|
2363
|
+
##### `ephemeralStorageGiB`<sup>Optional</sup> <a name="ephemeralStorageGiB" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.ephemeralStorageGiB"></a>
|
|
2364
|
+
|
|
2365
|
+
```typescript
|
|
2366
|
+
public readonly ephemeralStorageGiB: number;
|
|
2367
|
+
```
|
|
2368
|
+
|
|
2369
|
+
- *Type:* number
|
|
2370
|
+
- *Default:* Undefined, in which case, the task will receive 20GiB ephemeral storage.
|
|
2371
|
+
|
|
2372
|
+
The amount (in GiB) of ephemeral storage to be allocated to the task.
|
|
2373
|
+
|
|
2374
|
+
The minimum supported value is `21` GiB and the maximum supported value is `200` GiB.
|
|
2375
|
+
|
|
2376
|
+
Only supported in Fargate platform version 1.4.0 or later.
|
|
2377
|
+
|
|
2378
|
+
---
|
|
2379
|
+
|
|
2380
|
+
##### `memoryLimitMiB`<sup>Optional</sup> <a name="memoryLimitMiB" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.memoryLimitMiB"></a>
|
|
2381
|
+
|
|
2382
|
+
```typescript
|
|
2383
|
+
public readonly memoryLimitMiB: number;
|
|
2384
|
+
```
|
|
2385
|
+
|
|
2386
|
+
- *Type:* number
|
|
2387
|
+
- *Default:* 512
|
|
2388
|
+
|
|
2389
|
+
The amount (in MiB) of memory used by the task.
|
|
2390
|
+
|
|
2391
|
+
This field is required and you must use one of the following values, which determines your range of valid values
|
|
2392
|
+
for the cpu parameter:
|
|
2393
|
+
|
|
2394
|
+
512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU)
|
|
2395
|
+
|
|
2396
|
+
1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU)
|
|
2397
|
+
|
|
2398
|
+
2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU)
|
|
2399
|
+
|
|
2400
|
+
Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU)
|
|
2401
|
+
|
|
2402
|
+
Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU)
|
|
2403
|
+
|
|
2404
|
+
Between 16384 (16 GB) and 61440 (60 GB) in increments of 4096 (4 GB) - Available cpu values: 8192 (8 vCPU)
|
|
2405
|
+
|
|
2406
|
+
Between 32768 (32 GB) and 122880 (120 GB) in increments of 8192 (8 GB) - Available cpu values: 16384 (16 vCPU)
|
|
2407
|
+
|
|
2408
|
+
This default is set in the underlying FargateTaskDefinition construct.
|
|
2409
|
+
|
|
2410
|
+
---
|
|
2411
|
+
|
|
2412
|
+
##### `platformVersion`<sup>Optional</sup> <a name="platformVersion" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.platformVersion"></a>
|
|
2413
|
+
|
|
2414
|
+
```typescript
|
|
2415
|
+
public readonly platformVersion: FargatePlatformVersion;
|
|
2416
|
+
```
|
|
2417
|
+
|
|
2418
|
+
- *Type:* aws-cdk-lib.aws_ecs.FargatePlatformVersion
|
|
2419
|
+
- *Default:* Latest
|
|
2420
|
+
|
|
2421
|
+
The platform version on which to run your service.
|
|
2422
|
+
|
|
2423
|
+
If one is not specified, the LATEST platform version is used by default. For more information, see
|
|
2424
|
+
[AWS Fargate Platform Versions](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html)
|
|
2425
|
+
in the Amazon Elastic Container Service Developer Guide.
|
|
2426
|
+
|
|
2427
|
+
---
|
|
2428
|
+
|
|
2429
|
+
##### `runtimePlatform`<sup>Optional</sup> <a name="runtimePlatform" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.runtimePlatform"></a>
|
|
2430
|
+
|
|
2431
|
+
```typescript
|
|
2432
|
+
public readonly runtimePlatform: RuntimePlatform;
|
|
2433
|
+
```
|
|
2434
|
+
|
|
2435
|
+
- *Type:* aws-cdk-lib.aws_ecs.RuntimePlatform
|
|
2436
|
+
- *Default:* If the property is undefined, `operatingSystemFamily` is LINUX and `cpuArchitecture` is X86_64
|
|
2437
|
+
|
|
2438
|
+
The runtime platform of the task definition.
|
|
2439
|
+
|
|
2440
|
+
---
|
|
2441
|
+
|
|
2442
|
+
##### `taskDefinition`<sup>Optional</sup> <a name="taskDefinition" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.taskDefinition"></a>
|
|
2443
|
+
|
|
2444
|
+
```typescript
|
|
2445
|
+
public readonly taskDefinition: FargateTaskDefinition;
|
|
2446
|
+
```
|
|
2447
|
+
|
|
2448
|
+
- *Type:* aws-cdk-lib.aws_ecs.FargateTaskDefinition
|
|
2449
|
+
- *Default:* none
|
|
2450
|
+
|
|
2451
|
+
The task definition to use for tasks in the service. TaskDefinition or TaskImageOptions must be specified, but not both.
|
|
2452
|
+
|
|
2453
|
+
[disable-awslint:ref-via-interface]
|
|
2454
|
+
|
|
2455
|
+
---
|
|
2456
|
+
|
|
2457
|
+
##### `assignPublicIp`<sup>Optional</sup> <a name="assignPublicIp" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.assignPublicIp"></a>
|
|
2458
|
+
|
|
2459
|
+
```typescript
|
|
2460
|
+
public readonly assignPublicIp: boolean;
|
|
2461
|
+
```
|
|
2462
|
+
|
|
2463
|
+
- *Type:* boolean
|
|
2464
|
+
- *Default:* false
|
|
2465
|
+
|
|
2466
|
+
Determines whether the service will be assigned a public IP address.
|
|
2467
|
+
|
|
2468
|
+
---
|
|
2469
|
+
|
|
2470
|
+
##### `healthCheck`<sup>Optional</sup> <a name="healthCheck" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.healthCheck"></a>
|
|
2471
|
+
|
|
2472
|
+
```typescript
|
|
2473
|
+
public readonly healthCheck: HealthCheck;
|
|
2474
|
+
```
|
|
2475
|
+
|
|
2476
|
+
- *Type:* aws-cdk-lib.aws_ecs.HealthCheck
|
|
2477
|
+
- *Default:* Health check configuration from container.
|
|
2478
|
+
|
|
2479
|
+
The health check command and associated configuration parameters for the container.
|
|
2480
|
+
|
|
2481
|
+
---
|
|
2482
|
+
|
|
2483
|
+
##### `securityGroups`<sup>Optional</sup> <a name="securityGroups" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.securityGroups"></a>
|
|
2484
|
+
|
|
2485
|
+
```typescript
|
|
2486
|
+
public readonly securityGroups: ISecurityGroup[];
|
|
2487
|
+
```
|
|
2488
|
+
|
|
2489
|
+
- *Type:* aws-cdk-lib.aws_ec2.ISecurityGroup[]
|
|
2490
|
+
- *Default:* A new security group is created.
|
|
2491
|
+
|
|
2492
|
+
The security groups to associate with the service.
|
|
2493
|
+
|
|
2494
|
+
If you do not specify a security group, a new security group is created.
|
|
2495
|
+
|
|
2496
|
+
---
|
|
2497
|
+
|
|
2498
|
+
##### `taskSubnets`<sup>Optional</sup> <a name="taskSubnets" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.taskSubnets"></a>
|
|
2499
|
+
|
|
2500
|
+
```typescript
|
|
2501
|
+
public readonly taskSubnets: SubnetSelection;
|
|
2502
|
+
```
|
|
2503
|
+
|
|
2504
|
+
- *Type:* aws-cdk-lib.aws_ec2.SubnetSelection
|
|
2505
|
+
- *Default:* Public subnets if `assignPublicIp` is set, otherwise the first available one of Private, Isolated, Public, in that order.
|
|
2506
|
+
|
|
2507
|
+
The subnets to associate with the service.
|
|
2508
|
+
|
|
2509
|
+
---
|
|
2510
|
+
|
|
2511
|
+
##### `containerPort`<sup>Optional</sup> <a name="containerPort" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.containerPort"></a>
|
|
2512
|
+
|
|
2513
|
+
```typescript
|
|
2514
|
+
public readonly containerPort: number;
|
|
2515
|
+
```
|
|
2516
|
+
|
|
2517
|
+
- *Type:* number
|
|
2518
|
+
|
|
2519
|
+
The container port.
|
|
2520
|
+
|
|
2521
|
+
---
|
|
2522
|
+
|
|
2523
|
+
##### `customHttpHeaderValue`<sup>Optional</sup> <a name="customHttpHeaderValue" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.customHttpHeaderValue"></a>
|
|
2524
|
+
|
|
2525
|
+
```typescript
|
|
2526
|
+
public readonly customHttpHeaderValue: string;
|
|
2527
|
+
```
|
|
2528
|
+
|
|
2529
|
+
- *Type:* string
|
|
2530
|
+
|
|
2531
|
+
The custom http header value.
|
|
2532
|
+
|
|
2533
|
+
---
|
|
2534
|
+
|
|
2535
|
+
##### `maxTaskCount`<sup>Optional</sup> <a name="maxTaskCount" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.maxTaskCount"></a>
|
|
2536
|
+
|
|
2537
|
+
```typescript
|
|
2538
|
+
public readonly maxTaskCount: number;
|
|
2539
|
+
```
|
|
2540
|
+
|
|
2541
|
+
- *Type:* number
|
|
2542
|
+
|
|
2543
|
+
The maximum number of task.
|
|
2544
|
+
|
|
2545
|
+
---
|
|
2546
|
+
|
|
2547
|
+
##### `minTaskCount`<sup>Optional</sup> <a name="minTaskCount" id="tm-cdk-constructs.TmApplicationLoadBalancedFargateServiceProps.property.minTaskCount"></a>
|
|
2548
|
+
|
|
2549
|
+
```typescript
|
|
2550
|
+
public readonly minTaskCount: number;
|
|
2551
|
+
```
|
|
2552
|
+
|
|
2553
|
+
- *Type:* number
|
|
2554
|
+
|
|
2555
|
+
The minumun number od tasks.
|
|
2556
|
+
|
|
2557
|
+
---
|
|
2558
|
+
|
|
1610
2559
|
### TmPipelineProps <a name="TmPipelineProps" id="tm-cdk-constructs.TmPipelineProps"></a>
|
|
1611
2560
|
|
|
1612
2561
|
#### Initializer <a name="Initializer" id="tm-cdk-constructs.TmPipelineProps.Initializer"></a>
|