This workshop delves into the realm of cell-based architecture, an approach that has gained traction in recent years for its ability to enhance the scalability, reliability, and efficiency of SaaS architectures. By deploying the SaaS application into smaller, independent cells, workshop participants will learn how to solve challenges like reducing contention between tenants, supporting a tiering strategy, reducing blast radius, and increasing the overall resilience of their systems. The workshop will provide a hands-on experience, allowing learners to go under the hood of a working SaaS application, and explore various aspects of a cell-based architecture, including provisioning, configuration, observability, routing, and sharding of cells.
The AWS workshop can be found at the following location:
Building resilient and scalable SaaS applications with a cell-based architecture
Whilst intended to be used primarily for the workshop, the code can be used independently to explore and interact with the various components of a cell-based architecture:
- To deploy the solution, use the included deployment script to package and deploy:
sh ./scripts/deploy.sh
- Run the below script to create a new cell. Here 'freetier' is the name of cell, 'S' is cellSize (allowed values are S,M,L) and '1' is the WaveNumber for the cell deployment.
sh ./scripts/test_createcell.sh freetier S 1
- Run the below script to create a new tenant within the cell. Here 'o2345v9' is the cell id (from previous step), 'tenant1' is tenant name and '[email protected]' is the email for the tenant admin, that is provisioned in Cognito as part of this and 'free' denotes tenant tiers.
sh ./scripts/test_createtenant.sh o2345v9 tenant1 [email protected] free
- Run the below script to activate the tenant. Here 'o2345v9' is the cell id (from create cell step), 'mhmuy9t2p' is tenant id (from create tenant step).
sh ./scripts/test_activatetenant.sh o2345v9 mhmuy9t2p
- Run the below script to add and get products for the tenant. Pass the cell id and tenant id. The below will script will use the cell router to route to the correct cell endpoint.
sh ./scripts/test_product.sh o2345v9 mhmuy9t2p
- If you make any changes to the docker image then run below command to re-upload the app plane source. This will trigger the deployment pipeline.
sh ./scripts/package-app-plane.sh
See CONTRIBUTING for more information.
This library is licensed under the MIT-0 License. See the LICENSE file.
