AWS solutions documentation change
Summary
Expanded deployment instructions with multiple CDK stack options, deployment methods (deploy.sh script vs manual CDK), and new RTB Fabric/VPC peering configurations
Security assessment
Changes focus on deployment process improvements and optional networking features (RTB Fabric). While RTB Fabric uses private networks, this is presented as latency/cost optimization rather than security hardening. No vulnerabilities or security incidents are referenced.
Diff
diff --git a/solutions/latest/prebid-server-deployment-on-aws/deploy-the-solution.md b/solutions/latest/prebid-server-deployment-on-aws/deploy-the-solution.md index 6e7dbe6d2..0af43140b 100644 --- a//solutions/latest/prebid-server-deployment-on-aws/deploy-the-solution.md +++ b//solutions/latest/prebid-server-deployment-on-aws/deploy-the-solution.md @@ -27 +27,109 @@ Before you launch the solution, review the [cost](./cost1.html), [architecture]( -Follow the steps in the section "Deployment" in the [Git repo readme](https://github.com/aws-solutions-library-samples/prebid-server-deployment-on-aws). The default configuration deploys the core and supporting services found in the [AWS services in this solution](./architecture-details.html#aws-services-in-this-solution) section, but you can customize the CDK stack to meet your specific needs. +The solution consists of two CDK stacks: + + 1. **Main Prebid Server Stack** : The core infrastructure for running Prebid Server (always deployed) + + 2. **Bidder Simulator Stack** : An optional stack for quick start testing and validation + + + + +### Deployment methods + +**Quick Deploy with deploy.sh (Recommended)** + +For a streamlined deployment experience on Linux/macOS, use the provided `deploy.sh` script: + + + # Deploy with analytics (most common use case) + ./deploy.sh --enable-log-analytics --profile <your-aws-cli-profile> --region <your-region> + + # Deploy with bidder simulator + ./deploy.sh --deploy-bidding-simulator --profile <your-aws-cli-profile> --region <your-region> + + # Deploy with bidder simulator and RTB Fabric + ./deploy.sh --deploy-bidding-simulator --include-rtb-fabric --profile <your-aws-cli-profile> --region <your-region> + + # Deploy with all features enabled + ./deploy.sh --deploy-bidding-simulator --include-rtb-fabric --enable-log-analytics --profile <your-aws-cli-profile> --region <your-region> + +The `deploy.sh` script automatically: + + * Copies AMT bidder files to the Docker build context when `--deploy-bidding-simulator` is used + + * Sets up the Python virtual environment + + * Installs dependencies + + * Runs CDK with the appropriate context flags + + + + +**Manual Deployment with AWS CDK** + +For customization or manual deployment: + + + cd source/infrastructure + + # Bootstrap CDK (required once) + cdk bootstrap --cloudformation-execution-policies arn:aws:iam::aws:policy/AdministratorAccess + + # Deploy with bidder simulator + cdk deploy --all --context deployBiddingSimulator=true --profile <your-aws-cli-profile> --region <your-region> + + # Deploy with bidder simulator and RTB Fabric + cdk deploy --all --context deployBiddingSimulator=true --context includeRtbFabric=true --profile <your-aws-cli-profile> --region <your-region> + + # Deploy with analytics enabled + cdk deploy --all --context enableLogAnalytics=true --profile <your-aws-cli-profile> --region <your-region> + + # Deploy without optional components + cdk deploy --all --profile <your-aws-cli-profile> --region <your-region> + +For detailed deployment instructions and prerequisites, see the "Deployment Steps" section in the [Git repo readme](https://github.com/aws-solutions-library-samples/prebid-server-deployment-on-aws). + +### Deployment options + +**Bidder Simulator (`--deploy-bidding-simulator`)** + +Deploys an optional bidder simulator stack for quick start testing. The simulator includes: + + * internal ALB + Lambda and VPC peering + + * Support for banner and video ad formats (including VAST instream video) + + * Demo website with Prebid.js integration + + * Automatic AMT adapter configuration + + + + +**RTB Fabric (`--include-rtb-fabric`)** + +Enables AWS RTB Fabric integration for low-latency, cost-optimized private network connectivity. Requirements: + + * Must be used with `--deploy-bidding-simulator` + + * RTB Fabric must be available in your deployment region + + + + +When enabled, the solution creates: + + * Requester Gateway in the Prebid Server VPC + + * Responder Gateway in the Bidder Simulator VPC + + * Fabric Link connecting the two gateways + + * Lambda function for automatic link acceptance + + + + +**Analytics Adapter (`--enable-log-analytics`)** + +Enables the custom analytics adapter for detailed auction-level data collection. This provides comprehensive business intelligence data through the ETL pipeline. @@ -31 +139 @@ You can view the status of the stack in the AWS CloudFormation console in the ** -**Time to deploy:** Approximately 10 minutes +**Time to deploy:** Approximately 10-15 minutes (varies based on optional components)