Class SiteWithEcsBackend

Provides a construct to create and deploy a site hosted with an clustered ECS/ELB backend

Example

import { SiteWithEcsBackend, SiteWithEcsBackendProps } '@gradientedge/cdk-utils'
import { Construct } from 'constructs'

class CustomConstruct extends SiteWithEcsBackend {
  constructor(parent: Construct, id: string, props: SiteWithEcsBackendProps) {
    super(parent, id, props)
    this.props = props
    this.id = id
    this.initResources()
  }
}

Hierarchy (View Summary)

CommonConstruct
- SiteWithEcsBackend

Index

Constructors

constructor

Properties

acmManager apiManager appConfigManager cloudFrontManager cloudTrailManager cloudWatchManager codeBuildManager dynamodbManager ecrManager ecsManager efsManager eksManager elasticacheManager eventManager eventTargetManager evidentlyManager fullyQualifiedDomainName iamManager id kmsManager lambdaManager logManager node props resourceNameFormatter route53Manager s3Manager secretsManager sfnManager siteCachePolicy siteCertificate siteCloudfrontFunction siteDistribution siteDomainNames siteEcsBuildArgs siteEcsCluster siteEcsContainerImage siteEcsEnvironment siteEcsListener siteEcsLoadBalancer siteEcsLogGroup siteEcsPolicy siteEcsRole siteEcsService siteEcsTargetGroup siteEcsTaskDefinition siteExternalDomainName siteFileSystem siteFunctionAssociations siteHostedZone siteInternalDomainName siteLogBucket siteOrigin siteOriginRequestPolicy siteOriginResponseHeadersPolicy? siteRegionalCertificate siteSecrets siteVpc snsManager sqsManager ssmManager vpcManager wafManager

Constructors

constructor

new SiteWithEcsBackend(
    parent: Construct,
    id: string,
    props: SiteWithEcsBackendProps,
): SiteWithEcsBackend
Parameters
- parent: Construct
- id: string
- props: SiteWithEcsBackendProps
Returns SiteWithEcsBackend
Overrides CommonConstruct.constructor
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:93

Properties

acmManager

acmManager: AcmManager

apiManager

apiManager: ApiManager

appConfigManager

appConfigManager: AppConfigManager

cloudFrontManager

cloudFrontManager: CloudFrontManager

cloudTrailManager

cloudTrailManager: CloudTrailManager

cloudWatchManager

cloudWatchManager: CloudWatchManager

codeBuildManager

codeBuildManager: CodeBuildManager

dynamodbManager

dynamodbManager: DynamodbManager

ecrManager

ecrManager: EcrManager

ecsManager

ecsManager: EcsManager

efsManager

efsManager: EfsManager

eksManager

eksManager: EksManager

elasticacheManager

elasticacheManager: ElastiCacheManager

eventManager

eventManager: EventManager

eventTargetManager

eventTargetManager: EventTargetManager

evidentlyManager

evidentlyManager: EvidentlyManager

fullyQualifiedDomainName

fullyQualifiedDomainName: string

iamManager

iamManager: IamManager

id

id: string

kmsManager

kmsManager: KmsManager

lambdaManager

lambdaManager: LambdaManager

logManager

logManager: LogManager

`Readonly`node

node: Node

The tree node.

props

props: SiteWithEcsBackendProps

resourceNameFormatter

resourceNameFormatter: ResourceNameFormatter

route53Manager

route53Manager: Route53Manager

s3Manager

s3Manager: S3Manager

secretsManager

secretsManager: SecretsManager

sfnManager

sfnManager: SfnManager

siteCachePolicy

siteCachePolicy: CachePolicy

siteCertificate

siteCertificate: ICertificate

siteCloudfrontFunction

siteCloudfrontFunction: IFunction

siteDistribution

siteDistribution: Distribution

siteDomainNames

siteDomainNames: string[]

siteEcsBuildArgs

siteEcsBuildArgs: any = {}

siteEcsCluster

siteEcsCluster: Cluster

siteEcsContainerImage

siteEcsContainerImage: AssetImage

siteEcsEnvironment

siteEcsEnvironment: { [key: string]: string }

siteEcsListener

siteEcsListener: ApplicationListener

siteEcsLoadBalancer

siteEcsLoadBalancer: ApplicationLoadBalancer

siteEcsLogGroup

siteEcsLogGroup: LogGroup

siteEcsPolicy

siteEcsPolicy: PolicyDocument

siteEcsRole

siteEcsRole: Role

siteEcsService

siteEcsService: FargateService

siteEcsTargetGroup

