Cdk component that creates a static website using S3, configures CloudFront (CDN) and maps a custom domain via Route53 (DNS)
Project description
@cloudcomponents/cdk-static-website
Cdk component that creates a static website using S3, configures CloudFront (CDN) and maps a custom domain via Route53 (DNS)
Install
TypeScript/JavaScript:
npm i @cloudcomponents/cdk-static-website
Python:
pip install cloudcomponents.cdk-static-website
How to use
Example 1: With an existing certificate
import { Construct, RemovalPolicy, Stack, StackProps } from '@aws-cdk/core';
import { StringParameter } from '@aws-cdk/aws-ssm';
import { SecurityPolicyProtocol } from '@aws-cdk/aws-cloudfront';
import { StaticWebsite } from '@cloudcomponents/cdk-static-website';
import { HttpHeaders } from '@cloudcomponents/cdk-lambda-at-edge-pattern';
export class StaticWebsiteStack extends Stack {
constructor(scope: Construct, id: string, props: StackProps) {
super(scope, id, props);
const certificateArn = StringParameter.valueFromLookup(
this,
'/certificate/cloudcomponents.org',
);
const website = new StaticWebsite(this, 'StaticWebsite', {
bucketConfiguration: {
removalPolicy: RemovalPolicy.DESTROY,
},
aliasConfiguration: {
domainName: 'cloudcomponents.org',
names: ['www.cloudcomponents.org', 'cloudcomponents.org'],
acmCertRef: certificateArn,
},
});
// A us-east-1 stack is generated under the hood
const httpHeaders = new HttpHeaders(this, 'HttpHeaders', {
httpHeaders: {
'Content-Security-Policy':
"default-src 'none'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; object-src 'none'; connect-src 'self'",
'Strict-Transport-Security':
'max-age=31536000; includeSubdomains; preload',
'Referrer-Policy': 'same-origin',
'X-XSS-Protection': '1; mode=block',
'X-Frame-Options': 'DENY',
'X-Content-Type-Options': 'nosniff',
'Cache-Control': 'no-cache',
},
});
website.addLambdaFunctionAssociation(httpHeaders);
}
}
Example 2: Cloudfront URL with existing sources and up to date Securitypolicy
import { Construct, RemovalPolicy, Stack, StackProps } from '@aws-cdk/core';
import { StringParameter } from '@aws-cdk/aws-ssm';
import { StaticWebsite } from '@cloudcomponents/cdk-static-website';
import { SecurityPolicyProtocol } from '@aws-cdk/aws-cloudfront';
export class StaticWebsiteWithExistingSourcesAndSecurityPolicyStack extends Stack {
constructor(scope: Construct, id: string, props?: StackProps) {
super(scope, id, props);
const certificateArn = StringParameter.valueFromLookup(
this,
'/certificate/cloudcomponents.org',
);
new StaticWebsite(this, 'StaticWebsite', {
bucketConfiguration: {
source: '../path/to/your/static/webpage',
removalPolicy: RemovalPolicy.DESTROY,
},
aliasConfiguration: {
domainName: 'cloudcomponents.org',
names: ['www.cloudcomponents.org', 'cloudcomponents.org'],
acmCertRef: certificateArn,
securityPolicy: SecurityPolicyProtocol.TLS_V1_2_2018
},
});
}
}
Lambda@Edge function
website.addLambdaFunctionAssociation({
eventType: LambdaEdgeEventType.ORIGIN_REQUEST,
lambdaFunction: Version.fromVersionArn(
stack,
'LambdaEdge',
'arn:aws:lambda:us-east-1:123456789012:function:my-function:1',
),
});
API Reference
See API.md.
Example
See more complete examples.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for cloudcomponents.cdk-static-website-1.50.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | f0d18ec60416d4eb264c3430c226ac4b220fcf850ff9ebf129823c8e60a03b12 |
|
MD5 | bed96e8c3e6da8edcd2efb4d569ac417 |
|
BLAKE2b-256 | fdc84e09c93fe835ced1dd0ae0a54a06e64b1bf78bb1131c0e0ce9e5e1de7229 |
Close
Hashes for cloudcomponents.cdk_static_website-1.50.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9a28f9f61c375bb2e79ca924b872e9835dda70578b334c6ad256755bf7b7bd0e |
|
MD5 | d372ef2ca286da62e4080d1668d51f46 |
|
BLAKE2b-256 | c5a875ccaa31380b55d9f611a11b5a9dad5133f252ce489098b506ac0245d418 |