Bir bulut konsolunun etrafına tıklamak bir sunucu için uygundur. Sahneleme ve prodüksiyonda aynı kuruluma ihtiyaç duyduğunuzda veya birisi geçen Mart ayında güvenlik duvarı kuralını kimin değiştirdiğini sorduğunda bozulur. Bu Yeni başlayanlar için Terraform eğitimi size daha iyi bir yol gösteriyor: altyapınızı kodla tanımlayın ve bir aracın bunu gerçeğe dönüştürmesine izin verin.

Çoğu eğitim, siz daha hiçbir şey öğrenmeden faturalandırma riskini ekleyen bir bulut hesabıyla başlar. Yalnızca bilgisayarınızda dosyalar oluşturan Terraform’un local sağlayıcısıyla başlıyoruz, böylece hataların hiçbir maliyeti yoktur. Bu örnekler ve örnek çıktı, bu makale için uygulamadığımız standart çizimlerdir ve tam ifadeler sürüme göre değişir.

Terraform nedir?

Terraform, HashiCorp’un kod olarak altyapı (IaC) aracıdır. Yapılandırma dosyalarını, istediğiniz nihai sonucu açıklayan HashiCorp Yapılandırma Dili HCL’de yazarsınız. Terraform daha sonra bu noktaya ulaşmak için nelerin oluşturulacağını, değiştirileceğini veya silineceğini belirler.

Sağlayıcılar adı verilen eklentiler aracılığıyla platformlarla iletişim kurar. AWS, Azure, Google Cloud, Kubernetes, GitHub, Cloudflare ve daha pek çok sağlayıcı için sağlayıcılar mevcut olduğundan bunların hepsinde tek bir iş akışı kullanabilirsiniz.

Bilinmesi gereken bir şey var: 2023 yılında HashiCorp, Terraform’u İş Kaynağı Lisansına taşıdı. Topluluk daha sonra çok benzer komutları ve yapılandırmayı kullanan açık kaynaklı bir çatal olan OpenTofu‘yu yarattı. Burada öğrendikleriniz büyük ölçüde her ikisi için de geçerlidir.

Neden kod olarak altyapı?

Terraform aynı zamanda bildirimseldir. “Üç kez sunucu oluştur” değil “üç sunucu olmalı” diyorsunuz. Zaten iki tane varsa, bir tane ekler. Basitçe adımlarını tekrarlayan bir komut dosyası, üç adım daha oluşturabilir.

Terraform’u yükleyin

İşletim sisteminiz için resmi HashiCorp talimatlarını kullanarak yükleyin ve ardından çalıştığını doğrulayın:

terraform -version

Proje için boş bir klasör oluşturun. Terraform geçerli klasördeki her .tf dosyayı okur, dolayısıyla bir klasör bir konfigürasyona eşittir.

İlk yapılandırmanız

main.tf adlı bir dosya oluşturun:

terraform {
  required_providers {
    local = {
      source  = "hashicorp/local"
      version = "~> 2.5"
    }
  }
}

resource "local_file" "greeting" {
  filename = "${path.module}/hello.txt"
  content  = "Hello from Terraform\n"
}

resource bloğuna bakın, yazdığınız neredeyse her şey bu şekli takip ediyor. local_file kaynak türüdür ve greeting, yapılandırma içindeki kaynak için kendi adınızdır. Birlikte adresini oluştururlar: local_file.greeting. İçerideki argümanlar ne istediğinizi açıklıyor.

İş akışı: Başlat, planla, uygula

Terraform başlangıcı

Bu, klasörü hazırlar ve istediğiniz sağlayıcıları indirir. Başlangıçta bir kez ve bir sağlayıcı veya modül eklediğinizde tekrar çalıştırın. Ayrıca tam sağlayıcı sürümlerini kaydeden bir .terraform.lock.hcl dosyası oluşturur. Bu dosyayı Git’e gönderin.

terraform init

