virtual-waiting-room-on-aws

KO | EN

gitlite — search

#python #hacktoberfest #llm #golang #android #machine-learning #rust #deep-learning #nodejs #windows #kubernetes #awesome-list #security #openai

virtual-waiting-room-on-aws

(★ 119)

Virtual Waiting Room on AWS solution helps absorb and control incoming user requests to your website during an unusually large burst of traffic, usually due to a large-scale event.

virtual-waiting-room-on-aws Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

⚠️🚨⚠️ Virtual Waiting Room on AWS has been deprecated and will not be receiving any additional features or updates. We encourage customers to explore enterprise-supported alternatives in [AWS Marketplace](https://aws.amazon.com/marketplace/) (additional fees may apply), or implement their own solution using guidance from our [Visitor Prioritization on e-Commerce Websites with CloudFront and CloudFront Functions](https://aws.amazon.com/blogs/networking-and-content-delivery/visitor-prioritization-on-e-commerce-websites-with-cloudfront-and-cloudfront-functions/) blog post. ⚠️🚨⚠️

**[🚀 Solution Landing Page](https://aws.amazon.com/solutions/implementations/virtual-waiting-room-on-aws/)** | **[📜 Solution Implementation Guide](https://docs.aws.amazon.com/solutions/latest/virtual-waiting-room-on-aws/welcome.html)** | **[🚧 Feature request](https://github.com/aws-solutions/virtual-waiting-room-on-aws/issues/new?assignees=&labels=feature-request%2C+enhancement&template=feature_request.md&title=)** | **[🐛 Bug Report](https://github.com/aws-solutions/virtual-waiting-room-on-aws/issues/new?assignees=&labels=bug%2C+triage&template=bug_report.md&title=)**

Note: If you want to use the solution without building from source, navigate to Solution Landing Page

# Virtual Waiting Room on AWS
Site wrapper to absorb and control user traffic flowing into smaller web sites.

<a name="prerequisites-for-customization"></a>
## Prerequisites for Customization
[//]: # (Add any prerequisites for customization steps. e.g. Prerequisite: Node.js>10)

* Install/update to Python 3.x
* Install/update to Poetry 2.0.1
* Install the AWS Command Line Interface (CLI)
* Create a Python [virtual environment](https://docs.python.org/3.8/library/venv.html) using [requirements.txt](deployment/requirements.txt) and activate it
* Configure the bucket name of your target Amazon S3 distribution bucket

## Building distributable for customization
* Configure the bucket name of your target Amazon S3 distribution bucket
```
export DIST_OUTPUT_BUCKET=<MY-BUCKET-NAME> # bucket where customized code will reside
export SOLUTION_NAME=my-solution-name
export VERSION=my-version # version number for the customized code
```
_Note:_ You would have to create an S3 bucket with the prefix '<MY-BUCKET-NAME>-<AWS-REGION>'; <AWS-REGION> is where you are testing the customized solution. **Also, the assets in bucket should be publicly accessible.**

* Now build the distributable:
```
cd deployment
poetry install
chmod +x ./build-s3-dist.sh 
poetry run ./build-s3-dist.sh $DIST_OUTPUT_BUCKET $SOLUTION_NAME $VERSION 
```

* Deploy the distributable to an Amazon S3 bucket in your account. The head-bucket command verifies that your account owns the bucket. _Note:_ you must have the AWS Command Line Interface installed.
```
aws s3api head-bucket --bucket <MY-BUCKET-NAME>-<AWS-REGION> --expected-bucket-owner <AWS-ACCOUNT-ID>
aws s3 sync regional-s3-assets/ s3://<MY-BUCKET-NAME>-<AWS-REGION>/$SOLUTION_NAME/$VERSION/  
```

* Get the link of the solution template uploaded to your Amazon S3 bucket.
* Deploy the solution to your account by launching a new AWS CloudFormation stack using the link of the solution template in Amazon S3.

## Running unit tests for customization
* Some packages require a build before unit tests will run
* Install the common package into the virtual envronment before running
```
cd ./deployment
chmod +x ./run-unit-tests.sh 
./run-unit-tests.sh 
```

***

## File Structure

```
├── deployment
│   ├── Dockerfile [ Used by docker_build script for building jwcrypto library ]
│   ├── virtual-waiting-room-on-aws-api-gateway-cw-logs-role.json   [ Base template for CloudWatch Logs role ] 
│   ├── virtual-waiting-room-on-aws-authorizers.json [ Base template for authorizers ]
│   ├── virtual-waiting-room-on-aws-getting-started.json [ Nested template for new users ]
│   ├── virtual-waiting-room-on-aws-openid.json    [ Base template for Open ID ]
│   ├── virtual-waiting-room-on-aws-sample-inlet-strategy.json   [ Base template for sample inlet strategy]
│   ├── virtual-waiting-room-on-aws-sample.json    [ Base template for sample site ]
│   ├── virtual-waiting-room-on-aws-swagger-private-api.json   [ Swagger file for private API ]
│   ├── virtual-waiting-room-on-aws-swagger-public-api.json    [ Swagger file for public API ]
│   ├── virtual-waiting-room-on-aws.json   [ Base template for core API ]
│   ├── build-s3-dist.sh    [ Script for building distributables and preparing the CloudFormation templates ]
│   ├── deploy.sh   [ Script for building distributables and preparing the CloudFormation templates ]
│   ├── docker_build.sh   [ Script for building jwcrypto library ]
│   ├── global-s3-assets  [ Directory for writing out CloudFormation during local build ]
│   ├── regional-s3-assets     [ Directory for writing out CloudFormation during local build ]
│   ├── requirements.txt    [ System requirements for local builds ]
│   └── run-unit-tests.sh   [ Script to run unit tests ]
├── docs
│   ├── developer-guide.md    [ Waiting room developer guide ]
│   ├── install-guide.md      [ Waiting room installation guide ]
│   ├── physical-view.drawio
│   ├── physical-view.jpg
│   ├── sequence-diagrams.drawio
│   └── software-architecture.md
└── source
    ├── control-panel    [ Source files for sample control panel ]
    ├── core-api    [ Source files for core API ]
    ├── core-api-authorizers-sample   [ Source files Authorizers ]
    ├── openid-waitingroom    [ Source files for Open ID ]
    ├── sample-inlet-strategies   [ Source files for inlet strategies ]
    ├── sample-waiting-room-site   [ Source files for sample waiting room ]
    ├── shared    [ Source files for shared library ]
    ├── token-authorizer    [ Source files for token authorizer ]
    └── tools   [ Source files for tools and helper scripts ]
```

***

## Collection of operational metrics

This solution collects anonymized operational metrics to help AWS improve the
quality of features of the solution. For more information, including how to disable
this capability, please see the [implementation guide](https://docs.aws.amazon.com/solutions/latest/virtual-waiting-room-on-aws/collection-of-operational-metrics.html).

## External Contributors

[@kght6123](https://github.com/kght6123) for [#232](https://github.com/aws-solutions/virtual-waiting-room-on-aws/pull/232)

virtual-waiting-room-on-aws

virtual-waiting-room-on-aws Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

virtual-waiting-room-on-aws

virtual-waiting-room-on-aws Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README