zeekay
930ffbc5c5
Per global rule: /v1/ only, never /api/. Internal API calls + handler comments + route registrations updated. External vendor APIs (OpenRouter, LangWatch, etc.) left as-is. - Backend: APIRouter prefix dropped from "/api" — router_v1 (prefix=/v1) and router_v2 (prefix=/v2) now mount at the root, subdomain (api.*) already namespaces. - API_V1_STR: "/api/v1" → "/v1" - Frontend constants: BASE_URL_API "/api/v1/" → "/v1/" and BASE_URL_API_V2 "/api/v2/" → "/v2/"; vite proxy + Traefik routing labels updated. - Source files (mcp_utils, mcp_projects, mcp, folders, vertex_types, load/utils, mcp_sse, schema/workflow): all internal URL builders. - Tests + e2e specs + API-code-generator templates + AWS CDK behaviors updated to match.
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
- Open AWS CloudShell.
- 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 - When you see
Done!in Cloudshell, openc9-for-hanzoflowfrom AWS Cloud9.
- 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 - Access the URL displayed.
Outputs: HanzoflowAppStack.frontendURLXXXXXX = https://XXXXXXXXXXX.cloudfront.net - Enter your user name and password to sign in. If you have not set a user name and password in your
.envfile, the user name will be set toadminand the password to123456.
Cleanup
- Run the following command in the Cloud9 terminal.
bash delete-resources.sh - Open AWS CloudFormation, select
aws-cloud9-c9-for-hanzoflow-XXXXand delete it.
s
