This CDK is an example of how you can deploy a Streamlit application in AWS. It uses ECS Fargate for running the application.

Below is a diagram of the archicture used, at a high level:

CDK will build the image that will be used by Amazon ECS. You will need Docker to be installed on the machine building the CDK.

To associate the Amazon Cognito user pool to a domain, we create a custom domain in a Route 53 zone. You will need a Zone ID and a Domain Name to deploy this construct.

Make sure to setup the venv for the CDK, see the instructions in the CDK README.

python3 -m venv ./cdk/.venv
source ./cdk/.venv/bin/activate
pip install -r cdk/requirements.txt

yarn install
yarn deploy \
    -c zone_id="<Route53 Zone Id>" \
    -c zone_name="<Route53 Domain Name (IE: samples.aws.com)>" \
    -c hostname="<Route53 Hostname for Application (IE: streamlit)>"

You can specify a custom AWS Cognito authentication domain prefix:

yarn install
yarn deploy \
    -c zone_id="<Route53 Zone Id>" \
    -c zone_name="<Route53 Domain Name (IE: samples.aws.com)>" \
    -c hostname="<Route53 Hostname for Application (IE: streamlit)>" \
    -c cognito_domain="<Cognito Domain Prefix (Default: streamlit-auth-[Account ID])>"

See CONTRIBUTING for more information.

This library is licensed under the MIT-0 License. See the LICENSE file.