Terraform AWS Deployment Rehberi: Infrastructure as Code 2025 (Başlangıç)

Infrastructure as Code (IaC) Örneği

Manuel Yöntem (❌ Eski Yol):

1. AWS Console'a giriş yap
2. EC2 bölümüne git
3. Launch Instance'a tıkla
4. AMI seç, instance type seç, security group ayarla...
5. 10-15 tıklama sonrası instance hazır

Terraform ile (✅ Modern Yol):

# main.tf dosyası
resource "aws_instance" "web" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"

  tags = {
    Name = "AlestaWeb-Server"
  }
}

# Komut
$ terraform apply

Hepsi bu kadar! 3 satır kod, 1 komut (3 lines of code, 1 command).

1. Terraform Kurulumu (Install Terraform)

Windows:

# Chocolatey ile (with Chocolatey)
choco install terraform

# Veya manuel: terraform.io'dan binary indir
# PATH'e ekle (add to PATH)

macOS:

# Homebrew ile
brew tap hashicorp/tap
brew install hashicorp/tap/terraform

Linux (Ubuntu/Debian):

wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [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
sudo apt update && sudo apt install terraform

Kurulum Kontrolü (Verify Installation):

terraform --version
# Output: Terraform v1.10.x

2. AWS CLI Kurulumu (Install AWS CLI)

Windows/macOS/Linux:

# AWS CLI v2 kurulumu (install AWS CLI v2)
# https://aws.amazon.com/cli/ adresinden indirin

# Kurulum kontrolü
aws --version
# Output: aws-cli/2.x.x

Adım 1: AWS IAM Kullanıcısı Oluştur (Create IAM User)

1. AWS Console → IAM → Users → Create User
2. Kullanıcı adı: terraform-user
3. Permissions: AdministratorAccess (veya daha kısıtlı policy / or more restricted policy)
4. Access Key oluştur (Create Access Key) → CSV indir (download CSV)

CSV'de Access Key ID ve Secret Access Key olacak.

Adım 2: AWS CLI ile Yapılandır (Configure with AWS CLI)

aws configure

# Girdiler (inputs):
AWS Access Key ID: [ACCESS_KEY_ID buraya]
AWS Secret Access Key: [SECRET_ACCESS_KEY buraya]
Default region name: us-east-1   (veya eu-west-1 vb.)
Default output format: json

Bu bilgiler ~/.aws/credentials dosyasına kaydedilir (saved to ~/.aws/credentials).

Adım 1: Proje Dizini Oluştur (Create Project Directory)

mkdir terraform-aws-demo
cd terraform-aws-demo

Adım 2: main.tf Dosyası Oluştur (Create main.tf)

# main.tf

# AWS Provider Tanımı (AWS Provider Definition)
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
  required_version = ">= 1.2.0"
}

provider "aws" {
  region = "us-east-1"  # Bölge (Region)
}

# EC2 Instance Kaynağı (EC2 Instance Resource)
resource "aws_instance" "alesta_web_server" {
  ami           = "ami-0c55b159cbfafe1f0"  # Amazon Linux 2 AMI
  instance_type = "t2.micro"               # Free tier eligible

  tags = {
    Name        = "AlestaWeb-Demo-Server"
    Environment = "Development"
    ManagedBy   = "Terraform"
  }
}

# Output: Instance'ın public IP'sini göster (Show public IP)
output "instance_public_ip" {
  description = "EC2 instance'ın public IP adresi"
  value       = aws_instance.alesta_web_server.public_ip
}

1. terraform init - Projeyi Başlat (Initialize Project)

terraform init

Ne yapar (What it does):

• AWS provider'ı indirir (downloads AWS provider)
• .terraform dizini oluşturur
• Backend'i yapılandırır (configures backend)

Output:

Initializing provider plugins...
- Finding hashicorp/aws versions matching "~> 5.0"...
- Installing hashicorp/aws v5.x.x...
Terraform has been successfully initialized!

2. terraform plan - Değişiklikleri Önizle (Preview Changes)

terraform plan

Ne yapar:

• Mevcut altyapı ile kodu karşılaştırır (compares current infrastructure with code)
• Oluşturulacak/değiştirilecek/silinecek kaynakları gösterir
• Hiçbir şey oluşturmaz! (creates nothing - just preview)

