Kod Olarak Altyapı (Infrastructure as Code - IaC), bulut kaynaklarını yönetmek için standart bir uygulama haline geldi. Terraform gibi araçlar alana özgü diller (HCL) kullanırken, Pulumi farklı bir yaklaşım benimseyerek altyapınızı TypeScript, Python, Go ve C# gibi bildiğiniz genel amaçlı programlama dilleriyle tanımlamanıza olanak tanır.

Bu rehberde, Pulumi'nin temel kavramlarını inceleyecek ve TypeScript kullanarak gerçek bir AWS kaynağı dağıtacağız.

Pulumi Nedir?

Pulumi, bulut altyapısını oluşturmanıza, dağıtmanıza ve yönetmenize olanak tanıyan açık kaynaklı bir IaC aracıdır. Yeni bir sözdizimi öğrenmenizi gerektiren diğer araçların aksine, Pulumi mevcut ekosistemlerden yararlanır.

Diller: Döngüler, fonksiyonlar, sınıflar ve paket yöneticilerini (npm, pip) kullanabilirsiniz.
Durum (State) Yönetimi: Pulumi, altyapınızın durumunu varsayılan olarak Pulumi Cloud'da veya tercih ederseniz bir S3 bucket/yerel dosya sisteminde saklar.
Çoklu Bulut: AWS, Azure, Google Cloud ve Kubernetes'i destekler.

Ön Koşullar

Başlamadan önce aşağıdakilerin kurulu olduğundan emin olun:

Node.js: TypeScript çalışma zamanı için gereklidir.
AWS CLI: AWS kimlik bilgilerinizle yapılandırılmış olmalıdır (aws configure).
Pulumi CLI: Homebrew (macOS), curl (Linux) veya Chocolatey (Windows) ile kurulabilir.

# macOS
brew install pulumi

# Linux
curl -fsSL https://get.pulumi.com | sh

# Windows
choco install pulumi

Projeyi Kurma

AWS TypeScript şablonunu kullanarak yeni bir Pulumi projesi oluşturalım.

1. Projeyi Başlatma

mkdir pulumi-aws-demo && cd pulumi-aws-demo
pulumi new aws-typescript

CLI sizden şunları isteyecektir:

Project name: (varsayılan: pulumi-aws-demo)
Description: Kısa bir açıklama.
Stack name: (varsayılan: dev) - Bu, izole edilmiş bir ortamı temsil eder (örn. dev, prod).
AWS Region: (örn. us-east-1).

Altyapı Kodunu Yazma

index.ts dosyasını açın. Kaynaklarımızı burada tanımlarız. Basit bir S3 bucket oluşturacağız.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

// AWS kaynağı oluştur (S3 Bucket)
const bucket = new aws.s3.Bucket("my-bucket", {
    tags: {
        Environment: "Dev",
        Name: "MyPulumiBucket"
    }
});

// Bucket adını dışa aktar
export const bucketName = bucket.id;

Temel Kavramlar:

Resources (Kaynaklar): aws.s3.Bucket, AWS S3 hizmetine eşlenen bir Pulumi kaynak sınıfıdır.
Outputs (Çıktılar): bucket.id bir çıktı özelliğidir. Pulumi bu değeri kaynak oluşturulduktan sonra kesinleştirir.
Exports (Dışa Aktarmalar): export const bucketName, dağıtımdan sonra bu değeri CLI'da görmemizi sağlar.

Altyapıyı Dağıtma

Kaynakları sağlamak (provision) için şu komutu çalıştırın:

pulumi up

Pulumi değişikliklerin bir önizlemesini ("plan") gösterecektir. İnceleyin ve onaylamak için yes seçeneğini seçin.

Updating (dev)

     Type                 Name             Status      
 +   pulumi:pulumi:Stack  pulumi-aws-demo  created     
 +   └─ aws:s3:Bucket     my-bucket        created     

Outputs:
    bucketName: "my-bucket-12345abcdef"

Resources:
    + 2 created

Duration: 4s

Dağıtımı Doğrulama

Bucket'ın var olduğunu AWS CLI kullanarak doğrulayabilirsiniz:

aws s3 ls | grep my-bucket

Temizlik

Maliyet oluşmasını önlemek için işiniz bittiğinde kaynakları yok edin:

pulumi destroy

Bu stack tarafından yönetilen tüm kaynakları kaldırmak için yes ile onaylayın.

SSS

Pulumi ücretsiz mi?

Pulumi açık kaynaklıdır ve bireysel geliştiriciler için kullanımı ücretsizdir. Gelişmiş politika ve durum yönetimi özelliklerine ihtiyaç duyan ekipler için ücretli planlar sunarlar.

Pulumi durumumu (state) nerede saklar?

Varsayılan olarak Pulumi, durumu Pulumi Cloud'da (yönetilen hizmet) saklar. Ancak, durumu yerel olarak veya bir S3 bucket/Azure Blob/GCS içinde saklayacak şekilde yapılandırabilirsiniz.

Mevcut AWS kaynaklarını kullanabilir miyim?

Evet, Pulumi mevcut kaynakları stack'inize aktarmanızı (import) destekler, böylece onları kod aracılığıyla yönetebilirsiniz.

#Pulumi İle İlgili Yazılar

AWS üzerinde Pulumi Kullanım Rehberi: Başlangıç