dünya planı

Bu, kodunuzu mevcut olanla karşılaştırır ve hiçbir şeye dokunmadan planlanan değişiklikleri gösterir:

terraform plan

# local_file.greeting will be created
+ resource "local_file" "greeting" {
    + content  = "Hello from Terraform\n"
    + filename = "./hello.txt"
  }

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

Sembolleri öğrenin çünkü birçok plan okuyacaksınız:

Terraform uygulaması

Bu, planı tekrar gösterir, onay ister ve değişiklikleri yapar:

terraform apply

Tip yes ve hello.txt görünür. Şimdi terraform plan‘ü tekrar çalıştırın. Gerçeklik zaten kodunuzla eşleştiğinden hiçbir değişiklik bildirmemelidir. Tekrar tekrar çalıştırılmasının başka bir değişikliğe neden olmadığı bu özelliğe, eşdeğerlik adı verilir.

Değiştirmek ve yok etmek

content satırını düzenleyin ve terraform plan‘yi çalıştırın. Terraform farkı tespit ediyor ve bir değişiklik öneriyor. Bu kaynak için dosyanın yerini alır. Bir veritabanını yeniden oluşturmak veri kaybı anlamına gelebileceğinden, gerçek altyapıdaki değişikliklere dikkat edin.

Daha sonra hello.txt öğesini elle silin ve yeniden planlayın. Terraform eksik olduğunu fark eder ve onu yeniden oluşturmayı teklif eder. Kodunuzla gerçeklik arasındaki farka sürüklenme adı verilir ve bunun tespit edilmesi, aracın temel faydalarından biridir.

Bu yapılandırmanın yönettiği her şeyi kaldırmak için şunu çalıştırın:

terraform destroy

Değişkenler ve çıktılar

Sabit kodlanmış değerler kodu yeniden kullanmanızı engeller. Giriş değişkenleri konfigürasyonu esnek hale getirir ve çıktılar yararlı değerleri rapor eder:

# variables.tf
variable "environment" {
  type        = string
  description = "Deployment environment"
  default     = "dev"

  validation {
    condition     = contains(["dev", "staging", "prod"], var.environment)
    error_message = "Use dev, staging or prod."
  }
}

# main.tf
resource "local_file" "config" {
  filename = "${path.module}/${var.environment}.txt"
  content  = "environment=${var.environment}\n"
}

# outputs.tf
output "config_path" {
  value = local_file.config.filename
}

Değerleri komut satırında ayarlayın veya bunları otomatik olarak yüklenen terraform.tfvars adlı bir dosyada saklayın:

terraform apply -var="environment=staging"

Çıktıda local_file.config.filename kullanılması aynı zamanda kaynakların birbirlerine nasıl atıfta bulunduğunu da gösterir. Terraform, bir şeylerin yaratılacağı doğru sırayı bulmak için bu referansları okur.

Terraform durumu

Başvurduktan sonra terraform.tfstate adlı bir dosya bulacaksınız. Bu Terraform’un, kodunuzu gerçek nesnelerle eşleştirerek neyi yönettiğine ilişkin kaydıdır. O olmasaydı Terraform local_file.greeting dosyasının o spesifik dosya olduğunu bilemezdi.

Burada üç kural önemlidir:

1. Hiçbir zaman Git’e durum aktarma. Düz metin halinde şifreler ve diğer sırlar içerebilir.
2. El ile düzenlemeyin. terraform state list ve terraform state mv gibi komutları kullanın.
3. Ekip projeleri için uzak bir arka uç kullanın. Paylaşılan bir arka uç, durumu merkezi olarak depolar ve kilitler; böylece iki kişi aynı anda başvuramaz.

Aşağıda, önceden oluşturduğunuz bir klasörle Amazon S3’ü kullanan tipik bir arka uç gösterilmektedir:

