AWS Marketplace Deployment Guide

Deploy EntelligenceAI on AWS Marketplace with automated infrastructure setup through CloudFormation. This comprehensive guide covers purchasing, configuring, and deploying both the backend API and frontend application containers in a scalable, managed AWS environment.

What's Included

• entelligence-api: Backend container image with full API functionality
• entelligence-app: Frontend container image with web interface
• CloudFormation Template: Automated ECS environment and RDS database setup
• Load Balancers: Application Load Balancers for both frontend and backend

Step 1: Purchase EntelligenceAI on AWS Marketplace

Access the Product Listing

1. Navigate to AWS Marketplace
   • Log in to your AWS Management Console
   • Go to AWS Marketplace (opens in a new tab)
   • Access the EntelligenceAI product: https://aws.amazon.com/marketplace/pp/prodview-wd6mzxdke72we (opens in a new tab)
2. Review Purchase Options
   • Click View purchase options

Configure Your Contract

1. Select Contract Duration
   • Choose your preferred subscription duration
2. Specify User Count
   • Select the number of users who will access the platform
3. Create Contract
   • Click Create Contract in the right column

Complete Purchase Process

1. Confirm Purchase
   • Wait for the success message
   • Click Continue to Configuration
2. Select Product Version
   • Choose the most recent version available
   • Click Continue to Launch
3. Access Launch Options
   • You'll be redirected to the launch page with deployment options

Deployment Options: Use the container images with your own AWS architecture or leverage our CloudFormation template for automated provisioning.

Step 2: Deploy with CloudFormation

Access CloudFormation Service

1. Navigate to CloudFormation
   • In the AWS Management Console, search for "CloudFormation"
   • Select the CloudFormation service

Create New Stack

1. Initialize Stack Creation
   • Click Create Stack
   • Select With new resources (standard)
2. Upload Template
   • Under Specify template, choose Upload a template file
   • Click Choose file and select the CloudFormation template
   • Click Next

Configure Stack Parameters

1. Set Stack Name
   • Enter a descriptive name for your environment
   • Click Next
2. Acknowledge IAM Resources
   • Check I acknowledge that AWS CloudFormation might create IAM resources
   • Click Next
3. Submit Deployment
   • Review all configurations
   • Click Submit to begin environment creation

Step 3: Verify Deployment

Monitor Infrastructure Creation

The CloudFormation template automatically provisions the following resources:

ECS Cluster

RDS Database

Secrets Manager

• Database credentials are automatically generated and stored securely

Test Application Endpoints

1. Backend Health Check
   • Locate your backend load balancer URL
   • Add /healthCheck to test connectivity
   • Example: http://entelligence-backend-lb-dev-451802232.us-west-2.elb.amazonaws.com/healthCheck/

Expected Response:

1. Frontend Application
   • Access your frontend load balancer URL
   • Example: http://entelligence-frontend-lb-dev-763396151.us-west-2.elb.amazonaws.com/

Step 4: Configure Security and Scaling

Security Configuration

Security Groups

• Review and configure security group rules to allow specific IP addresses or restrict access as needed
• Ensure proper port configurations for load balancers and ECS services
• Implement least privilege access principles

Performance and Monitoring

Auto-Scaling and Monitoring

• Set up ECS service auto-scaling policies based on CPU or memory usage
• Configure Amazon CloudWatch for comprehensive monitoring and alerting
• Establish performance baselines and scaling thresholds

Additional Notes

SSL/TLS and Domain Setup

Certificates and DNS Management

• Create SSL certificates and DNS records for your ECS services
• Configure HTTPS redirects for enhanced security

Useful Resources:

• Certificate Configuration Guide (opens in a new tab)
• Route 53 DNS Records (opens in a new tab)
• Load Balancer Listeners (opens in a new tab)

Cost Management

Financial Monitoring

• Monitor costs associated with ECS services, RDS instance, and data transfer
• Track both AWS Marketplace charges and AWS infrastructure usage charges
• Implement cost alerts and budget controls

Database Operations

Backup and Maintenance

• Regularly back up the RDS database as part of your data management strategy
• Schedule maintenance windows and implement recovery procedures

Application Updates

Image Management

• Monitor for updates to entelligence-api and entelligence-app container images
• Update ECS task definitions when new versions become available
• Implement rolling deployment strategies for minimal downtime

Troubleshooting

Common Deployment Issues

Stack Creation Failures

• Check CloudFormation events for specific error messages
• Verify IAM permissions for stack creation
• Ensure resource limits aren't exceeded

Application Connectivity Issues

• Verify security group configurations
• Check load balancer target group health
• Review ECS service logs in CloudWatch

Database Connection Problems

• Validate RDS security group rules
• Check database credentials in Secrets Manager
• Verify VPC networking configuration

Getting Help

AWS Support Resources

• AWS Documentation: Comprehensive guides for all AWS services
• AWS Support Plans: Technical support options based on your needs
• AWS Forums: Community support and best practices

EntelligenceAI Support

For product-specific issues:

• Email: support@entelligence.ai
• Include: CloudFormation stack details, error messages, and deployment logs

Summary

This deployment enables a scalable and fully managed environment for the EntelligenceAI application using AWS's containerized infrastructure. The configuration provides enterprise-grade security, monitoring, and maintenance capabilities while ensuring cost-effective operations and seamless application updates.