Mevcut Kaynakları İçe Aktarma

Bazen elle veya başka araçlar tarafından oluşturulmuş bulut kaynaklarınız olabilir. Terraform içe aktarma, bu mevcut kaynakları Terraform yönetimi altına almanızı sağlar.

Bu sayede Terraform, kaynakların durumunu izler ve gelecekteki değişiklikler yapılandırma dosyalarınız aracılığıyla uygulanabilir. Bu, "brownfield" bir ortamda Kod Olarak Altyapıyı (IaC) benimsemenin önemli bir adımıdır.

İçe aktarma çeşitli durumlarda yararlıdır:

• Mevcut altyapıyı taşıma: Terraform dışında oluşturulmuş kaynakları IaC iş akışınıza dahil etmek.
• Terraform'u aşamalı olarak benimseme: Her şeyi yeniden oluşturmak yerine mevcut kaynaklarla başlamak.
• Durum kaybından kurtarma: Durum dosyanız kaybolursa Terraform'u kaynaklarla yeniden ilişkilendirmek (uzak durum kullanıldığında bu nadir görülür).

terraform import komutunun temel yapısı oldukça basittir. Bu komut, Terraform'a bulut sağlayıcınızdaki mevcut bir kaynağı bulmasını ve yapılandırmanızdaki bir kaynak bloğuyla ilişkilendirerek durum dosyanıza eklemesini söyler.

İki temel bilgi gerekir: kaynağın Terraform adresi ve bulut sağlayıcısının bu kaynak için verdiği ID.

Kaynak adresi, Terraform'un yapılandırmanız içindeki belirli bir kaynağı tanımlama biçimidir. resource_type.resource_name biçimini izler.

• resource_type: Kaynağın türü (ör. aws_s3_bucket, azurerm_resource_group).
• resource_name: Terraform yapılandırmanızda kaynağa verdiğiniz yerel ad (ör. my_bucket, web_app).

Bu adresin .tf dosyalarınızda zaten mevcut olması gerekir.

Bir bulut sağlayıcısındaki (AWS, Azure veya GCP gibi) her kaynağın genellikle ID olarak adlandırılan benzersiz bir tanımlayıcısı vardır. Terraform'a içe aktarılacak mevcut kaynağın *hangisi* olduğunu belirtmek için bu ID'ye ihtiyacınız olacaktır.

Bu ID'yi bulut sağlayıcısının konsolunda, sağlayıcının CLI aracılığıyla veya API'si üzerinden bulabilirsiniz. Örneğin, bir AWS S3 klasörünün ID'si kendi adı iken bir EC2 örneğinin i-0abcdef1234567890 gibi bir örnek ID'si vardır.

Kritik Adım: terraform import komutunu çalıştırmadan önce Terraform yapılandırma dosyalarınızda (.tf dosyalarında) karşılık gelen bir kaynak bloğu tanımlamış olmanız gerekir.

Bu blok, Terraform'a ne tür bir kaynak beklemesi gerektiğini ve hangi özniteliklere sahip olması gerektiğini bildirir. Terraform, içe aktarma sırasında kaynağın şemasını anlamak için bu tanımı kullanır.

Diyelim ki my-existing-coddykit-bucket-123 adlı mevcut bir AWS S3 klasörünüz var. Önce main.tf dosyanızda bunun için bir kaynak bloğu tanımlayın:

Artık HCL tanımına sahip olduğunuza göre terraform import komutunu çalıştırabilirsiniz. my-existing-coddykit-bucket-123 ifadesini mevcut klasörünüzün gerçek adı/ID'siyle değiştirin.

Dizininizde daha önce terraform init komutunu çalıştırdığınızdan emin olun!

Başarılı bir içe aktarmanın ardından Terraform, kaynağı durum dosyanıza eklemiş olur. Bunu, Terraform'un içe aktarılan kaynağın özniteliklerini nasıl gördüğünü gösteren terraform state show komutuyla doğrulayabilirsiniz.

Ardından HCL'niz ile içe aktarılan kaynağın gerçek durumu arasında beklenmeyen farklar olmadığından emin olmak için terraform plan komutunu çalıştırmanız çok önemlidir.

Mevcut bir AWS EC2 örneğini Terraform'a aktarmak istiyorsunuz. terraform import komutunu çalıştırmadan *önce* aşağıdaki adımlardan hangisinin tamamlanmış olması GEREKİR?

Mevcut bulut kaynaklarını terraform import kullanarak Terraform yönetimi altına almayı öğrendiniz.

• Önce HCL'nizde kaynak bloğunu tanımlayın.
• Ardından bulut sağlayıcısının kaynak ID'sini belirleyin.
• Son olarak terraform import ADDRESS ID komutunu çalıştırın.
• Farkları uzlaştırmak için her zaman terraform plan komutuyla devam edin.

Bu güçlü komut, elle yönetilen altyapı ile tamamen IaC tabanlı bir ortam arasındaki boşluğu kapatmaya yardımcı olur.