terraform {
  backend "s3" {
    bucket       = "my-company-terraform-state"
    key          = "shop/prod/terraform.tfstate"
    region       = "ap-south-1"
    encrypt      = true
    use_lockfile = true
  }
}

Gerçek bir bulut kaynağı

Buluta geçtiğinizde iş akışı değişmez. İşte AWS’deki bir S3 kovası. Önce fiyatı kontrol edin ve pratik yaparken yarattığınız her şeyi yok edin:

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

resource "aws_s3_bucket" "reports" {
  bucket = "my-unique-reports-bucket-2026"

  tags = {
    Environment = var.environment
    ManagedBy   = "terraform"
  }
}

Terraform, kimlik bilgilerini AWS CLI kurulumunuzdan veya ortam değişkenlerinden alır. Erişim anahtarlarını asla .tf dosyasına yazmayın.

Modüller

Bir modül, farklı girişlerle çağırabileceğiniz Terraform dosyalarından oluşan bir klasördür. Bir işleve çok benzer şekilde çalışır; bir modeli bir kez tanımlayıp yeniden kullanmanıza olanak tanır:

project/
  main.tf
  modules/
    reports_bucket/
      main.tf
      variables.tf
      outputs.tf

module "staging_reports" {
  source      = "./modules/reports_bucket"
  environment = "staging"
}

module "prod_reports" {
  source      = "./modules/reports_bucket"
  environment = "prod"
}

Herkese açık Terraform Kayıt Defteri’nde de hazır modüller vardır, ancak bunlara güvenmeden önce bunları okuyun ve sürümü sabitleyin. Modülleri çok erken inşa etmeyin. Bir deseni en az iki kez tekrarlayana kadar bekleyin.

Güvenli bir ekip iş akışı

1. Bir dal oluşturun ve .tf dosyalarını değiştirin. Bilgilerinizi tazelemeye ihtiyacınız varsa Yeni başlayanlar için Git eğiticimize bakın.
2. terraform fmt ve terraform validate‘yi çalıştırın.
3. İnceleme için terraform plan çıktısının eklendiği bir çekme isteği açın.
4. Onaylandıktan sonra, kaydedilen planı tek bir kontrollü yerden, ideal olarak bir boru hattından uygulayın.

Planı kaydetmek, incelenenleri tam olarak uygulamanızı sağlar:

terraform plan -out=tfplan
terraform apply tfplan

Bu, doğal olarak CI/CD ve GitHub Eylemleri‘ne uyar. Terraform genellikle kümenin temel hazırlığını yapar ve Kubernetes gibi araçlar bunun üzerinde uygulamaları çalıştırır.

Yaygın hatalar

• Planı okumadan başvurmak. Bir veritabanındaki bir -/+ çok pahalı bir sürpriz olabilir.
• Durum bir dizüstü bilgisayarda tutuluyor. Bu dizüstü bilgisayarı kaybederseniz Terraform altyapınızın takibini de kaybeder.
• Manuel konsol değişiklikleri yapmak. Kaymaya neden olurlar ve bir sonraki uygulama bunları geri alabilir.
• Sabitlenmemiş sürümleri kullanma. Yükseltmelerin bilinçli olarak gerçekleşmesi için sağlayıcı ve modül sürümlerini sabitleyin.
• Çok büyük bir yapılandırma kullanma. Ortama veya sisteme göre bölmek, herhangi bir hatanın vereceği zararı sınırlar.

Son sözler

Artık neredeyse tüm Terraform çalışmalarının ardındaki fikirleri gördünüz: kaynakları bildirmek, planı gözden geçirmek, uygulamak ve devleti korumak. İş akışı doğal hale gelene kadar local sağlayıcıyla pratik yapın, ardından küçük bir gerçek kaynağı ücretsiz katmanlı bir hesapta yönetin. Birden fazla kişi veya birden fazla ortam dahil olduğunda uzak durumu ve modülleri devreye alın.

Sık sorulan sorular

Öğrenmeye devam et