Azure Geliştirici CLI başlatma iş akışlarını keşfetme

Azure Geliştirici CLI'sı (azd), Azure'da uygulama geliştirmeyi, sağlamayı ve dağıtmayı kolaylaştırmak için bir dizi komut sağlar. azd init komutu, ile azdçalışmak için gereken dosyaları ve yapılandırmaları oluşturarak yeni veya mevcut projeleri ayarlamanıza yardımcı olur. Bu makalede, kullanılabilir farklı başlatma iş akışları ve geliştirme senaryonuz için en iyi seçeneğin nasıl seçilebilir olduğu açıklanır.

Başlatma iş akışları

komutu, azd init uygulamanızı ile azdçalışmaya hazırlamak için çeşitli iş akışlarını destekler:

GitHub Copilot (Önizleme) ile ayarlama: Proje planlayan, şablon varlıkları oluşturabilen ve sonucu doğrulayan ayrılmış bir Copilot aracısı oturumu başlatır.
Geçerli dizini tara: Uygun azd yapılandırma dosyalarını ve kaynaklarını oluşturmak için mevcut bir uygulama kod tabanını analiz eder.
Bir şablon seçin: azd bir şablonu kopyalar ve başlatır.
En az proje oluşturma: Sıfırdan kendi azure.yaml şablonunuzu oluşturmak için başlangıç noktası olarak temel azd bir dosya başlatır.

Şablon geliştirme için GitHub Copilot ile kurulum (Önizleme) seçeneğini kullanın. Yazma yaşam döngüsünün tamamına genel bakış için bkz. Şablon geliştirmeye genel bakış. Aşağıdaki bölümlerde her başlatma iş akışı açıklanmaktadır.

GitHub Copilot (Önizleme) ile kurulum

Yapay zeka yardımıyla şablon oluşturmak için bu iş akışını kullanın. azdmevcut proje dosyalarını inceleyebilecek veya yeni bir proje planlamanıza yardımcı olabilecek ayrılmış bir GitHub Copilot aracısı oturumu başlatır. Aracı, azure.yamlstandart varlıklar oluşturur; bunlara azd, Bicep veya Terraform dosyaları ile kapsayıcı yapılandırması dahildir ve ardından sonucu doğrular.

Ajan oturumu terminalde çalışır ve Visual Studio Code’daki etkin GitHub Copilot Chat oturumunu sürdürmez. Önkoşullar ve ayrıntılı yönergeler için bkz. Yeni şablonla başlama.

Geçerli dizini tara

Mevcut bir uygulama kod tabanınız varsa ve bunu azd kullanarak Azure'a dağıtım için hazırlamak istiyorsanız, bu iş akışını kullanın.

Projenizin kök dizinine gidin.
azd init komutunu çalıştırın.
```
azd init
```

Geçerli dizini tara'ya tıklayın. azd vasiyet:

Uygulamanızın kullandığı dili veya çerçeveyi belirlemek için dizininizi tarayın.
Azure Container Apps gibi uygun bir barındırma platformu seçin.
Gerekirse bulunan hizmetleri eklemenizi veya kaldırmanızı ister.

? How do you want to initialize your app? Scan current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

Onayla'yı seçin ve iş akışını tamamlamak için uygulamamı başlatmaya devam edin. azd uygulama dizininizde aşağıdakileri oluşturur:
- azure.yaml Uygulama hizmetlerinizi tanımlayan ve bunları barındırma kaynaklarıyla eşleyen bir dosya.
- .azure Ortam adınız gibi yapılandırma ayarlarının barındırılması için bir klasör.
- .gitignore Uygulama diliniz ve barındırma platformunuz için yapılandırılmış bir dosya.
İsteğe bağlı olarak komutunu çalıştırarak azd up Azure Container Apps kaynaklarını oluşturun ve uygulamanızı dağıtın.

Uygulamanız artık şablon azd olarak yapılandırılmıştır. Daha fazla Azure kaynağı ve hizmetiyle geliştirmeye ve genişletmeye devam edebilirsiniz.

Şablon seçme

Bu iş akışı, genellikle hem uygulama kodunu hem de gerekli Azure altyapı tanımlarını içeren önceden oluşturulmuş azd bir şablonla başlamanızı sağlar.

azd init Komutunu çalıştırın:
```
azd init
```
Uyarı

