Ağ & NetworkOrta

Azure Developer CLI (azd) ile Geliştirme Önkoşullarının ve Komut Çalıştırmanın Yönetimi

Azure Developer CLI (azd), geliştirme ortamı gereksinimlerini yönetmek için yeni `azd tool` komut grubunu ve komut çalıştırma aracı `azd exec`ı tanıttı. Bu özellikler, SDK'lar, Docker ve Bicep CLI gibi araçların kolayca keşfedilmesini, kurulmasını ve güncellenmesini sağlar.

4
4sysops
0 görüntülenme
Azure Developer CLI (azd) ile Geliştirme Önkoşullarının ve Komut Çalıştırmanın Yönetimi

Giriş

Azure Developer CLI (azd), Azure bulut ortamlarında uygulama geliştirme sürecini kolaylaştırmak amacıyla tasarlanmış bir komut satırı aracıdır. Son güncellemelerle birlikte, geliştiricilerin karşılaştığı yaygın sorunların başında gelen geliştirme ortamı gereksinimlerinin yönetimi ve komut çalıştırma süreçleri önemli ölçüde iyileştirilmiştir. Bu makalede, yeni `azd tool` komut grubu ve `azd exec` aracının nasıl kullanılacağı detaylı olarak açıklanacaktır.

Sorun: Geliştirme Ortamı Gereksinimlerinin Yönetimi

Azure uygulamaları geliştirirken karşılaşılan en büyük zorluklardan biri, uygun geliştirme araçlarının eksikliği veya uyumsuz sürümler nedeniyle oluşan şablon dağıtım hatalarıdır. Örneğin:

  • Gerekli olan .NET SDK, Node.js, Python veya Java SDK'larının eksik olması.
  • Docker'ın yerel olarak kurulmaması veya yanlış sürümde çalışması.
  • Bicep CLI gibi Azure kaynaklarını tanımlamak için gerekli araçların güncel olmaması.

Bu sorunlar, geliştiricilerin zaman kaybetmesine ve dağıtım hatalarına yol açarak verimliliği düşürmektedir. Azure Developer CLI, bu sorunlara yönelik `azd tool` komut grubunu sunarak geliştirme ortamını otomatik olarak yönetmeyi mümkün kılmaktadır.

Çözüm: `azd tool` Komut Grubu ile Geliştirme Araçlarını Yönetme

`azd tool` komut grubu, geliştirme ortamı gereksinimlerini keşfetme, kurma ve güncelleme işlemlerini basitleştirir. Bu komut grubu aşağıdaki temel işlevleri sunar:

1. Mevcut Araçların Keşfi (`azd tool list`)

Aşağıdaki komutla, sistemde kurulu olan ve Azure Developer CLI tarafından desteklenen araçların listesini görüntüleyebilirsiniz:

azd tool list

Çıktı Örneği:

Name         Version    Installed    Supported
----------------------------------------------
dotnet       8.0.100    ✅           ✅
node         20.11.1    ✅           ✅
python       3.11.6     ❌           ✅
docker       24.0.7     ✅           ✅
bicep        0.27.1     ❌           ✅

2. Gerekli Araçların Kurulumu (`azd tool install`)

Eksik olan araçları tek bir komutla kurabilirsiniz. Örneğin, Python SDK'sını kurmak için:

azd tool install python --version 3.11.6

Benzer şekilde, Bicep CLI'yi kurmak için:

azd tool install bicep

3. Araçların Güncellenmesi (`azd tool upgrade`)

Desteklenen en son sürümleri otomatik olarak güncellemek için:

azd tool upgrade

Not: Bu komut, tüm desteklenen araçları varsayılan olarak en son stabil sürüme günceller. Belirli bir aracı güncellemek için:

azd tool upgrade bicep --version 0.28.0

4. Araçların Kaldırılması (`azd tool uninstall`)

Bir aracı sistemden kaldırmak için:

azd tool uninstall python

Sorun: Komutların Çevre Bağımsız Değişkenleriyle ve Sırlarla Yürütülmesi

Azure uygulamalarında çalıştırılan komutlar genellikle çevre bağımsız değişkenlerine (environment variables) ve Azure Key Vault sırlarına (secrets) ihtiyaç duyar. Geleneksel yöntemlerde, bu değişkenlerin manuel olarak ayarlanması veya komut satırında açıkça belirtilmesi gerekmektedir. Bu durum, hem güvenlik riski oluşturmakta hem de komutların karmaşık hale gelmesine neden olmaktadır.

