Package: cdk-spa-deploy
CDK-SPA-DeployThis is an AWS CDK Construct to make deploying a single page website (Angular/React/Vue) to AWS S3 behind SSL/Cloudfront as easy as 5 lines of code.Installation and UsageTypescriptnpm install --save cdk-spa-deployAs of version 103.0 this construct now declares peer dependencies rather than bundling them so you can use it with any version of CDK higher than 103.0 without waiting on me to release a new version. The downside is that you will need to install the dependencies it uses for yourself, here is a list:{"constructs":"^3.3.75","@aws-cdk/aws-certificatemanager":"^1.103.0","@aws-cdk/aws-cloudfront":"^1.103.0","@aws-cdk/aws-iam":"^1.103.0","@aws-cdk/aws-route53":"^1.103.0","@aws-cdk/aws-route53-patterns":"^1.103.0","@aws-cdk/aws-route53-targets":"^1.103.0","@aws-cdk/aws-s3":"^1.103.0","@aws-cdk/aws-s3-deployment":"^1.103.0","@aws-cdk/core":"^1.103.0"}# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826importaws_cdk.coreascdkfromcdk_spa_deployimportSPADeployclassCdkStack(cdk.Stack):def__init__(self,scope,id,*,description=None,env=None,stackName=None,tags=None,synthesizer=None,terminationProtection=None,analyticsReporting=None):super().__init__(scope,id,description=description,env=env,stackName=stackName,tags=tags,synthesizer=synthesizer,terminationProtection=terminationProtection,analyticsReporting=analyticsReporting)SPADeploy(self,"spaDeploy").create_basic_site(index_doc="index.html",website_folder="../blog/dist/blog")SPADeploy(self,"cfDeploy").create_site_with_cloudfront(index_doc="index.html",website_folder="../blog/dist/blog")Pythonpip install cdk-spa-deployNote As of version 103.0 this construct now declares peer dependencies rather than bundling them so you can use it with any version of CDK higher than 103.0 without waiting on me to release a new version. The downside is that you will need to install the dependencies it uses for yourself. The npm versioms are listed above.fromaws_cdkimportcorefromspa_deployimportSPADeployclassPythonStack(core.Stack):def__init__(self,scope:core.Construct,id:str,**kwargs)->None:super().__init__(scope,id,**kwargs)SPADeploy(self,'spaDeploy').create_basic_site(index_doc='index.html',website_folder='../blog/blog/dist/blog')SPADeploy(self,'cfDeploy').create_site_with_cloudfront(index_doc='index.html',website_folder='../blog/blog/dist/blog')Dotnet / C#This project has now been published to nuget, more details to follow soon but you can find ithereNote As of version 103.0 this construct now declares peer dependencies rather than bundling them so you can use it with any version of CDK higher than 103.0 without waiting on me to release a new version. The downside is that you will need to install the dependencies it uses for yourself. The npm versioms are listed above.# package managerInstall-PackageCDKSPADeploy-Version1.80.0# .NET CLIdotnetaddpackageCDKSPADeploy--version1.80.0# Package reference<PackageReferenceInclude="CDKSPADeploy"Version="1.80.0"/># Paket CLIpaketaddCDKSPADeploy--version1.80.0JavaA version has now been published to maven.Note As of version 103.0 this construct now declares peer dependencies rather than bundling them so you can use it with any version of CDK higher than 103.0 without waiting on me to release a new version. The downside is that you will need to install the dependencies it uses for yourself. The npm versioms are listed above.<dependency><groupId>com.cdkpatterns</groupId><artifactId>CDKSPADeploy</artifactId><version>1.81.0</version></dependency>Advanced UsageAuto Deploy From Hosted Zone NameIf you purchased your domain through route 53 and already have a hosted zone then just use the name to deploy your site behind cloudfront. This handles the SSL cert and everything for you.# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826SPADeploy(self,"spaDeploy",encrypt_bucket=True).create_site_from_hosted_zone(zone_name="cdkpatterns.com",index_doc="index.html",website_folder="../website/dist/website")Custom Domain and SSL CertificatesYou can also pass the ARN for an SSL certification and your alias routes to cloudfront# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826importaws_cdk.coreascdkfromcdk_spa_deployimportSPADeployclassCdkStack(cdk.Stack):def__init__(self,scope,id,*,description=None,env=None,stackName=None,tags=None,synthesizer=None,terminationProtection=None,analyticsReporting=None):super().__init__(scope,id,description=description,env=env,stackName=stackName,tags=tags,synthesizer=synthesizer,terminationProtection=terminationProtection,analyticsReporting=analyticsReporting)SPADeploy(self,"cfDeploy").create_site_with_cloudfront(index_doc="../blog/dist/blog",certificate_aRN="arn:...",cf_aliases=["www.alias.com"])Encrypted S3 BucketPass in one boolean to tell SPA Deploy to encrypt your website bucket# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826SPADeploy(self,"cfDeploy",encrypt_bucket=True).create_basic_site(index_doc="index.html",website_folder="website")Custom Origin BehaviorsPass in an array of CloudFront Behaviors# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826SPADeploy(self,"cfDeploy").create_site_with_cloudfront(index_doc="index.html",website_folder="website",cf_behaviors=[{"is_default_behavior":True,"allowed_methods":cf.CloudFrontAllowedMethods.ALL,"forwarded_values":{"query_string":True,"cookies":{"forward":"all"},"headers":["*"]}},{"path_pattern":"/virtual-path","allowed_methods":cf.CloudFrontAllowedMethods.GET_HEAD,"cached_methods":cf.CloudFrontAllowedCachedMethods.GET_HEAD}])Restrict Access to Known IPsPass in a boolean and an array of IP addresses and your site is locked down!# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826SPADeploy(stack,"spaDeploy",encrypt_bucket=True,ip_filter=True,ip_list=["1.1.1.1"]).create_basic_site(index_doc="index.html",website_folder="website")Modifying S3 Bucket Created in ConstructAn object is now returned containing relevant artifacts created if you need to make any further modifications:The S3 bucket is present for all of the methodsWhen a CloudFront Web distribution is created it will be present in the return object# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826Issues / Feature Requestshttps://github.com/nideveloper/CDK-SPA-Deploy