Ayrıca, bir şablonu ada göre doğrudan başlatması için azd init komutunu --template parametresiyle çalıştırabilir ve iş akışı seçimini atlayabilirsiniz.

Şablon seçin'i seçin. azd , yapılandırılan şablon kaynaklarınızdaki kullanılabilir şablonların listesini görüntüler.

? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

Sonuçları filtrelemek ve şablonu aramak için Hello AZD yazın. Kopyalayıp başlatmak için şablonu seçin.
İsteğe bağlı olarak, şablon kaynaklarını sağlamak ve Azure'a dağıtmak için komutunu çalıştırın azd up .

Ayrıca, başlatılan şablonu daha fazla geliştirme için başlangıç noktası olarak da kullanabilirsiniz.

En düşük proje oluşturma

En az kurulumla başlamak ve her şeyi el ile özelleştirmek isteyen ileri düzey kullanıcılar için bu seçenek yalnızca temel yapılandırmayı sağlar.

azd init komutunu --minimal bayrağıyla çalıştırın:
```
azd init --minimal
```
İstendiğinde, şablonunuz azd için bir ad girin ve Enter tuşuna basın.
```
? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.
```
--minimal bayrağı yalnızca aşağıdakileri oluşturur:
- Proje adına sahip temel azure.yaml bir dosya
- .azure Ortam yapılandırması için bir dizin
- .gitignore Azure Geliştirici CLI'sı için uygun girişlere sahip bir dosya
Bu kolaylaştırılmış başlatma aşağıdaki durumlarda idealdir:
- Altyapınızı sıfırdan oluşturmak istiyorsunuz
- azd öğesini mevcut karmaşık bir projeyle entegre etmek gerekiyor
- Proje yapınız üzerinde tam denetimi tercih etme
Proje yapılandırmasını tamamlayın. Bir klasörde el ile altyapı dosyaları infra oluşturabilir, yapay zeka kodlama aracısının altyapıyı oluşturmasını isteyebilir ve hizmetlerinizi ve kaynaklarınızı tanımlamak için özelleştirebilirsiniz azure.yaml .

Proje ve Azure kaynak adlandırma

Yeni veya mevcut bir projeyi başlatırken, proje adı azure.yaml içinde ayarlanır. Proje adı, sağlama işlemi sırasında oluşturulan Azure kaynak adları için bir ön ek işlevi görür. Doğrulama kurallarına uyarak, oluşturulan Azure kaynak adlarının da geçerli olmasını sağlarsınız.

Bicep veya Terraform şablonlarında, proje adı genellikle ortam adı ve diğer öğelerle birlikte kaynak adları oluşturmak için temel olarak kullanılır. Örneğin:

var resourceToken = '${name}-${environmentName}'

Burada name proje adına başvurur ve environmentName ortamınızın azd adıdır.

Proje adı doğrulama kuralları

Bir projeyi başlatmak için kullanırken azd init veya dosyada azure.yaml yeni bir proje adı oluştururken aşağıdaki doğrulama kuralları uygulanır:

Kural	Description
İzin verilen karakterler	Proje adları yalnızca küçük harf, sayı ve kısa çizgi içerebilir.
Başlangıç karakteri	Proje adları bir harfle başlamalıdır.
Sonlandırma karakteri	Proje adları kısa çizgiyle bitmemelidir.
Uzunluk	Proje adları 2 ila 63 karakter uzunluğunda olmalıdır.
Ardışık kısa çizgi yok	Proje adları ardışık kısa çizgi içeremez.

Bu doğrulama kuralları, proje adınızın Azure kaynaklarının adlandırma gereksinimleriyle uyumlu olmasını sağlar ve dağıtım sırasında hizmet paketleme hatalarını önler.

Sonraki Adımlar

projenizi ile azd initbaşlatdıktan sonra şunları yapabilirsiniz:

Azure kaynaklarınızı özelleştirmek için oluşturulan altyapı dosyalarını değiştirin.
Azure'da gerekli kaynakları oluşturmak için kullanın azd provision .
Uygulama kodunuzu sağlanan kaynaklara dağıtmak için kullanın azd deploy .
Sağlama ve dağıtımı tek bir komutta birleştirmek için Azure Geliştirici CLI başlatma iş akışı hakkında bilgi edinin.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-09-16