This 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.
Project description
# CDK-SPA-Deploy
[![npm](https://img.shields.io/npm/dt/cdk-spa-deploy)](https://www.npmjs.com/package/cdk-spa-deploy) [![Vulnerabilities](https://img.shields.io/snyk/vulnerabilities/npm/cdk-spa-deploy)](https://www.npmjs.com/package/cdk-spa-deploy)
This 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 Usage
### Typescript
npm install –save cdk-spa-deploy
![cdk-spa-deploy example](https://raw.githubusercontent.com/nideveloper/cdk-spa-deploy/master/img/spadeploy.png)
### Python
pip install cdk-spa-deploy
![cdk-spa-deploy python example](https://raw.githubusercontent.com/nideveloper/cdk-spa-deploy/master/img/python.png)
## Advanced Usage
### Auto Deploy From Hosted Zone Name
If 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.
![cdk-spa-deploy alias](https://raw.githubusercontent.com/nideveloper/cdk-spa-deploy/master/img/fromHostedZone.PNG)
### Custom Domain and SSL Certificates
You can also pass the ARN for an SSL certification and your alias routes to cloudfront
![cdk-spa-deploy alias](https://raw.githubusercontent.com/nideveloper/cdk-spa-deploy/master/img/cdkdeploy-alias.png)
### Encrypted S3 Bucket
Pass in one boolean to tell SPA Deploy to encrypt your website bucket
![cdk-spa-deploy encryption](https://raw.githubusercontent.com/nideveloper/cdk-spa-deploy/master/img/encryption.PNG)
### Restrict Access to Known IPs
Pass in a boolean and an array of IP addresses and your site is locked down!
![cdk-spa-deploy ipfilter](https://raw.githubusercontent.com/nideveloper/cdk-spa-deploy/master/img/ipfilter.png)
### Modifying S3 Bucket Created in Construct
An 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 methods
When a CloudFront Web distribution is created it will be present in the return object
`python # Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 `
## Issues / Feature Requests
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
Hashes for cdk_spa_deploy-1.56.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3518d3aa8be1fa759487209fff3eb6ddffb29ed4011af740fee3c3535f19d422 |
|
MD5 | 9706eabf2eb469d5dbcfee5abcdade3c |
|
BLAKE2b-256 | e92841d8a7c3c0d973c7285dfbb2bb4a085ae81526aa02c979a45125e66e742d |