Output örneği:

Terraform will perform the following actions:

  # aws_instance.alesta_web_server will be created
  + resource "aws_instance" "alesta_web_server" {
      + ami           = "ami-0c55b159cbfafe1f0"
      + instance_type = "t2.micro"
      ...
    }

Plan: 1 to add, 0 to change, 0 to destroy.

3. terraform apply - Altyapıyı Oluştur (Create Infrastructure)

terraform apply

Veya onay beklemeden direkt uygula (apply without confirmation):

terraform apply -auto-approve

Ne yapar:

• Plan'ı gösterir
• Onay ister: yes yazın
• AWS'de kaynakları oluşturur (creates resources in AWS)
• terraform.tfstate dosyası oluşturur (state file)

Output:

aws_instance.alesta_web_server: Creating...
aws_instance.alesta_web_server: Creation complete after 45s

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

Outputs:
instance_public_ip = "54.123.45.67"

4. terraform destroy - Altyapıyı Sil (Destroy Infrastructure)

terraform destroy

Ne yapar:

• Terraform ile oluşturulan TÜM kaynakları siler (deletes ALL resources created by Terraform)
• Geri dönüşü yok! (irreversible!)

Kullanım senaryosu: Test ortamlarını temizleme, maliyet tasarrufu (clean test environments, cost savings)

Örnek: VPC + EC2 + S3 + ALB (Application Load Balancer)

# variables.tf - Değişkenler (Variables)
variable "project_name" {
  default = "alestaweb-app"
}

variable "region" {
  default = "us-east-1"
}

# vpc.tf - Virtual Private Cloud
resource "aws_vpc" "main" {
  cidr_block = "10.0.0.0/16"

  tags = {
    Name = "${var.project_name}-vpc"
  }
}

resource "aws_subnet" "public" {
  vpc_id            = aws_vpc.main.id
  cidr_block        = "10.0.1.0/24"
  availability_zone = "${var.region}a"

  tags = {
    Name = "${var.project_name}-public-subnet"
  }
}

# s3.tf - Storage Bucket
resource "aws_s3_bucket" "app_storage" {
  bucket = "${var.project_name}-storage-bucket"

  tags = {
    Name        = "AlestaWeb App Storage"
    Environment = "Production"
  }
}

# ec2.tf - Web Server
resource "aws_instance" "web" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"
  subnet_id     = aws_subnet.public.id

  tags = {
    Name = "${var.project_name}-web-server"
  }
}

# outputs.tf - Çıktılar (Outputs)
output "vpc_id" {
  value = aws_vpc.main.id
}

output "s3_bucket_name" {
  value = aws_s3_bucket.app_storage.bucket
}

output "web_server_ip" {
  value = aws_instance.web.public_ip
}

1. State Dosyasını Remote Storage'da Sakla (Store State in Remote Storage)

# backend.tf
terraform {
  backend "s3" {
    bucket = "my-terraform-state-bucket"
    key    = "terraform.tfstate"
    region = "us-east-1"
    encrypt = true
  }
}

Neden: Takım çalışmasında çakışma önler (prevents conflicts in team work), state güvenliğini artırır.

2. Değişkenleri Kullan (Use Variables)

# ❌ Kötü (Bad) - Hard-coded değerler
resource "aws_instance" "web" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"
}

# ✅ İyi (Good) - Değişkenler
variable "instance_type" {
  default = "t2.micro"
}

resource "aws_instance" "web" {
  ami           = var.ami_id
  instance_type = var.instance_type
}

3. .gitignore Kullan (Use .gitignore)

# .gitignore
.terraform/
*.tfstate
*.tfstate.backup
*.tfvars       # Secret değişkenler (secret variables)
.terraform.lock.hcl

ÖNEMLİ: State dosyalarını Git'e commit ETMEYİN (DO NOT commit state files to Git)!

4. Modülleri Kullan (Use Modules)

# Terraform Registry'den hazır modül kullan (use ready modules from Terraform Registry)
module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "5.0.0"

  name = "my-vpc"
  cidr = "10.0.0.0/16"
}

Kaynak: Terraform Registry