Hızlı Başlangıç: AzAPI Terraform sağlayıcısıyla ilk Azure kaynağınızı dağıtma
Makale, aşağıdaki Terraform ve Terraform sağlayıcı sürümleriyle test edilmiştir:
Terraform , bulut altyapısının tanımlanmasını, önizlemesini ve dağıtımını sağlar. Terraform kullanarak HCL söz dizimlerini kullanarak yapılandırma dosyaları oluşturursunuz. HCL söz dizimi, Azure gibi bulut sağlayıcısını ve bulut altyapınızı oluşturan öğeleri belirtmenize olanak tanır. Yapılandırma dosyalarınızı oluşturduktan sonra, altyapı değişikliklerinizin dağıtılmadan önce önizlemesini görüntülemenizi sağlayan bir yürütme planı oluşturursunuz. Değişiklikleri doğruladıktan sonra, altyapıyı dağıtmak için yürütme planını uygularsınız.
Bu makalede, AzAPI Terraform sağlayıcısını kullanarak şu anda AzureRM sağlayıcısı tarafından desteklenmeyen bir Azure hizmetini yönetmeyi öğreneceksiniz. , azapi_resource
hem Azure Lab Services hesabını hem de laboratuvarı yönetmek için kullanılır.
- AzureRM ve AzAPI sağlayıcılarını tanımlayın ve yapılandırın.
- AzureRM sağlayıcısını kullanarak azure kaynak grubu oluşturma
- Aboneliğinize "Microsoft.LabServices" sağlayıcısını kaydetmek için AzureRM sağlayıcısını kullanın
- Azure Lab Services kaynaklarını oluşturmak için AzAPI sağlayıcısını kullanma
Not
Bu makaledeki örnek kod, Azure Terraform GitHub deposunda bulunur.
Önkoşullar
- Azure aboneliği: Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Terraform'ı yapılandırma: Henüz yapmadıysanız, aşağıdaki seçeneklerden birini kullanarak Terraform'ı yapılandırın:
Terraform kodunu uygulama
Örnek Terraform kodunu test etmek ve geçerli dizin yapmak için bir dizin oluşturun.
adlı
providers.tf
bir dosya oluşturun ve aşağıdaki kodu ekleyin:terraform { required_providers { azapi = { source = "azure/azapi" version = "=0.1.0" } azurerm = { source = "hashicorp/azurerm" version = "=3.0.2" } } } provider "azapi" { default_location = "eastus" default_tags = { team = "Azure deployments" } } provider "azurerm" { features {} }
adlı
main.tf
bir dosya oluşturun ve aşağıdaki kodu ekleyin:resource "azurerm_resource_group" "qs101" { name = "rg-qs101" location = "westus2" }
adlı
main-generic.tf
bir dosya oluşturun ve aşağıdaki kodu ekleyin:# Provision a Lab Service Account and a Lab that are in public preview resource "azapi_resource" "qs101-account" { type = "Microsoft.LabServices/labaccounts@2018-10-15" name = "qs101LabAccount" parent_id = azurerm_resource_group.qs101.id body = jsonencode({ properties = { enabledRegionSelection = false } }) } resource "azapi_resource" "qs101-lab" { type = "Microsoft.LabServices/labaccounts/labs@2018-10-15" name = "qs101Lab" parent_id = azapi_resource.qs101-account.id body = jsonencode({ properties = { maxUsersInLab = 10 userAccessMode = "Restricted" } }) }
Terraform'u başlatma
Terraform dağıtımını başlatmak için terraform init komutunu çalıştırın. Bu komut, Azure kaynaklarınızı yönetmek için gereken Azure sağlayıcısını indirir.
terraform init -upgrade
Önemli noktalar:
-upgrade
parametresi, gerekli sağlayıcı eklentilerini yapılandırmanın sürüm kısıtlamalarına uygun en yeni sürüme yükseltir.
Terraform yürütme planı oluşturma
Terraform planını çalıştırarak yürütme planı oluşturun.
terraform plan -out main.tfplan
Önemli noktalar:
- komutu
terraform plan
bir yürütme planı oluşturur ancak yürütmez. Bunun yerine, yapılandırma dosyalarınızda belirtilen yapılandırmayı oluşturmak için hangi eylemlerin gerekli olduğunu belirler. Bu düzen, gerçek kaynaklarda değişiklik yapmadan önce yürütme planının beklentilerinizle eşleşip eşleşmediğini doğrulamanızı sağlar. - İsteğe bağlı
-out
parametresi, plan için bir çıkış dosyası belirtmenize olanak tanır. parametresinin-out
kullanılması, gözden geçirdiğiniz planın tam olarak uygulanan plan olmasını sağlar.
Terraform yürütme planı uygulama
Yürütme planını bulut altyapınıza uygulamak için terraform apply komutunu çalıştırın.
terraform apply main.tfplan
Önemli noktalar:
- Örnek
terraform apply
komut, daha önce komutunu çalıştırdığınızıterraform plan -out main.tfplan
varsayar. - parametresi için
-out
farklı bir dosya adı belirttiyseniz, çağrısındaterraform apply
aynı dosya adını kullanın. - parametresini
-out
kullanmadıysanız, parametresiz olarak çağırınterraform apply
.
Sonuçları doğrulama
- Azure aboneliğinizde kaynak grubuna
rg-qs101
göz atın. - adlı
qs101LabAccount
yeni bir Lab Services hesabı, kaynak grubunun üyesi olarak görüntülenir.
Kaynakları temizleme
Terraform aracılığıyla oluşturulan kaynaklara artık ihtiyacınız kalmadığında aşağıdaki adımları uygulayın:
terraform planını çalıştırın ve bayrağını
destroy
belirtin.terraform plan -destroy -out main.destroy.tfplan
Önemli noktalar:
- komutu
terraform plan
bir yürütme planı oluşturur ancak yürütmez. Bunun yerine, yapılandırma dosyalarınızda belirtilen yapılandırmayı oluşturmak için hangi eylemlerin gerekli olduğunu belirler. Bu düzen, gerçek kaynaklarda değişiklik yapmadan önce yürütme planının beklentilerinizle eşleşip eşleşmediğini doğrulamanızı sağlar. - İsteğe bağlı
-out
parametresi, plan için bir çıkış dosyası belirtmenize olanak tanır. parametresinin-out
kullanılması, gözden geçirdiğiniz planın tam olarak uygulanan plan olmasını sağlar.
- komutu
Yürütme planını uygulamak için terraform apply komutunu çalıştırın.
terraform apply main.destroy.tfplan
Azure'da Terraform sorunlarını giderme
Azure'da Terraform kullanırken karşılaşılan yaygın sorunları giderme
Sonraki adımlar
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin