hello-kitty

hello-kitty is a static website that shows random photos of a cat from an S3 bucket. It is written in Python and can be deployed to AWS Lambda and S3.

We encourage you to use StackGen to generate IaC for this sample app. StackGen provides a powerful and flexible way to define and manage your infrastructure.

Get started with IaC generation for this repo by following the instructions on StackGen Documentation

Environment variables

• IMAGES_BUCKET: S3 bucket name where images are stored

Other Sample Projects to try

• retroboard - python app that can be deployed to AWS Lambda, DynamoDB, SQS, S3, SNS

Example Github Actions Workflows

This demo repo includes a few examples of Github Actions Workflows that you can use to deploy your app. Fork this repo and follow below instructions to deploy your own copy.

Note

You'll need to add AWS_ROLE_TO_ASSUME as a secret in your repository settings to use below workflows.

• infra-pr.yml - This workflow is triggered when any changes are detected in the infra/terraform directory. It comments with Terraform plan output on the PR.
• infra-apply.yml - This workflow is triggered when a PR is merged to main. It applies the changes to AWS.

Important

You'll need to add APPSTACK_ID as a variable in your repository settings to use below workflows.

• manual-pull.yml - This workflow is triggered when you click the Run workflow button. It uses the appcd-dev/download-action to download the IaC for the appstack and creates a PR with the changes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Photo credits

Attribution for photos in images/ is in text files in the same directory.