Skip to content

Commit

Permalink
Updates to ReadMe
Browse files Browse the repository at this point in the history
  • Loading branch information
ashoksrirama committed Oct 23, 2023
1 parent 2d06070 commit d8c4203
Show file tree
Hide file tree
Showing 3 changed files with 11 additions and 9 deletions.
1 change: 1 addition & 0 deletions patterns/cell-based-eks/1.cell1/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Ensure that you have the following tools installed locally:
1. [aws cli](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
2. [kubectl](https://Kubernetes.io/docs/tasks/tools/)
3. [terraform](https://learn.hashicorp.com/tutorials/terraform/install-cli)
4. [helm](https://helm.sh/docs/helm/helm_install/)

## Deploy

Expand Down
1 change: 1 addition & 0 deletions patterns/cell-based-eks/2.cell2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Ensure that you have the following tools installed locally:
1. [aws cli](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
2. [kubectl](https://Kubernetes.io/docs/tasks/tools/)
3. [terraform](https://learn.hashicorp.com/tutorials/terraform/install-cli)
4. [helm](https://helm.sh/docs/helm/helm_install/)

## Deploy

Expand Down
18 changes: 9 additions & 9 deletions patterns/cell-based-eks/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Cell-Based Architecture for Amazon EKS

This pattern how to configure a cell-based architecture for Amazon Elastic Kubernetes Service (Amazon EKS). It moves away from typical multiple Availability Zone (AZ) clusters to a single Availability Zone cluster. These single AZ clusters are called cells, and the aggregation of these cells in each Region is called a supercell. These cells help to ensure that a failure in one cell doesn't affect the cells in another, reducing data transfer costs and improving both the availability and resiliency against AZ failures for Amazon EKS workloads.
This pattern demonstrates how to configure a cell-based architecture for Amazon Elastic Kubernetes Service (Amazon EKS). It moves away from typical multiple Availability Zone (AZ) clusters to a single Availability Zone cluster. These single AZ clusters are called cells, and the aggregation of these cells in each Region is called a supercell. These cells help to ensure that a failure in one cell doesn't affect the cells in another, reducing data transfer costs and improving both the availability and resiliency against AZ wide failures for Amazon EKS workloads.

Refer to the [AWS Solution Guidance](https://aws.amazon.com/solutions/guidance/cell-based-architecture-for-amazon-eks/) for more details.

Expand All @@ -12,7 +12,7 @@ Refer to the [AWS Solution Guidance](https://aws.amazon.com/solutions/guidance/c

### [`0.vpc`](0.vpc/)

This folder creates the VPC for all clusters. In this demonstration we are creating 2 cells. The VPC creation is not part of the cluster provisionig and therefore lives in a seperate folder.
This folder creates the VPC for all clusters. In this demonstration we are creating 2 cells sharing the same VPC. So, the VPC creation is not part of the cluster provisionig and therefore lives in a seperate folder. You could also explore a VPC per cluster depending on your needs.

### [`1.cell1`](1.cell1/)

Expand All @@ -25,9 +25,9 @@ Configurations in this folder to be aware of:

### [`2.cell2`](2.cell2/)

Same configuration as in `1.cell1` except the name of the cluster which is `cell-2` and deployed in `az-2`
Same configuration as in `1.cell1` except the name of the cluster is `cell-2` and deployed in `az-2`

### [`3.test-setup`](4.test-setup/)
### [`3.test-setup`](3.test-setup/)

This folder test the installation setup. It does by scaling the sample `inflate` application replicas and watch for Karpenter to launch EKS worker nodes in respective AZs.

Expand Down Expand Up @@ -76,17 +76,17 @@ cd 3.test-setup
cd..
```

This script scale the sample application `inflate` to 25 replicas in both cells. As replica pods go into pending state due to insufficient compute capacity, Karpenter will kick-in and bring up the EC2 worker nodes in respective AZs.
This script scale the sample application `inflate` to 20 replicas in both cells. As replica pods go into pending state due to insufficient compute capacity, Karpenter will kick-in and bring up the EC2 worker nodes in respective AZs.

## Destroy

To teardown and remove the resources created in this example:

```shell
cd ../2.cell2
terraform apply -destroy -autoapprove
cd 2.cell2
terraform apply -destroy -auto-approve
cd ../1.cell1
terraform apply -destroy -autoapprove
terraform apply -destroy -auto-approve
cd ../0.vpc
terraform apply -destroy -autoapprove
terraform apply -destroy -auto-approve
```

0 comments on commit d8c4203

Please sign in to comment.