Technical Tutorials

Kuruluşlar bulut altyapılarını ölçeklendirdikçe, Kod Olarak Altyapı (IaC) karmaşıklığı katlanarak artar. Yüzlerce kaynağa sahip monolitik bir Terraform kod tabanını yönetmek, genellikle kırılgan durum dosyalarına, uzun planlama sürelerine ve dağıtım darboğazlarına yol açar. Kurumsal düzeydeki DevOps ekipleri için çözüm daha fazla kod yazmak değil, daha iyi ve daha yapılandırılmış kod yazmaktır. İşte burada modülerleştirme kritik hale gelir.

Bu yazıda, kurumsal ortamınızda yeniden kullanılabilirliği, sürdürülebilirliği ve güvenliği sağlamak için Terraform yapılandırmalarını modülerleştirme konusunda kanıtlanmış desenleri inceleyeceğiz.

Monolitik Yapıdan Modüllere Geçiş

Geleneksel olarak birçok ekip, Terraform projelerine tüm kaynakları tek bir main.tf dosyasında tanımlayarak başlardı. Bu yaklaşım kavram kanıtı (proof-of-concept) ortamlarında işe yarasa da, üretim ortamlarında ciddi şekilde başarısız olur. Monolitik bir yaklaşım, Tek Sorumluluk İlkesi'ni (Single Responsibility Principle) ihlal eder ve farklı ekiplerin durum çakışmaları yaratmadan bağımsız çalışmasını zorlaştırır.

Altyapıyı mantıksal modüllere ayırarak, ayrı ve kendi kendine yeten altyapı birimleri oluşturursunuz. Bu yaklaşım, "Kendini Tekrar Etme" (Don't Repeat Yourself - DRY) yazılım geliştirme ilkesiyle uyumludur ve altyapı bileşenlerini uygulama kodu gibi sürüm kontrolüne menzillemenize olanak tanır.

Temel Modülerleştirme Desenleri

Terraform'da modülleri yapılandırmak için iki temel yaklaşım vardır: Yerel Modüller ve Yayınlanan Modüller. Her biri kurumsal mimaride farklı bir amaca hizmet eder.

1. Kapsülleme İçin Yerel Modüller

Yerel modüller, genellikle özel bir modules/ dizini içinde olmak üzere, depo yapınızın içinde saklanır. Bu desen, her zaman birlikte dağıtılan ilgili kaynakları gruplandırmak için idealdir. Örneğin, standart bir VPC modülü alt ağları, yönlendirme tablolarını ve internet ağ geçitlerini kapsülleyebilir.

Basit bir ağ modülü yapısını ele alalım:

modules/
  networking/
    main.tf
    variables.tf
    outputs.tf
  compute/
    main.tf
    variables.tf
    outputs.tf

Bu yerel modülleri kök yapılandırmanızda kullanmak şu şekilde görünür:

module "vpc" {
  source      = "./modules/networking"
  environment = "prod"
  cidr_block  = "10.0.0.0/16"
  tags = {
    Project = "CorePlatform"
  }
}

module "ec2" {
  source          = "./modules/compute"
  vpc_id          = module.vpc.vpc_id
  subnet_id       = module.vpc.private_subnet_id
  instance_type   = "t3.medium"
}

Bu yapı, modül arayüzleri kararlı kaldığı sürece, ağ mantığındaki değişikliklerin hesaplama dağıtımlarını yanlışlıkla bozmamasını sağlar.

2. Ekipler Arası Yeniden Kullanım İçin Yayınlanan Modüller

Büyük kurumsal ortamlarda, birden fazla ekip (örneğin Güvenlik, Veri Mühendisliği, Ön Yüz) standart altyapıya erişim gerektirir. Kodu kopyalayıp yapıştırmak yerine, ekipler modüllerini özel bir kayıt defterine veya GitHub veya GitLab gibi bir kaynak kontrol barındırma hizmetine yayınlamalıdır.

Yayınlanan bir modülü tüketmek için, ad alanına göre başvuruda bulunursunuz:

module "secured_rds" {
  source  = "company/rds/aws"
  version = "2.1.0"
  
  engine           = "postgres"
  instance_class   = "db.t3.medium"
  enable_deletion_protection = true
}

Bu desen tutarlılığı garanti eder. Güvenlik ekibi, RDS modülünü diskteki şifrelemeyi zorunlu kılmak için güncellediğinde, sürüm kilidini güncelleyen tüm tüketici uygulamalar yeni güvenlik tabanıyla otomatik olarak hizalanır.

Kurumsal Benimseme İçin En İyi Uygulamalar

Bu desenleri başarıyla uygulamak için aşağıdaki en iyi uygulamalara uyun:

Katı Sürümleme: Tüm modüller için anlamsal sürümleme (SemVer) kullanın. Beklenmedik bozucu değişiklikleri önlemek için kök yapılandırmalarınızda sürümleri sabitleyin (pin).
Minimal Arayüzler: Modülleri açık giriş ve çıkışlarla tasarlayın. Kaynağın davranışını bulanıklaştıran modüller içinde yerel değişkenler (locals) veya veri kaynakları (data sources) kullanmaktan kaçının.
Otomatik Testler: Modüller yayınlanmadan önce işlevselliğini doğrulamak için CI/CD hatlarınıza terratest veya kitchen-terraform gibi araçları entegre edin.
Kod Olarak Dokümantasyon: Her modülün değişkenleri, çıkışları ve kullanım örneklerini belgeleyen sağlam bir README.md dosyasına sahip olması gerekir. Bu dokümantasyonu otomatik olarak oluşturmak için terraform-docs gibi araçlar kullanın.

Sonuç

Modülerleştirme sadece bir kodlama stili değil; kurumsal ölçekli altyapı için stratejik bir zorunluluktur. Yerel ve yayınlanan modül desenlerini benimseyerek DevOps ekipleri, teknik borcu azaltabilir, dağıtım döngülerini hızlandırabilir ve ölçek düzeyinde yönetimi (governance) uygulayabilir. En tekrarlayan kaynak desenlerinizi kapsülleyerek küçük başlayın ve tüm kuruluşunuzun bulutta güvenle inşa etmesini sağlayan güvenilir, yeniden kullanılabilir bileşenlerden oluşan bir kütüphane oluşturun.