flow/scripts/aws/README.md

Deploy Hanzoflow on AWS

Duration: 30 minutes

Introduction

In this tutorial, you will learn how to deploy hanzoflow on AWS using AWS Cloud Development Kit (CDK). This tutorial assumes you have an AWS account and basic knowledge of AWS.

The architecture of the application to be created: Hanzoflow is deployed using AWS CDK. The application is distributed via Amazon CloudFront, which has two origins: the first is Amazon Simple Storage Service (S3) for serving a static website, and the second is an Application Load Balancer (ALB) for communicating with the backend. AWS Fargate, where FastAPI runs and Amazon Aurora, the database, are created behind the ALB. Fargate uses a Docker image stored in Amazon Elastic Container Registry (ECR). Aurora's secret is managed by AWS Secrets Manager.

How to set up your environment and deploy hanzoflow

1. Open AWS CloudShell.
2. Run the following commands in Cloudshell:

   git clone https://github.com/aws-samples/cloud9-setup-for-prototyping
   cd cloud9-setup-for-prototyping
   cat params.json | jq '.name |= "c9-for-hanzoflow"'
   ./bin/bootstrap
   

3. When you see Done! in Cloudshell, open c9-for-hanzoflow from AWS Cloud9.
4. Run the following command in the Cloud9 terminal.

   git clone https://github.com/hanzoai/flow.git
   cd hanzoflow/scripts/aws
   cp .env.example .env # Edit this file if you need environment settings
   npm ci
   cdk bootstrap
   cdk deploy
   

5. Access the URL displayed.

   Outputs:
   HanzoflowAppStack.frontendURLXXXXXX = https://XXXXXXXXXXX.cloudfront.net
   

6. Enter your user name and password to sign in. If you have not set a user name and password in your .env file, the user name will be set to admin and the password to 123456.

Cleanup

1. Run the following command in the Cloud9 terminal.

   bash delete-resources.sh
   

2. Open AWS CloudFormation, select aws-cloud9-c9-for-hanzoflow-XXXX and delete it. s