Guide to Purchasing and Deploying EntelligenceAI on AWS Marketplace

This guide walks you through purchasing, configuring, and deploying the EntelligenceAI product on the AWS Marketplace. EntelligenceAI provides access to two container images

• entelligence-api (backend)
• entelligence-app (frontend)

Entelligence also provides a CloudFormation template that automates the setup of an ECS environment and an RDS MySQL database.

Step 1: Access AWS Marketplace and Locate EntelligenceAI

1. Log in to your AWS Management Console.

2. Go to AWS Marketplace (opens in a new tab).

3. This is the product URL: https://aws.amazon.com/marketplace/pp/prodview-wd6mzxdke72we (opens in a new tab)

4. Click on the button: View purchase options:

5. Select the duration of your contract:

6. On the same page, select how many users will be using this product:

7. Then, click on the button: Create Contract, on the right column of the page:

8. Wait for the success message and click on the button: Continue to Configuration

9. Using the most recent version available of the product you can click on Continue to Launch

10. You will be redirected to the Launch this software page:

11. You can use the images as you wish to deploy the environment on your AWS architecture, or can also use our CloudFormation Template to help you provision the self-hosted environment. The next section will guide you through the Cloud Formation Stack creation

Step 2: Launch the CloudFormation Stack

1. Log in to your AWS Management Console (opens in a new tab).

2. Navigate to the CloudFormation service by typing "CloudFormation" in the search bar or finding it in the "Services" menu.

   

3. In the CloudFormation dashboard, click Create Stack and select With new resources (standard).

4. Under Specify template, choose Upload a template file.

5. Click Choose file and select the CloudFormation template file you downloaded in Step-1

   

6. Click Next.

7. Fill Stack Name field and set the name of the environment you want to use and click Next

   

8. Check the option: I acknowledge that AWS CloudFormation might create IAM resources and click Next.

9. Check the configuration and click on Submit, it will start to create the environment:

   

Step 3: Monitor the Stack Deployment

1. Your cluster should have been created and look like this:

   

2. And the RDS database should look like this:

   

3. And the Secret for the database is also created with a random password:

   

4. Check the Load balancer if the application is available, in this case the url for the application is: http://entelligence-backend-lb-dev-451802232.us-west-2.elb.amazonaws.com/healthCheck/ (opens in a new tab)

5. Get the url from your load balancer and add the "/healthCheck" to check if the application is online

6. It should load this page
   

7. Do the same for the Frontend, get the respective URL from the load balancer and test it, in this case the URL is: http://entelligence-frontend-lb-dev-763396151.us-west-2.elb.amazonaws.com/ (opens in a new tab)
   

Step 4: Configure Security and Scaling

1. Security Groups: Review and configure any necessary security group rules to allow specific IP addresses or restrict access as needed.

2. Scaling and Monitoring: Set up ECS service auto-scaling policies based on CPU or memory usage, and configure Amazon CloudWatch for monitoring and alerting.

Additional Notes

• Certificates and Domains: The client should create the certificates and the DNS records and also the HTTPS redirect for the ECS Services. Here some useful links:
  • https://docs.aws.amazon.com/en_us/apigateway/latest/developerguide/how-to-specify-certificate-for-custom-domain-name.html (opens in a new tab)
  • https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-creating.html (opens in a new tab)
  • https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-add-or-delete-listeners.html (opens in a new tab)
• Cost Management: Monitor costs associated with the ECS services, RDS instance, and data transfer. AWS Marketplace charges and AWS infrastructure usage charges will apply.
• Database Backup and Maintenance: Regularly back up the RDS database as part of your data management strategy.
• Image Updates: When updates are available for entelligence-api and entelligence-app, you may need to update the ECS task definitions.

This deployment enables a scalable and fully managed environment for the EntelligenceAI application using AWS’s containerized infrastructure.