Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/memo1918/aws-terraform-ha-infra
AWS high availability and scalable infrastructure made with IaC Terraform.
https://github.com/memo1918/aws-terraform-ha-infra
autoscaling aws awsfreetier cloud cloudarchitectechture highavailability iac infrastructure-as-code scalability terraform terraform-aws terraform-project
Last synced: 22 days ago
JSON representation
AWS high availability and scalable infrastructure made with IaC Terraform.
- Host: GitHub
- URL: https://github.com/memo1918/aws-terraform-ha-infra
- Owner: memo1918
- License: mit
- Created: 2024-12-02T12:15:22.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-12-04T11:00:42.000Z (30 days ago)
- Last Synced: 2024-12-12T11:07:29.922Z (22 days ago)
- Topics: autoscaling, aws, awsfreetier, cloud, cloudarchitectechture, highavailability, iac, infrastructure-as-code, scalability, terraform, terraform-aws, terraform-project
- Language: HCL
- Homepage:
- Size: 35.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 AWS-Terraform-HA-infra
Deploy a Scalable and Highly Available Architecture on AWS with Terraform
## 🌟 Project Overview
The purpose of this project is to contribute to the community by making highly available and scalable infrastructure code available for everyone to use and learn from. Components used in this architecture are included in the AWS free tier.
## 🏗️ Architecture Highlights
### Multi-AZ Deployment
With multiple Availability Zones, we can improve fault tolerance by distributing instances across zones. If one AZ experiences problems, the other AZ maintains service continuity.
### Auto Scaling Group (ASG)
ASG helps us to scale instances up to meet traffic demands or down when not in use, resulting in lower costs and better performance management.
### Application Load Balancer (ELB)
The Application Load Balancer equaliy distributes the incoming traffic to healthy instances. This distribution can be across multiple AZs, contributing to high availability.
## 🛠️ Techincal Details
* **VPC:** Dividing the network into private and public subnets.
* **EC2:** Instances: Virtual machines that runs the desaired application.
* **EFS:** Storage: Commong storage for EC2s to access.
* **ALB:** Application Load Balancer for distributing the load
* **NAT Instances:** They are bridges between private subnets to the internet.
* **Security Groups:** Helps us to manage, restrict and secure our networks.
### File structure and modules
```
├── modules
│ ├── autoScaling.tf
│ ├── ec2Template.tf
│ ├── efs.tf
│ ├── IAMroles.tf
│ ├── NATinstances.tf
│ ├── routing.tf
│ ├── secGroup.tf
│ ├── vpc.tf
│ └── variables.tf
├── initSetup.tfpl
└── main.tf
```
**main.tf:**
This is the main entry point for the Terraform configuration.
- Specifies the required providers and their versions.
- Defines the AWS provider configuration.
- Includes the `allmodules` module, which sources all other modules.
**variables.tf:**
Defines input variables for the Terraform configuration.
- Variables for AMI ID, instance type, VPC ID, subnet IDs, etc.
**vpc.tf:**
Manages the VPC and related networking components.
- VPC, subnets, internet gateway, route tables, and route table associations.
**secGroup.tf:**
Manages security groups for the infrastructure.
- Security groups for the production environment and load balancer.
**ec2Template.tf:**
Defines the EC2 launch template for the Auto Scaling group.
- Launch template with instance configuration, block device mappings, and user data.
**autoScaling.tf:**
Manages the Auto Scaling group and related policies.
- Auto Scaling group, scaling policies, and CloudWatch alarms.
**loadBalancer.tf:**
Manages the load balancer and related components.
- Application load balancer, target groups, and listeners.
**efs.tf:**
Manages the Elastic File System (EFS) and related components.
- EFS file system and mount targets.
**IAMroles.tf:**
Manages IAM roles and instance profiles.
- IAM roles, policies, and instance profiles for EC2 instances.
**NATinstances.tf:**
Manages NAT instances for the VPC.
- NAT instances and related security groups.
**routing.tf:**
Manages routing configurations for the VPC.
- Route tables and route table associations.
**initSetup.tftpl:**
Template file for EC2 instance user data.
- Shell script to initialize the EC2 instance, including Docker installation and EFS mounting.
# ⚙️ Getting Started
## Prerequisites
### AWS Account
To be able to deploy your infrastructure to the AWS, [here](aws.amazon.com/resources/create-account/) you can find all the information to setup an account. I would also recommend that you visit the [AWS Free Tier](https://aws.amazon.com/free/) page to learn more about limits and how to avoid unexpected bills (setting a budget and regularly checking AWS Bills and Cost Management).
### AWS CLI
AWS CLI is a command line interface to control you AWS services. You can find offical documentation [here](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) or simply to just install follow here:
This installation guid is for Linux. If you have another operating system, please refer to the link above.
```Bash
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
```
We download the AWS CLI installation file
```Bash
unzip -u awscliv2.zip
```
We extract the contents of the zip file (you can use any unzipping tool).
```Bash
sudo ./aws/install
```
And here we install the AWS CLI to our system.
Now to cconfirm it we can run:
```bash
aws --version
```
### Terraform
Official guide can be found [on this site](https://developer.hashicorp.com/terraform/install#linux).
If you have a Debian based linux, you can also folow here:
```bash
wget -O - https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
```
```bash
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
```
```bash
sudo apt update && sudo apt install terraform
```
To verify it
```bash
terraform --version
```
Finally we need to input our AWS credentials to Terraform. There are many ways to do this, but for simplicity here I will show doing it with environment variables:
```bash
export AWS_ACCESS_KEY_ID="my-access-key"
export AWS_SECRET_ACCESS_KEY="my-secret-key"
export AWS_REGION="us-west-2"
```
Please change the fields accordint to your credentials. You can find more information about how to generate access key on [here](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html).
## Deployment
Clone the repository
```bash
git clone https://github.com/memo1918/AWS-Terraform-HA-infra.git
cd AWS-Terraform-HA-infra
```
You can do the neccessary changes to the initSetup.tftpl file or to the variables.tf unde modules directory.
After changes, initiate the terraform
```bash
terraform init
```
Before applying, you can validate and plan the project.
```bash
terraform validate
terraform plan
```
If everyhing looks good, we are ready to deploy:
```bash
terraform apply
```