Çözüm: `azd exec` ile Güvenli ve Bağlamlı Komut Çalıştırma

`azd exec`

`azd exec`, komutları tam bir çevre bağlamı ve Azure Key Vault sırlarıyla birlikte çalıştıran yeni bir komut çalıştırma aracıdır. Bu araç, aşağıdaki özellikleri sunar:

1. Çevre Bağımsız Değişkenlerinin Yönetimi

`azd exec`, komutları çalıştırmadan önce otomatik olarak gerekli çevre bağımsız değişkenlerini yükler. Örneğin, bir Azure Kaynak Grubu oluşturmak için gerekli olan `AZURE_RESOURCE_GROUP` değişkenini otomatik olarak ayarlayabilirsiniz:

azd exec --command "az group create --name MyResourceGroup --location eastus"

2. Azure Key Vault Sırlarının Entegre Edilmesi

Azure Key Vault'tan sırları otomatik olarak çözümleyerek komutlara aktarabilirsiniz. Örneğin, bir veritabanı bağlantı dizesini Key Vault'tan almak için:

azd exec --command "az deployment group create --resource-group MyResourceGroup --template-file main.bicep --parameters dbConnectionString=@Microsoft.KeyVault(SecretUri=https://mykeyvault.vault.azure.net/secrets/dbConnectionString)"

3. Çapraz Platform Desteği

`azd exec`, Windows, Linux ve macOS dahil olmak üzere tüm ana işletim sistemlerinde çalışır. Bu sayede, geliştiriciler farklı platformlarda tutarlı bir deneyim elde ederler.

Uygulama Adımları: `azd tool` ve `azd exec` Kullanımı

  1. Azure Developer CLI'yi Kurun

    Aşağıdaki komutla Azure Developer CLI'yi sisteminize kurun:

    azd auth login

    Bu komut, Azure hesabınıza giriş yapmanızı ve CLI'yi yapılandırmanızı sağlar.

  2. Geliştirme Araçlarını Kontrol Edin

    Mevcut araçları listeleyin ve eksik olanları belirleyin:

    azd tool list

  3. Eksik Araçları Kurun

    Örneğin, Docker'ı kurmak için:

    azd tool install docker

    Python SDK'sını kurmak için:

    azd tool install python --version 3.11.6

  4. Geliştirme Ortamınızı Güncelleyin

    Tüm araçları en son sürümlere güncelleyin:

    azd tool upgrade

  5. Komutları `azd exec` ile Çalıştırın

    Örneğin, bir Azure Kaynak Grubu oluşturmak için:

    azd exec --command "az group create --name MyResourceGroup --location eastus"

    Key Vault'tan bir sır kullanarak bir Bicep şablonu dağıtmak için:

    azd exec --command "az deployment group create --resource-group MyResourceGroup --template-file main.bicep --parameters dbPassword=@Microsoft.KeyVault(SecretUri=https://mykeyvault.vault.azure.net/secrets/dbPassword)"

İpuçları ve Uyarılar

İpucu 1: `azd tool install` komutunu kullanırken, `--version` parametresini belirtmezseniz, Azure Developer CLI en uygun sürümü otomatik olarak seçer. Ancak, belirli bir sürüm gerekiyorsa mutlaka belirtin.

Uyarı 1: `azd exec` komutunu kullanırken, komutlar varsayılan olarak Azure hesabınızın yetkileriyle çalışır. Bu nedenle, hassas işlemler yapmadan önce yetkilerinizi gözden geçirin.

İpucu 2: Azure Key Vault sırlarını kullanırken, sırların URI'sini doğru şekilde belirtin. Yanlış URI'ler komutların başarısız olmasına neden olabilir.

Sonuç

Azure Developer CLI'nin yeni `azd tool` ve `azd exec` özellikleri, geliştiricilerin Azure uygulamaları geliştirirken karşılaştıkları en yaygın sorunları çözmeyi hedeflemektedir. `azd tool` komut grubu, geliştirme ortamı gereksinimlerini otomatik olarak yönetirken, `azd exec` aracı komutların güvenli ve bağlamlı bir şekilde çalıştırılmasını sağlar. Bu özellikler sayesinde, geliştiriciler hem zaman kazanmakta hem de dağıtım hatalarını minimize etmektedir. Azure Developer CLI'yi kullanmaya başlamak için resmi dokümantasyonu inceleyebilirsiniz.

Kaynak

4sysops
İlgili Makaleler