siteEcsTargetGroup: ApplicationTargetGroup

siteEcsTaskDefinition

siteEcsTaskDefinition: FargateTaskDefinition

siteExternalDomainName

siteExternalDomainName: string

siteFileSystem

siteFileSystem: FileSystem

siteFunctionAssociations

siteFunctionAssociations: FunctionAssociation[]

siteHostedZone

siteHostedZone: IHostedZone

siteInternalDomainName

siteInternalDomainName: string

siteLogBucket

siteLogBucket: IBucket

siteOrigin

siteOrigin: HttpOrigin

siteOriginRequestPolicy

siteOriginRequestPolicy: OriginRequestPolicy

`Optional`siteOriginResponseHeadersPolicy

siteOriginResponseHeadersPolicy?: ResponseHeadersPolicy

siteRegionalCertificate

siteRegionalCertificate: ICertificate

siteSecrets

siteSecrets: any

siteVpc

siteVpc: IVpc

snsManager

snsManager: SnsManager

sqsManager

sqsManager: SqsManager

ssmManager

ssmManager: SsmManager

vpcManager

vpcManager: VpcManager

wafManager

wafManager: WafManager

Methods

`Protected`addCfnOutput

addCfnOutput(
    id: string,
    value: string,
    description?: string,
    overrideId?: boolean,
): CfnOutput
Parameters
- id: string
  scoped id of the resource
- value: string
  the value of the exported output
- Optionaldescription: string
  optional description for the output
- overrideId: boolean = true
  Flag which indicates whether to override the default logical id of the output
Returns CfnOutput
Inherited from CommonConstruct.addCfnOutput
- Defined in packages/aws/src/common/construct.ts:133

`Protected`createDistribution

createDistribution(): void
Method to create Site distribution

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:549

`Protected`createEcsBuildArgs

createEcsBuildArgs(): void
Method to create docker build arguments for ECS Image step

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:279

`Protected`createEcsCluster

createEcsCluster(): void
Method to create an ECS cluster

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:260

`Protected`createEcsContainerImage

createEcsContainerImage(): void
Method to create container image for ECS task

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:286

`Protected`createEcsEnvironment

