A Complete Guide to Migrating AWS Infrastructure to Terraform

Infrastructure as Code (IaC) tools like Terraform have become an essential part of modern DevOps practices. If you are managing an EC2 instance without Terraform and want to migrate your existing infrastructure, this guide will help you do it in a structured and smooth way.

Prerequisites

Before getting started, ensure that you have the following:

• AWS CLI configured on your local machine.

• Terraform installed.

• AWS account with permissions to manage EC2 instances.

• A running EC2 instance.

Step 1: Install Terraform

If you don’t have Terraform installed, you can install it using the following steps.

For macOS (Homebrew):

brew install terraform

For Linux: Download the Terraform binary from here and unzip it to /usr/local/bin.

For Windows: Use the chocolatey package manager:

choco install terraform

Step 2: Initialize Your Working Directory

Create a directory where you will store all your Terraform configuration files.

mkdir Day-8
cd Day-8

Step 3: Set Up AWS Provider

In your terraform-ec2 directory, create a main.tf file and specify the AWS provider. This tells Terraform where and how to access AWS.

provider "aws" {
  region = "ap-south-1"
}

Step 4: Export Your Existing EC2 Instance Configuration

In this step, you need to gather information about the existing EC2 instance, such as its ID, key pair, security group, and other settings.

1. Get EC2 Instance ID: Open the AWS Management Console and navigate to the EC2 dashboard. Find your running instance and note its Instance ID.

2. Identify the Security Group: In the EC2 console, find the security group attached to the instance. You will also need this information.

3. Get the Key Pair: If the instance was created with an SSH key pair, make sure you have access to it or know its name.

Step 5: Import Your Existing EC2 Instance into Terraform

To migrate your existing EC2 instance to Terraform, you need to import it into your Terraform configuration. The terraform import command allows Terraform to track existing resources.

terraform import aws_instance.example i-0e9cfab1f3d53f0b2

Replace i-0e9cfab1f3d53f0b2 with your instance ID.

Step 6: Write Terraform Configuration for EC2

Now that your EC2 instance is imported, you will need to create a Terraform configuration file that matches your existing EC2 configuration. For instance:

resource "aws_instance" "example" {
  ami           = "ami-12345678"   # Replace with your AMI ID
  instance_type = "t2.micro"       # Replace with your instance type

  tags = {
    Name = "Vault"
  }
}

Here, make sure that you replace the values with the details of your existing EC2 instance.

Step 7: Run Terraform Plan

Run the following command to check if Terraform detects any differences between your configuration and the actual state of the resources in AWS:

terraform plan

Terraform will show a plan that describes what changes it will make. It should show no changes if everything is correctly imported.

Step 8: Apply the Configuration

After confirming the plan, you can apply the changes with:

terraform apply

This will ensure that your EC2 instance is now fully managed by Terraform.

Step 9: Manage Other Resources

In addition to EC2 instances, you may need to manage other resources like S3 Bucket, security groups, and VPCs. To do this, you can create similar Terraform resource definitions and import them using terraform import.

For example, to import an S3 Bucket:

 terraform import aws_s3_bucket.my_example_bucket harrymodulesbucket

Then define it in your main.tf:

resource "aws_s3_bucket" "my_example_bucket" {
    bucket = "harrymodulesbucket"
}

Step 10: Automate Future Deployments

Now that your EC2 instance and other resources are managed by Terraform, you can use Terraform to automate future deployments, scaling, and modifications to your infrastructure.

Step 11: Version Control Your Infrastructure

Store your Terraform configuration files in version control (e.g., GitHub, GitLab) to keep track of changes and collaborate with your team.

---

Other tasks:

---

Conclusion

Migrating an existing EC2 instance or S3 Bucket to Terraform allows you to automate your infrastructure management and enhance the reproducibility of your setups. By following this step-by-step guide, you can import your EC2 instances and resources into Terraform and take full control of your cloud infrastructure.

---

Next Steps:

1. Explore Advanced Module Usage:

   • Delve into creating and using modules to improve code reusability, modularity, and organization for scaling infrastructure.

2. Implement Multi-Environment Configurations:

   • Set up workspaces or directories to manage different environments (e.g., dev, staging, prod), ensuring isolation and better control over resource configurations.

3. Master Terraform State Management:

   • Use remote backends for centralized state storage, enabling better collaboration, state locking, and versioning.

4. Integrate Drift Detection and Control:

   • Regularly monitor for drift between your Terraform configuration and actual infrastructure to ensure consistency.

This approach ensures that your EC2 infrastructure is now version-controlled, reproducible, and fully manageable through Terraform.