createEcsEnvironment(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:249

`Protected`createEcsLogGroup

createEcsLogGroup(): void
Method to create log group used by ECS task

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:272

`Protected`createEcsPolicy

createEcsPolicy(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:233

`Protected`createEcsRole

createEcsRole(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:242

`Protected`createEcsService

createEcsService(): void
Method to create Application Load balanced ECS Fargate Service

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:295

`Protected`createNetworkMappings

createNetworkMappings(): void
Method to create Route53 records for distribution

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:566

`Protected`createResponseHeaderPolicy

createResponseHeaderPolicy(
props: SiteResponseHeadersPolicyProps,
): ResponseHeadersPolicy | undefined
Parameters
- props: SiteResponseHeadersPolicyProps
Returns ResponseHeadersPolicy | undefined
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:482

`Protected`createSiteCachePolicy

createSiteCachePolicy(
id: string,
siteCachePolicy: SiteCachePolicyProps,
): CachePolicy
Parameters
- id: string
- siteCachePolicy: SiteCachePolicyProps
Returns CachePolicy
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:438

`Protected`createSiteCloudfrontFunction

createSiteCloudfrontFunction(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:522

`Protected`createSiteLogBucket

createSiteLogBucket(): void
Method to create log bucket for site distribution

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:434

`Protected`createSiteOrigin

createSiteOrigin(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:511

`Protected`createSiteOriginCachePolicy

createSiteOriginCachePolicy(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:454

`Protected`createSiteOriginRequestPolicy

createSiteOriginRequestPolicy(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:462

`Protected`createSiteOriginResponseHeadersPolicy

createSiteOriginResponseHeadersPolicy(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:503

`Protected`invalidateDistributionCache

invalidateDistributionCache(): void
Method to invalidation the cloudfront distribution cache after a deployment

Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:580

isDevelopmentStage

isDevelopmentStage(): boolean
Returns boolean
Inherited from CommonConstruct.isDevelopmentStage
- Defined in packages/aws/src/common/construct.ts:150

isProductionStage

isProductionStage(): boolean
Returns boolean
Inherited from CommonConstruct.isProductionStage
- Defined in packages/aws/src/common/construct.ts:168

isTestStage

isTestStage(): boolean
Returns boolean
Inherited from CommonConstruct.isTestStage
- Defined in packages/aws/src/common/construct.ts:156

isUatStage

isUatStage(): boolean
Returns boolean
Inherited from CommonConstruct.isUatStage
- Defined in packages/aws/src/common/construct.ts:162

`Protected`resolveCertificate

resolveCertificate(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:143

`Protected`resolveGlobalCertificate

resolveGlobalCertificate(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:148

`Protected`resolveHostedZone

resolveHostedZone(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:132

`Protected`resolveRegionalCertificate

resolveRegionalCertificate(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:168

`Protected`resolveSiteDomainNames

resolveSiteDomainNames(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:198

`Protected`resolveSiteFunctionAssociations

resolveSiteFunctionAssociations(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:535

`Protected`resolveSiteSecrets

resolveSiteSecrets(): void
Returns void
- Defined in packages/aws/src/construct/site-with-ecs-backend/main.ts:193

toString

toString(): string
Returns a string representation of this construct.

Returns string
Inherited from CommonConstruct.toString
- Defined in node_modules/.pnpm/constructs@10.6.0/node_modules/constructs/lib/construct.d.ts:314

with

with(...mixins: IMixin[]): IConstruct
Applies one or more mixins to this construct.

Mixins are applied in order. The list of constructs is captured at the start of the call, so constructs added by a mixin will not be visited. Use multiple with() calls if subsequent mixins should apply to added constructs.
Parameters
- ...mixins: IMixin[]
  The mixins to apply
Returns IConstruct
This construct for chaining
Inherited from CommonConstruct.with
- Defined in node_modules/.pnpm/constructs@10.6.0/node_modules/constructs/lib/construct.d.ts:310

`Static`isConstruct

isConstruct(x: any): x is Construct
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.
Parameters
- x: any
  Any object
Returns x is Construct
true if x is an object created from a class which extends Construct.
Inherited from CommonConstruct.isConstruct
- Defined in node_modules/.pnpm/constructs@10.6.0/node_modules/constructs/lib/construct.d.ts:285

Class SiteWithEcsBackend

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns SiteWithEcsBackend

Properties

acmManager

apiManager

appConfigManager

cloudFrontManager

cloudTrailManager

cloudWatchManager

codeBuildManager

dynamodbManager

ecrManager

ecsManager

efsManager

eksManager

elasticacheManager

eventManager

eventTargetManager

evidentlyManager

fullyQualifiedDomainName

iamManager

id

kmsManager

lambdaManager

logManager

Readonlynode

props

resourceNameFormatter

route53Manager

s3Manager

secretsManager

sfnManager

siteCachePolicy

siteCertificate

siteCloudfrontFunction

siteDistribution

siteDomainNames

siteEcsBuildArgs

siteEcsCluster

siteEcsContainerImage

siteEcsEnvironment

siteEcsListener

siteEcsLoadBalancer

siteEcsLogGroup

siteEcsPolicy

siteEcsRole

siteEcsService

siteEcsTargetGroup

siteEcsTaskDefinition

siteExternalDomainName

siteFileSystem

siteFunctionAssociations

siteHostedZone

siteInternalDomainName

siteLogBucket

siteOrigin

siteOriginRequestPolicy

OptionalsiteOriginResponseHeadersPolicy

siteRegionalCertificate

siteSecrets

siteVpc

snsManager

sqsManager

ssmManager

vpcManager

wafManager

Methods

ProtectedaddCfnOutput

Parameters

Returns CfnOutput

ProtectedcreateDistribution

`Readonly`node

`Optional`siteOriginResponseHeadersPolicy

`Protected`addCfnOutput

`Protected`createDistribution

`Protected`createEcsBuildArgs

`Protected`createEcsCluster

`Protected`createEcsContainerImage

`Protected`createEcsEnvironment

`Protected`createEcsLogGroup

`Protected`createEcsPolicy

`Protected`createEcsRole

`Protected`createEcsService

`Protected`createNetworkMappings

`Protected`createResponseHeaderPolicy

`Protected`createSiteCachePolicy

`Protected`createSiteCloudfrontFunction

`Protected`createSiteLogBucket

`Protected`createSiteOrigin

`Protected`createSiteOriginCachePolicy

`Protected`createSiteOriginRequestPolicy

`Protected`createSiteOriginResponseHeadersPolicy

`Protected`createVpc

`Protected`determineFullyQualifiedDomain

`Protected`invalidateDistributionCache

`Protected`resolveCertificate

`Protected`resolveGlobalCertificate

`Protected`resolveHostedZone

`Protected`resolveRegionalCertificate

`Protected`resolveSiteDomainNames

`Protected`resolveSiteFunctionAssociations

`Protected`resolveSiteSecrets